为 Hexo Fluid 接入 Giscus 评论系统

前言

Hexo Fluid 是一个基于 Hexo 的博客主题，支持各种评论评论系统，其中 Giscus 评论系统基于 GitHub，不需要自己额外搭建服务端，配置起来就很方便的。下面就讲讲如何给 Hexo Fluid 接入 Giscus 评论系统吧。

安装

Giscus 评论系统需要在 GitHub 上安装，点击此处安装一下吧：GitHub Apps - giscus

创建评论仓库

评论要存哪里呢，当然是 Github 仓库的 Discussions 呢。创建一个仓库，名字为<Github 用户名>.github.io，例如licyk.github.io。然后在这个仓库的 Settings 中确认 Discussions 功能已经开启。

获取配置

进入 Giscus 官网，在仓库中填写刚刚创建的仓库名，格式为<用户名>/<仓库名>，例如licyk/licyk.github.io。页面 ↔️ discussion 映射关系选择Discussion 的标题包含页面的 pathname，再勾选使用严格的标题匹配。Discussion 分类选择Announcements。

特性中勾选启用主帖子上的反应（reaction），将评论框放在评论上方。

填写好后就可以在启用 giscus看到 Giscus 的配置了喵，例如：

<script src="https://giscus.app/client.js"
        data-repo="licyk/licyk.github.io"
        data-repo-id="repo-id-xxxxx"
        data-category="Announcements"
        data-category-id="DIC_xxxxx"
        data-mapping="pathname"
        data-strict="1"
        data-reactions-enabled="1"
        data-emit-metadata="1"
        data-input-position="top"
        data-theme="preferred_color_scheme"
        data-lang="zh-CN"
        crossorigin="anonymous"
        async>
</script>

配置 Hexo Fluid

拿到 Giscus 的配置后，在_config.fluid.yml中修改以下内容，把刚刚拿到的配置填进去：

# Giscus
# 基于 GitHub Discussions，类似于 Utterances
# Based on GitHub Discussions, similar to Utterances
# See: https://giscus.app/
giscus:
  repo: licyk/licyk.github.io
  repo-id: repo-id-xxxxx
  category: Announcements
  category-id: DIC_xxxxx
  theme-light: light
  theme-dark: dark
  mapping: pathname
  reactions-enabled: 1
  emit-metadata: 0
  input-position: top
  lang: zh-CN
  data-strict: 1


  # 评论插件
  # Comment plugin
  comments:
    enable: true
    # 指定的插件，需要同时设置对应插件的必要参数
    # The specified plugin needs to set the necessary parameters at the same time
    # Options: utterances | disqus | gitalk | valine | waline | changyan | livere | remark42 | twikoo | cusdis | giscus | discuss
    type: giscus

保存配置后，再把博客源码提交到 GitHub 仓库中，然后就可以在博客中看到 Giscus 评论系统了喵。