Giscus 简介

giscus 是由 GitHub Discussions 驱动的评论系统,全部评论数据储存在 GitHub Discussions 中,一篇博客关联一个 discussion。除了支持评论还支持关联 Discussion 帖子上的表情回复 (reaction) 。

配置 giscus

按照 giscus 官方文档 配置章节的说明,安装 giscus app 并在为所使用的 GitHub 仓库开启 Discussions 功能。

完成映射关系和特性配置后,获得启用 giscus 的代码。

<script src="https://giscus.app/client.js"
        data-repo="Ljhero/ljhero.github.com"
        data-repo-id="MDEwOlJlcG9zaXRvcnkzNDQxNjk4"
        data-category="Comments"
        data-category-id="DIC_kwDOADSEIs4CO5XI"
        data-mapping="pathname"
        data-reactions-enabled="1"
        data-emit-metadata="0"
        data-input-position="top"
        data-theme="light"
        data-lang="zh-CN"
        data-loading="lazy"
        crossorigin="anonymous"
        async>
</script>

配置 Hugo

博客仓库根目录下创建 layouts/partials/comments.html 文件,文件中添加上一步获取到的 giscus 启用代码。

最后修改 config.yml 启用 comments

params:
    comments: true

参考资料