评论插件

约 1463 字大约 5 分钟...

LearnData 使用的是 Waline 评论插件，部署简单，有后端管理。评论插件推荐次序为 Waline > Valine > giscus > Gitalk > Gitter。

评论插件

Walineopen in new window：基于 Valine 衍生的简洁、安全的评论系统，部署到 Vercel，可匿名互动，导出评论内容，支持文章表情互动。
Valineopen in new window：快速、简洁且高效的无后端评论系统，可匿名互动。
giscusopen in new window：基于 github discussion，近似于论坛。查看配置方法open in new window。
Gitalkopen in new window：基于 github commit，需配置独立库用于存储评论。
Gitteropen in new window：要登录的公共聊天室。样例如：boardgameopen in new window，regaugeopen in new window。

Waline

Waline 支持 Akismet 反垃圾评论和免注册留言，但匿名留言会带来安全隐患。建议开启评论通知来避免出现极端情况。Waline 的评论通知支持多种方式，包括 QQ、微信、邮件等。对于评论的回复，仅支持邮件通知。

Vercel 项目中选择「Overview」>「Settings」>「Environment Variables」，然后按照 Waline 评论通知open in new window配置所需环境变量。如果需要 Webhook 等更多通知方式，则查看 Waline 服务端配置open in new window。配置成功后，选择「Overview」>「Deployments」，进行 Redeploy，重新部署后环境变量和评论通知方会生效。目前 *.vercel.app 域名已经被 DNS 污染，会出现「无法加载评论」，国内使用建议绑定自定义域名，域名对备案暂无硬性要求。

手动部署

请注意，Vercel 和 LeanCloud 有额度限制。如果你的网站日访客超过一千人次，建议使用自行部署的方案。以下是我的部署步骤：

新建数据库，并导入 waline.sqlopen in new window 以完成表和表结构的创建，之后在项目中配置如下环境变量。^[1]
配置必要的环境变量，可添加于 /etc/environment。配置完成后，需要重启项目让环境变量生效。并注意最后一行需保留空行。
```
MYSQL_DB=""
MYSQL_USER=""
MYSQL_PASSWORD=""
```

部署 Waline 服务端，使用 forever 让其持久化运行。

# 切换到站点路径
cd /www/wwwroot/waline

# 安装 waline 前端包
npm install @waline/vercel --save

# 运行模块内的 vanilla.js 文件
node node_modules/@waline/vercel/vanilla.js

# 使用 forever 持久化运行程序
sudo npm install forever -g
forever start app.js  #启动应用
forever stop app.js  #关闭应用
forever restartall  #重启所有应用

# 持久化运行 Waline
forever start /www/wwwroot/waline/node_modules/@waline/vercel/vanilla.js

# 版本升级并重启
forever stop /www/wwwroot/waline/node_modules/@waline/vercel/vanilla.js
cd /www/wwwroot/waline
npm install @waline/vercel
forever start /www/wwwroot/waline/node_modules/@waline/vercel/vanilla.js

打开网页管理后台，通过导入事先备份的 JSON 文件来还原数据。

新手可以使用宝塔面板的 Node.js 版本管理器来部署 Node.js。安装后，受限更新版本列表，然后选择要使用的 Node 版本，将其设置为命令行版本，接着配置服务器的环境变量。虽然宝塔可以管理 Node 项目，但容易出现错误。处理流程为进入「网站」>「Node 项目」>「添加 Node 项目」，将启动选项设置为模块内的 vanilla.js 文件，将项目端口设置为 8360，并设置绑定域名。

导入时间处理

如果 Waline 数据导入还原后，评论发布时间被重置为当前时间，则说明时间格式不兼容。以下以 LeanCloud 转 MySQL 为例：

2023-03-24T17:27:28.121Z 这个时间戳中的格式 "T" 和 "Z" 不被 MySQL 支持，要将 "T" 替换为空格并将 "Z" 删除。我写了个网页工具open in new window处理时间格式替换。
提取数据中的 Comment、Counter 和 Users，格式为 [{},{}……,{}]，依次复制到 json2sqlopen in new window 进行操作。
在 json2sql 页面中，点击按钮「Format JSON」，然后按截图勾选「Still not happy」「Enclose field names」「Backtick (name)」，取消勾选第一个值的 key。同时，取消勾选 objectId 的「Include」，该项将不会导入数据库。
将「Schema.Table or View Name」依次设为「`wl_Comment`」「`wl_Counter`」「`wl_Users`」，取消勾选「Create Table/View」。
在 Step 3: Generate output 下点击按钮「JSON TO SQL Insert」，然后点击复制按钮。
进入 phpMyAdmin 数据库后台，选中要操作的表（如 wl_Comment），点击右侧的 SQL 按钮运行 SQL 查询，将复制的内容粘贴到此，并点击执行。若无报错，则说明数据导入正常。

处理后时间可以正常导入，但由于 id 结构不同，旧的评论回复将失去联系。

Gitalk

Gitalk 是轻量化的评论组件，用户必须登录 github 才能评论，适合项目类使用。

https://github.com/settings/developers 页面管理已建的应用，获取 Client ID 和 Client secrets，修改应用链接。^[2]

将以下代码复制粘贴至 docsify 页面，即可启动 Gitalk：

<link rel="stylesheet" href="https://lf9-cdn-tos.bytecdntp.com/cdn/expire-1-y/gitalk/1.7.2/gitalk.min.css">

<script src="https://lf3-cdn-tos.bytecdntp.com/cdn/expire-1-y/docsify/4.12.2/plugins/gitalk.min.js"></script>
<script src="https://lf6-cdn-tos.bytecdntp.com/cdn/expire-1-y/gitalk/1.7.2/gitalk.min.js"></script>
<script>
    /* 使用下面的 Javascript 代码生成 gitalk 插件 */
    const gitalk = new Gitalk({
        clientID: '2f3da234d27ed9a7c290',
        clientSecret: 'd64c45594858477fff0c234c3ed3947a53b0a9ac',
        repo: 'docsifytalk',        //仓库名称 (GitHub repo)
        owner: 'rockbenben',        //仓库拥有者 (GitHub repo owner)
        admin: ['rockbenben'],      //仓库所有者和协作者。（对此存储库具有写访问权的用户）
        // id: location.pathname,   // Ensure uniqueness and length less than 50
        distractionFreeMode: false  // Facebook-like distraction free mode
    })
</script>

Gitalk 缺点：