README.zh-CN.md

giscus

利用 GitHub Discussions 实现的评论系统，让访客借助 GitHub 在你的网站上留下评论和反应吧！本项目深受 utterances 的启发。

• 开源。🌏
• 无跟踪，无广告，永久免费。📡 🚫
• 无需数据库。所有数据均储存在 GitHub Discussions 中。:octocat:
• 支持自定义主题！🌗
• 支持多种语言。🌐
• 高可配置性。🔧
• 自动从 GitHub 拉取新评论与编辑。🔃
• 可自建服务！🤳

注意：
giscus 仍处于活跃开发中，GitHub 也还在活跃地开发 Discussions 及其 API，因此一些 giscus 的特性可能随时间损坏或变更。

它如何运作

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

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

如果你使用了 giscus，请考虑在 GitHub 上 star 🌟 giscus 并为你的仓库添加 giscus 话题！🎉

高级用法

你可以依照高级用法指南添加额外配置（例如：仅允许特定来源的请求）。

如果想要在 React、Vue 和 Svelte 中使用 giscus，请查看 giscus 组件库。

迁移

如果你使用过利用 GitHub Issue 实现的评论系统（如 utterances、gitalk），你可将已有的 issue 转换成 discussion。转换后，只要确保 discussion 标题与页面的映射关系正确，giscus 就会自动使用这些 discussion。

正在使用 giscus 的网站

• laymonage.com
• os.phil-opp.com
• Stats and R
• Tech Debt Burndown Podcast
• 还有更多！

献一份力

请参阅 CONTRIBUTING.md。

---

本 README 有以下语言版本：

• Arabic (العربية)
• Català
• Dansk
• Deutsch
• English
• Esperanto
• Español
• Persian (فارسی)
• Français
• Ελληνικά
• Srpsko-Hrvatski (BCMS)
• עברית
• Magyar
• Indonesia
• Italiano
• 日本語
• ភាសាខ្មែរ
• 한국어
• Nederlands
• Polski
• Português
• Română
• Русский
• ภาษาไทย
• Türkçe
• Tiếng Việt
• Українська
• O'zbek
• 简体中文
• 繁體中文