本篇主要讲的是 hexo 主题 volantis 的评论系统相关的 giscus

一、评论系统的选择 giscus

1.1 打开文件_config.volantis.yml，搜索 comments 评论部分，可以看到这里选择的是 giscus

1
2
3
4
5

comments:
  title: <i class='fa-solid fa-comments'></i> 评论
  subtitle:
  service: giscus
  # 可选评论系统 #

1.2 继续搜索 giscus，显示需要配置一些 repo/repo-id 等参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# giscus
# https://giscus.app
# https://github.com/laymonage/giscus
giscus:
  # 以下配置按照 yml 格式增删填写即可
  repo: txw1314/comment-giscus
  repo-id: R_kgDOHvE8vw
  category: Comments
  category-id: DIC_kwDOHvE8v84CQgFl
  mapping: "title"
  reactions-enabled: "1"
  emit-metadata: "0"
  position: "top"
  loading: "lazy"
  crossorigin: "anonymous"
  lang: "zh-CN"
  # 以上配置按照 yml 格式增删填写即可

二、如何获取 giscus 的相关配置

2.1 在 github 的操作

2.1.1 新建一个关于评论的仓库

我这里命名的是 comment-giscus,点击 Setting

2.1.2 继续往下滚动到 Features，勾选 Wikis

2.1.3 继续滚动，勾选 Discussions。

2.2 在 GitHub 代码库上的讨论页面创建一个类别

比如 “Comments（评论）”——或者选择现有的类别。

2.2.1 如果没有，那就新建类别

2.2.2 填写 title 和详情，点击 create 创建完成

2.2.3 创建完成，分类里面有了我们新增的分类

2.3 转到 https://github.com/apps/giscus，按照提示操作，并仅授予对选定代码库的访问权限。

2.3.1 安装 giscus

在根目录安装 giscus : npm install giscus

2.3.2 选择建立的评论仓库

2.3.3 确认账号密码

2.3.4 选择完成

2.4 在 giscus 的操作，我们需要配置 giscus 的小部件。

打开网页：giscus

2.4.1 选择语言和仓库，

输入之前 github 创建仓库名称，如用username/reponame，这里包括用户名和仓库名称，

注意/前后不能有空格，不能输错，否则下面会提示报错

2.4.2 页面映射关系，这里我选择的是第三个

2.4.3 然后选择 Discussion 分类和特性

分类选择我们上面新建的分类，特性我选择了箭头不两个，也可不选，主题随便选一个就行，不选也没关系这个不影响

2.4.4 启用 giscus

一切就绪之后，Giscus 将根据你的设置生成一个脚本标签，这就是我们想要的 giscus 的配置信息了。你可以将其粘贴到你的代码中，记得把这个保存下来，不然还要在操作一下这步骤重新生成了

这是最终结果