Giscus:基于 GitHub Discussions 的评论系统

Giscus 是一个基于 GitHub Discussions 的评论系统,评论数据完全存储在 GitHub,无需额外的数据库或第三方平台。适合托管在 GitHub Pages、Cloudflare Pages 等静态站点。 工作原理 Giscus 把每篇页面的评论映射到 GitHub Discussions 中的一个 Discussion,通过在页面嵌入 <script> 标签加载评论组件。 页面与 Discussion 的映射方式: 映射方式 说明 pathname(推荐) 按页面 URL 路径匹配,最通用 title 按文章标题匹配 og:title 按 Open Graph 标题匹配 前置条件 GitHub 仓库需开启 Discussions 功能:仓库 Settings → Features → Discussions ✓ 安装 Giscus GitHub App:github.com/apps/giscus → Install → 选择目标仓库 获取配置参数 访问 giscus.app,填写仓库名和配置选项,页面底部会生成完整的 <script> 标签,从中获取: data-repo-id(格式 R_kgDO...):仓库 Node ID data-category-id(格式 DIC_kwDO...):Discussion 分类 ID Discussion 分类推荐选 Announcements:只有维护者能在 GitHub 网页直接新建 Discussion,普通用户只能通过 Giscus 组件留言,防止垃圾内容。 ...

Created 16166-06-16 · Updated 16166-06-16 · 1 min · 181 words · -