为Next主题添加多说评论系统

前言

几个月前，在好奇心的鼓动下，利用Github Pages和Hexo以及Next主题搭建一个属于自己的个人主站，由于时间伧俗，搭建成功后就没有好好完善一下，可以参照文章徒手教你建自己的博客,文章里有搭建免费博客的详细步骤。

这周末没有加班，静下心写了篇文章，发布成功后，却又遇到Github Pages更新的原因导致博客的页面出现空白，又顺手写了一篇解决页面空白问题的博客，文章为关于hexo主题next博客加载空白页的处理,文章记录了出现问题原因和解决的多种方式。

解决完问题，本以为没有什么优化的了，此刻，看到别人的博客都可以评论和分享，后来考虑了一下，评论的功能对于反馈博客中问题很有帮助，于是乎，决定搞一下。

在添加评论的过程中，主要遇到下面的三个问题：

• 1、如何选取合适评论系统；
• 2、添加评论系统后，如何根据文章对评论进行区分；
• 3、如何解决评论后的邮件提醒。

后续的内容将围绕上述三个问题进行展开。

选取合适评论系统

有disqus和多说两种评论系统。

• disqus加载速度较慢，并且用户必须先注册disqus用户才能评论，流程很繁琐，最重要的是需要访问外国网站，这可是致命一击啊。
• 而多说可以很好避开上述的缺点，加载速度快、利用社交账号登录就能评论、还带有邮件提醒功能，对比一下，简直天壤之别，果断选择多说。

安装多说

进入多说网站,点击我要安装,具体设置如下图：

多说设置图

点击创建，选择通用，就会显示一段嵌入评论的通用js代码，如下图：

通用代码图

替换主题中指定的文件

• 首先，说一下我使用的是Next主题，需要修改代码文件是_config.yml中duoshuo_shroname,如下：

duoshuo_shortname: 填写上述步骤注册的shroname

• 还需要修改目录themes/next/layout/_partials/comments.swig下的comments.swig。
• 若你是landscape主题，需要修改themes\landscape\layout\_partial\article.ejs目录下的article.ejs文件
• 找到原文件中的被替换代码：

    <div class="ds-thread" data-thread-key="{{ page.path }}"
          data-title="{{ page.title }}" data-url="{{ page.permalink }}">
      </div>

• 替换的代码如下：

 <section id="comments">
<!-- 多说评论框 start -->
<div id="ds-thread" class="ds-thread" data-thread-key="{{ page.path }}" data-title="{{ page.title }}" data-url="{{ page.permalink }}" }}"></div>
<!-- 多说评论框 end -->
<!-- 多说公共JS代码 start (一个网页只需插入一次) -->
<script type="text/javascript">
var duoshuoQuery = {short_name:"shortTime"};
(function() {
var ds = document.createElement('script');
ds.type = 'text/javascript';ds.async = true;
ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js';
ds.charset = 'UTF-8';
(document.getElementsByTagName('head')[0] 
 || document.getElementsByTagName('body')[0]).appendChild(ds);
 })();
 </script>
<!-- 多说公共JS代码 end -->
</section>

• 需要注意的是：data-thread-key、data-title、data-url这三个变量一定要严格按照上述代码格式书写，否则会导致某一篇文章评论会显示在所有的文章里，造成数据的不准确。
• 这三个变量的具体含义在上述中已阐明（data-thread-key=请将此处替换成你站点的ID data-title=请替换成文章的标题 data-url=请替换成文章的网址）.
• 上述的步骤都顺利完成后，多说评论系统基本功能就部署好了，可以发布博客体验一下。

添加评论邮件提醒

• 多说自带的邮件提醒功能是不支持主动评论提醒的，比如说在某一篇博客中，有人主动评论留言的话，多说此时是不会邮件提醒的。
• 多说所谓的邮件提醒是以别人回复别人的评论为前提的，即你不是回复他人的评论博主就收不到你评论回复的提醒。
• 从这一点上看，多说这一功能有失人性化的设计，故自己动手解决这个邮件提醒不完整的问题。
• 从分析多说提供的API入手，同步用户到多说和评论框调用代码参数说明,得知可以使用data-author-key变量设置主动邮件提醒。
• 我们需要做的是，自定义同步一个用户到多说服务器，并将该用户设置成作者身份，进而取得该用户在站点的ID,将该ID赋值给data-author-key加在多说的评论框里即可。
• 开始动手....
• 在桌面或其他目录下，新建一个文件夹，命名为js或者其他，进入该文件夹，利用终端执行下面的命令：

npm install --save-dev request

• 需要等上几分钟，此时你可以进行下一步了。
• 利用sublime或其他工具新建一个myuser.js文件，将下面的代码复制进文件夹，并修改相应的data数据

var http = require('request');

var data = {
  'short_name'         : '',     // 你的short_name，后台管理那里可以看到
  'secret'             : '',     // 密钥，后台管理那里可以看到
  'users[0][user_key]' : '1',    // 用户在站点的ID，就是后面需要设置的 data-author-key值，可以随意设置，这里默认为1吧
  'users[0][name]'     : '',     // 显示的名字
  'users[0][email]'    : '',     // 提醒的邮箱
  'users[0][role]'     : 'author'// 用户的类型，设置为作者
};

http.post({url:'http://api.duoshuo.com/users/import.json', form: data}, function (error, response, body) {
  if (!error && response.statusCode == 200) {
    console.log('Post data to Duoshuo success');
  }
  else{
    console.log('Post data to Duoshuo fail');
  }
});

• 将上面代码中的数据按照自己的多说账户设置好之后，执行以下命令完成数据同步到多说服务器：

node myuser.js

• 若输出为Post data to Duoshuo fail那就重新检查以下data数据是否修改正确；
• 若输出为Post data to Duoshuo success，那么就登录到多说的后台，在用户那里看到新添加的用户，如下所示；

后台管理

• 若后台显示的角色不是作者，可以手动改成作者。
• 去目录themes/next/layout/_partials/comments.swig，修改文件comments.swig中的那段代码（见上面描述）为： <section id="comments"> <!-- 多说评论框 start --> <div id="ds-thread" class="ds-thread" data-thread-key="{{ page.path }}" data-title="{{ page.title }}" data-url="{{ page.permalink }}" data-author-key="{{ theme.duoshuo_info.data_author_key }}"></div> <!-- 多说评论框 end --> <!-- 多说公共JS代码 start (一个网页只需插入一次) --> <script type="text/javascript"> var duoshuoQuery = {short_name:"shortTime"}; (function() { var ds = document.createElement('script'); ds.type = 'text/javascript';ds.async = true; ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js'; ds.charset = 'UTF-8'; (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(ds); })(); </script> </section>
• 上述代码与之前的比较，可以看出其实就是增加了一个变量：

data-author-key="{{ theme.duoshuo_info.data_author_key }}"

• 这里设置好之后，修改主题下的_config.yml文件，增加一行配置，如下：

duoshuo_info:
  data_author_key: 1 #此处填写上面js脚本中的data变量中的users[0][user_key]的值，因为上面为1，这里我就填写为1了

• 到这里基本的工作就完成了，重新发布博客，就可以使用主动评论邮件提醒了。
• 参照我的博客
• PS一句，这种邮件提醒不是实时提醒，而是每天一封汇总邮件。如果你中途查看了这个评论的话，也是不会邮件提醒的。

以上内容是笔者在创建个人博客过程中一些做法，大家如有其它意见欢迎评论。