💬 让你的网站评论区，摇身一变成 GitHub Discussions！

你是否厌倦了传统网站评论系统的单调乏味？ 想要一个更灵活、更强大、更具社区感的评论系统？别再犹豫，快来体验 giscus 吧！它利用了 GitHub Discussions 的强大功能，将你的网站评论区瞬间升级为一个充满活力的社区中心。

giscus 的核心思想简单明了： 将你的网站评论与 GitHub Discussions 关联起来，让访客在 GitHub 上直接参与讨论。这不仅能充分利用 GitHub 的强大功能，还能让你的网站评论区更具吸引力。

想象一下： 你的网站评论区不再是简单的留言板，而是变成了一个充满活力的 GitHub Discussions 页面。访客可以轻松地点赞、评论、关注讨论，甚至还可以使用 GitHub 的强大功能，例如代码块、图片、链接等，让讨论更加丰富多彩。

giscus 的魅力不止于此：

🚀 无缝集成： giscus 的安装和配置极其简单，只需添加几行代码，就能将它集成到你的网站中。

🌐 多语言支持： giscus 支持多种语言，让你可以轻松地为全球用户提供本地化的评论体验。

🎨 自定义主题： giscus 提供多种主题，让你可以根据网站风格轻松定制评论区的视觉效果。

🛡️ 安全可靠： giscus 采用 GitHub 的安全机制，确保你的评论区安全可靠。

💡 灵活配置： giscus 提供多种配置选项，让你可以根据自己的需求定制评论区的功能和外观。

那么，giscus 究竟是如何运作的呢？

它就像一个神奇的桥梁，连接着你的网站和 GitHub Discussions。 当访客访问你的网站时，giscus 会使用 GitHub Discussions 搜索 API 查找与当前页面关联的讨论。如果找不到匹配的讨论，giscus 会自动创建一个新的讨论。

访客可以以两种方式参与讨论：

• 直接在 GitHub Discussions 中评论： 访客可以直接在 GitHub Discussions 页面上评论，就像在任何其他 GitHub 仓库中一样。
• 通过 GitHub OAuth 授权： 访客可以通过 GitHub OAuth 授权 giscus app 代表他们发布评论。

无论访客选择哪种方式，你都可以在 GitHub 上管理评论，就像管理任何其他 GitHub 仓库一样。

giscus 的配置过程也非常简单：

首先，你需要选择一个公开的 GitHub 仓库，将你的网站评论与它关联起来。 然后，你需要选择页面与讨论之间的映射关系。giscus 提供多种映射方式，例如：

• 根据页面路径： giscus 会查找标题中包含页面路径的讨论。
• 根据页面 URL： giscus 会查找标题中包含页面 URL 的讨论。
• 根据页面标题： giscus 会查找标题中包含页面标题的讨论。
• 根据页面元数据： giscus 会查找标题中包含页面元数据的讨论。
• 根据特定字符串： giscus 会查找标题中包含特定字符串的讨论。
• 根据特定讨论号： giscus 会直接加载特定编号的讨论。

最后，你需要选择一些额外的配置选项，例如：

• 启用主帖子上的反应： 访客可以在主帖子上添加反应，例如点赞、赞赏、疑问等。
• 输出讨论的元数据： giscus 可以将讨论的元数据发送到父页面，方便你进行分析和处理。
• 将评论框放在评论上方： 访客可以更容易地发表评论，而无需滚动到讨论底部。
• 懒加载评论： 评论的加载会延迟到用户滚动到评论容器附近，提高页面加载速度。

giscus 的强大功能远不止这些，它还提供了丰富的主题选项，让你可以根据网站风格轻松定制评论区的视觉效果。

如果你正在寻找一个强大、灵活、易于使用的网站评论系统，那么 giscus 绝对是你的不二之选！

立即体验 giscus，让你的网站评论区焕然一新！

参考：

1. giscus
2. GitHub Discussions
3. utterances
4. gitalk
5. CONTRIBUTING.md