使用 Jekyll 生成静态页面做博客访问很快，可是网站托管在 GitHub，并不支持直接写入，所以就不得不外挂第三方评论系统。之前我也折腾 对比过 Disqus 和多说，但最终还是没有切换到多说，选择继续留在 Disqus 观望，希望 Disqus 以后能一直保持不被墙。

怎么部署 Disqus 这里就不多说了，鄙人博客上除了显示评论框，还在首页显示评论计数，这是如何做到的，下面就来看看。

通过 count.js

在官方的帮助文档中，显示评论计数并不复杂[1]，仅需在页面添加一段 JS 代码，并按照一定的规则写好 HTML 便可。

JavaScript 代码，找个合适的地方放好：

/* * * 自定义变量 * * */
var disqus_shortname = 'example'; // 替换为你 Disqus 的 shortname

/* * * 不要动 * * */
(function () {
var s = document.createElement('script'); s.async = true;
s.type = 'text/javascript';
s.src = '//' + disqus_shortname + '.disqus.com/count.js';
(document.getElementsByTagName('HEAD')[0] || document.getElementsByTagName('BODY')[0]).appendChild(s);
}());

超链接标签

最粗暴的方法直接给链接指定 href 属性，属性值为 页面链接 + '#disqus_thread'，这样既能使此元素的内容替换为评论数，点开此链接也会跳转到相关页面的 Disqus 评论框，一举两得。

在 Jekyll 上可以这么写：

{% for post in site.posts %}
  ...
  <a href="{{ site.url }}{{ post.url }}#disqus_thread"></a>
  ...
{% endfor %}

如果不希望点开链接即跳到评论框，那么也可以使用 disqus_url 等变量，即可加上 data-disqus-url 等属性，可以这么写：

{% for post in site.posts %}
  ...
  <a href="{{ site.url }}{{ post.url }}" data-disqus-url="{{ site.url }}{{ post.url }}"></a>
  ...
{% endfor %}

其他标签

当然，你可能不希望在链接上显示评论数，在其他标签上显示评论数只需要加上一个 class='disqus-comment-count' 属性，且加上相关变量即可。例如：

{% for post in site.posts %}
  ...
  <span class='disqus-comment-count' data-disqus-url="{{ site.url }}{{ post.url }}"></span>
  ...
{% endfor %}

对了，在 Disqus 后台中可以设置评论计数链接的文字[2]，鄙人设置如下图：

设置评论计数链接的文字 设置评论计数链接的文字

经过上面的方式处理之后，打开页面的时候刷刷的，一看原来加载了三个文件。虽然加载时间用不了多少，但为了显示评论数要多增加三次响应，是不是有点得不偿失？不管是不是，强迫症告诉我应该找找有没有更好的方式。

加载的文件1 加载的文件1

通过 Disqus API

就为了显示下评论计数而已，使用 Disqus 的 API 实现应该不麻烦，首先得去 Disqus 注册一个新的应用，获取公钥。

折腾了一下，可以这样实现：

{% for post in site.posts %}
  ...
  <a class='disqus-comment-count' href="{{ site.url }}{{ post.url }}#disqus_thread" data-disqus-url="{{ site.url }}{{ post.url }}"></a>
  ...
{% endfor %}

使用 JavaScript 取数据，并写入：

var disqusShortName = "example"; // 替换为你 Disqus 的 shortname
var disqusPublicKey = "Public Key"; // 申请的公钥
var urlArray = [];
var commentsCount = document.querySelectorAll('.disqus-comment-count');
if (commentsCount.length) {
  for (i=0; i < commentsCount.length; i++) {
    var url = commentsCount[i].getAttribute('data-disqus-url');
    urlArray.push('thread=link:' + url);
  }
  function jsonpCallback(result) {  
    for (var i in result.response) {
      var count = result.response[i].posts;
      if ( count ) {
        document.querySelector('[data-disqus-url="' + result.response[i].link + '"]').innerHTML = count;
      }
    }  
  }
  (function () {
    var s = document.createElement('script');
    s.type = 'text/javascript';
    s.src = 'https://disqus.com/api/3.0/threads/set.jsonp' + '?callback=jsonpCallback' + '&api_key=' + disqusPublicKey + '&forum=' + disqusShortName + '&' + urlArray.join('&') ;
    (document.getElementsByTagName('HEAD')[0] || document.getElementsByTagName('BODY')[0]).appendChild(s);
  }());
}

看看是不是快多了？好像也没快多少，不过只需加载一个文件便可。

加载的文件2 加载的文件2

使用 jQuery 实现更方便[3]：

var disqusShortName = "example"; // 替换为你 Disqus 的 shortname
var disqusPublicKey = "Public Key"; // 申请的公钥
var urlArray = [];
$('.disqus-comment-count').each(function () {
  var url = $(this).attr('data-disqus-url');
  urlArray.push('link:' + url);
});
$.ajax({
  type: 'GET',
  url: "https://disqus.com/api/3.0/threads/set.jsonp",
  data: { api_key: disqusPublicKey, forum : disqusShortName, thread : urlArray }, 
  cache: false,
  dataType: "jsonp",
  success: function (result) {
    for (var i in result.response) {
      var count = result.response[i].posts;
      if ( count ) {
        $('.disqus-comment-count[data-disqus-url="' + result.response[i].link + '"]').html(count);
      }
    }
  }
});

代码中实现没评论不显示，对了，本博评论计数样式模仿 V2EX、Ruby China 等站，至于 Disqus 具体参考 Disqus API 的相关文档[4]。

Disqus API 看起来相当有趣，不过鉴于 Disqus 不在天朝，所以暂时也不折腾更多。

参考资料

  1. ∧ Adding comment count links to your home page | DISQUS
  2. ∧ Settings > General
  3. ∧ Disqus Comment Counts Example
  4. ∧ API - Disqus

本文历史

  • 2015 年 09 月 14 日 完成初稿