Hexo 评论系统

上一篇文章博客搭建教程搭建了一个博客的基本框架，但是没有解决博客评论问题，本文填充一下这部分欠缺。

Hexo 博客系统是静态博客，本身无法支持评论等动态的功能，但是可以通过第三方的评论系统让 Hexo 博客支持评论功能。常见的评论系统包括：Valine、Disqus、Gitment、Giscus 等，本文主要介绍 Giscus 的使用。

giscus 简介

giscus是由 GitHub Discussions 驱动的评论系统。让访客借助 GitHub 在你的网站上留下评论和反应，该项目受 utterances 启发。包括以下特性：

开源；
无跟踪，无广告，永久免费；
无需数据库，全部数据均储存在 GitHub Discussions 中；
支持自定义主题；
支持多种语言；
高度可配置；
自动从 GitHub 拉取新评论与编辑；
可自建服务；

运作原理

giscus 加载时，会使用 GitHub Discussions 搜索 API 根据选定的映射方式（如 URL、pathname、<title> 等）来查找与当前页面关联的 discussion。如果找不到匹配的 discussion，giscus bot 就会在第一次有人留下评论或回应时自动创建一个 discussion。

要评论，访客必须按 GitHub OAuth 流程授权 giscus app 代表他发帖。或者访客也可以直接在 GitHub Discussion 里评论。你可以在 GitHub 上管理评论。

在 Hexo 中配置 giscus

Step 1：新建 Github 仓库，确保：

此仓库是公开的，否则访客将无法查看 discussion。
giscus app 已安装否则访客将无法评论和回应。
Discussions功能已在你的仓库中启用。

Step 2：Hexo 配置

在你的 Hexo 博客目录中执行以下命令，安装 hexo-next-giscus 插件。

npm install hexo-next-giscus --save

然后在 Hexo 的 _config.yml 配置文件添加如下内容：

giscus:
  enable: true
  repo: # Github repository name
  repo_id: # Github repository id
  category: # Github discussion category
  category_id: # Github discussion category id
  # Available values: pathname | url | title | og:title
  mapping: pathname
  # Available values: 0 | 1 
  reactions_enabled: 1
   # Available values: 0 | 1 
  emit_metadata: 1
  # Available values: light | dark | dark_high_contrast | transparent_dark | preferred-color-scheme
  theme: light
  # Available values: en | zh-C
  lang: en
  # Available value: anonymous
  crossorigin: anonymous

或者在主题的配置文件 _config.themename.yml 中对应项添加即可，例如 butterfly 主题：

giscus:
 repo:    # uername/repo_name
 repo_id: 
 category_id: 
 theme:
  light: light
  dark: dark
 option:

repo_id是托管博客的代码仓库的一个标识值，category是该仓库Issues里面对应的分类（或者说是主题）。一个仓库默认具有下面几个分类：Announcements、General、Ideas、Q&A、Show and tell。这里我选择General作为评论的分类。最后的category_id类似repo_id也是对该分类的一个标识值。

如何快速的获取这些数据呢，可以通过GitHub官方的GraphQL API Explorer查询到。这里把查询所用的语句进行记录。

query {
  repository (name: "repo_name", owner: "owner_name")  {
    id
    discussionCategories (first: 5) {
      nodes {
        name
        id
      }
    }
  }
}

然后将查询数据填入对应项即可。

推荐使用公告（announcements）类型的分类，以确保新 discussion 只能由仓库维护者和 giscus 创建。