跳到主要内容

评论服务

这里推荐两种评论服务

Giscus:基于GitHub Discussions,对程序员相对友好,评论信息提示通过github邮箱发送。

Waline:需要搭建后端服务与数据库服务,提供评论与浏览量服务,可拓展性强。

giscus

之前的评论使用的是 gitalk,但是那个是基于 github issue 的,并且 issue 不能关闭,每次打开仓库的时候都会看到几十个 issue,特别不友好。

所以后面就考虑换成 giscus,由 GitHub Discussions 驱动的评论系统。首先要确保以下几点:

  1. 此仓库是公开的,否则访客将无法查看 discussion(并不需要一定是博客的项目,随便一个仓库都可以)。
  2. giscus app 已安装否则访客将无法评论和回应。
  3. Discussions 功能已在你的仓库中启用

本博客已经内置好评论组件 src/component/Comment,所以只需要在 docusaurus.config.ts 中设置 giscus 的配置即可。

配置 giscus

打开 giscus 官网,填写完对应的信息后,可以得到一个已经配置好的<script>标签

<script
src="https://giscus.app/client.js"
data-repo="kuizuo/blog"
data-repo-id="MDEwOlJlcG9zaXRvcnkzOTc2Mxxxxx"
data-category="General"
data-category-id="DIC_kwDOF7NJDM4CPK95"
data-mapping="title"
data-strict="0"
data-reactions-enabled="1"
data-emit-metadata="0"
data-input-position="top"
data-theme="light"
data-lang="zh-CN"
crossorigin="anonymous"
async
></script>

由于我在 src/component/Comment 组件中做了配置合并,并且支持主题变化、国际化。因此,你只需要复制 data-repo, data-repo-id, data-categorydata-category-id 填写到 docusaurus.config.ts 中即可,以下是我的配置文件。

docusaurus.config.tsjavascript
giscus: {
repo: 'kuizuo/blog',
repoId: 'MDEwOlJlcG9zaXRvcnkzOTc2Mxxxxx',
category: 'General',
categoryId: 'DIC_kwDOF7NJDM4CPK95',
theme: 'light',
darkTheme: 'dark',
}
切记一定要将上述数据替换成你的,如果不替换的话,评论的信息都将会在我的 Discussions 下。

waline

目前比较流行的博客评论系统还有 waline,它可以提供评论与浏览量服务,由于需要搭配后端服务与数据库服务,所以在配置方面会比 giscus 来的麻烦,但它无需 github Discussions,所以也是绝大多数博客作者的标配。

关于如何配置,参见官方 快速上手 | Waline