关于github个人博客使用giscus作为评论系统的操作说明

说明

本人使用github搭建个人博客，博客框架为Hexo(5.4.2)，博客主题为Volantis(5.8.0)。为了便于使用，接入了Giscus作为评论系统。本篇文章主要说明接入Giscus的具体操作。

步骤一

• 建一个公共库
  由于Giscus使用github的discussion作为评论数据存放地，所以使用Giscus需要先建一个github的公共仓库，仓库名称可根据自己的需要进行设置。本文中评论的仓库名为comments。
  

除了要求是个公共库之外，是否需要README、gitignore无具体要求

• 开启公共库的discussion功能

公共库 -> Settings -> General -> Features -> 勾选discussion

步骤二

• 公共库安装Giscus
  前往这里，点击 Install 安装Giscus
  

选择创建的公共库，将公共库与Giscus关联起来

步骤三

• Giscus官网配置
  前往 Giscus官网，进行配置。
  
  仓库名有三个前置条件，如果按照本文顺序进行安装，这里的检查会通过，否则会报错。如果报错了，请检查一下之前的配置是不是有哪里配置错了。

可以根据自己的需要选择，本文默认选了第一个。

选择 Announcements 类型即可，官方也是这样推荐的，因为这样便于管理。

其他的配置使用默认配置就好。

在你想出现评论的位置添加上面的 </script/> 标签。但如果已经存在带有giscus类的元素，则评论会被放在那里。
将上面标签中的数据填入项目中giscus配置的对应位置。

1
2
3
4
5
6
7
8
9
10

giscus:
  # 以下配置按照 yml 格式增删填写即可
  repo: #data-repo
  repo-id: #data-repo-id
  category: #data-category
  category-id: #data-category-id
  mapping: "pathname"
  reactions-enabled: "1"
  emit-metadata: "0"
  lang: "zh-CN"

以上配置完成后，理论上项目中就可以使用评论系统了。

登录后，输入评论，可以查看公共库的discussion中是否有对应的评论


可以看到，博客中的评论在github的公共仓库中也存在，配置Giscus的评论系统成功！