虽然也在意料之中,但是收到多说邮件还是觉得有些遗憾。对于静态博客来说,没有评论模块就有些尴尬了。
那么如何用其他工具代替多说呢?大家第一时间想到的基本都是Disqus这种网站,但是被墙后,访问起来很困难,加载速度不好。
国内替代品
在开始搭建自己的评论系统之前,先了解一下国内其他第三方评论系统,比较著名的就是这些:
但是它们全部不支持HTTPS,所以我决定自己搞个第三方评论系统。
Isso
Isso是一个轻量级的类似Disqus第三方评论系统,它允许匿名评论、注册评论、回复邮件通知以及自定义外观等功能。它的接口设计和Disqus高度相似,所以要集成这个评论系统只需要在Disqus接口上改几个单词,非常简单。
Isso是基于Python写的开源软件,你可以随意修改评论框外观。
1. 安装
安装?不,安装什么的才不会让你们做呢,我本来打算把整个Isso打包起来丢进容器的,但是在Docker Hub 上看到已经有人做了一个镜像,而且做得相当不错,我没什么好挑剔的,镜像大小 17 MB。
我挺满意的,所以直接拿来用了。
首先Isso是使用Sqlite驱动的,所以我们使用 Docker 直接运行即可。
安装 Docker 和 Compose,不用废话。
新建一个文件夹名为config,在里面新建一个配置文件isso.conf:
[general]
dbpath = /db/comments.db
host = https://zuolan.me
[server]
listen = http://0.0.0.0:8080/
下面是一个Compose配置文件:
version: '2'
services:
isso:
image: wonderfall/isso
environment:
- GID=1000
- UID=1000
volumes:
- ./config:/config
- ./db:/db
ports:
- "8080:8080"
保存为docker-compose.yml然后执行:
dokcer-compose up -d
搞定之后就可以通过8080端口的接口使用Isso评论系统了。
启动后目录应该是这样的:
.
├── config
│ └── isso.conf
├── db
│ └── comments.db
└── docker-compose.yml
2 directories, 3 files
2. 配置Nginx
直接访问8080好尴尬,给它绑个网址吧。
server {
listen [::]:80;
listen [::]:443 ssl;
server_name example.com;
root /var/www/example.com;
location /isso {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Script-Name /isso;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://localhost:8080;
}
}
配置不用我说了吧,上面配置中,我们可以通过example.com/isso使用接口了。
3. 设置
Isso服务已经运行了,当然直接访问8080端口是没有什么界面的,只有一个API接口。接下来我们要在静态博客中集成这个评论系统。
如果你使用的主题是纯HTML,那么嵌入下面两句即可:
<script data-isso="//comments.example.tld/"
src="//comments.example.tld/js/embed.min.js"></script>
<section id="isso-thread"></section>
如果你是Jade或者Ejs等模板引擎,那么复制一下Disqus的代码,替换为Isso即可,例如Jade格式。
下面是Disqus的Jade模板:
if theme.disqus
a#comments
#disqus_thread
script.
var disqus_shortname = '#{theme.disqus}';
var disqus_identifier = '#{page.path}';
var disqus_title = '#{page.title}';
var disqus_url = '#{config.url}/#{page.path}';
(function() {
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
script(id='dsq-count-scr' src='//#{theme.disqus}.disqus.com/count.js' async)
现在改写为Isso评论系统(类似):
if theme.isso
a#comments
.isso-thread
script.
var isso-path = {short_name:"#{theme.isso}"};
(function() {
var isso = document.createElement('script');
isso.type = 'text/javascript';ds.async = true;
isso.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//example.com/isso/js/embed.js';
ds.charset = 'UTF-8';
(document.getElementsByTagName('head')[0]
|| document.getElementsByTagName('body')[0]).appendChild(ds);
})();
4. 评论计数
如何在首页中显示文章计数?
加入下面一句到页面中:
<a href="/my-uri.html#isso-thread">Comments</a>
最后
如果你不满意这个Isso,还可以使用其他开源评论系统。
我只负责丢链接: