giscusGitHub Discussions 驱动的评论系统

联合创作 · 2023-10-02 11:04

giscus 是一个由 GitHub Discussions 驱动的评论系统。让访客借助 GitHub 在你的网站上留下评论和反应吧!本项目受 utterances 强烈启发。

  • 开源
  • 无跟踪,无广告,永久免费
  • 无需数据库,全部数据均储存在 GitHub Discussions 中
  • 支持自定义主题
  • 支持多种语言
  • 高度可配置
  • 自动从 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 上管理评论。

高级用法

你可以依照高级用法指南添加额外配置(例如允许特定来源)。

要在 React、Vue 和 Svelte 中使用 giscus,请查看 giscus 组件库

迁移

如果你曾经使用过其它利用 GitHub Issue 的评论系统(如 utterancesgitalk),你可把已有的 issue 转换成 discussion。转换后,只要确保 discussion 标题与页面的映射关系正确,giscus 就会自动使用这些 discussion。

正使用 giscus 的网站

浏览 16
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报