博客系统 活跃维护

giscus

giscus/giscus

由 GitHub Discussions 提供支持的评论系统。:octocat: :speech_balloon: :gem:

12177
Stars 标星
487
Forks 分支
27
Watchers 关注
129
Open Issues
TypeScript
主要语言
MIT
开源协议
3.3 MB
仓库大小
5 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:giscus/giscus
git clone https://github.com/giscus/giscus.git
git clone git@github.com:giscus/giscus.git
README.md main

官方中文正文为项目官方提供的中文文档(原文转载),本站未作翻译、未改动文字,仅剔除图片与无关章节。

giscus

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

注意:\
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 的网站

献一份力

请参阅 CONTRIBUTING.md。


本 README 有以下语言版本:

本站来源与版权声明
  • 本文标题:giscus - 由 GitHub Discussions 提供支持的
  • 本文链接:https://www.cn121.com/blog/giscus-giscus.html
  • 原项目:giscus/giscus 版权归原作者 giscus 及贡献者所有
  • 收录信息:本站于 2026-10-24 收录本项目,本页所列协议与仓库指标均为收录当时的状态;该日期之后原项目的版本更新与协议变更,本页不作同步。
  • 开源协议:收录时本项目采用 MIT(查看 LICENSE 原文),本站转载其原始文档(未改动文字,仅剔除图片与无关章节);使用、修改、分发请以该仓库 LICENSE 原文为准。
  • 站点出处:本文首发于 OneTwoOne,收录自 GitHub 开源项目 giscus/giscus。
  • 内容说明:本页正文为项目官方提供的中文文档(原文转载),本站未作翻译、未改动文字,仅剔除了图片与赞助等无关章节、并把相对链接改为绝对地址;页首简介为机器翻译自仓库描述。
  • 引用声明:商业转载、第三方聚合或 AI 检索训练引用时,请务必保留以上来源出处、本文永久链接,以及原项目的版权声明与许可信息。
  • 下架通道:若原项目此后变更或收紧了许可协议、或作者/权利人认为本站的收录方式(译文、排版适配、简介翻译等)超出其授权范围,请通过 xyd3302001@163.com 发送下架通知,并附上项目地址与本页链接。本站核实后将第一时间删除本页内容,或改为不复制原文的目录性收录;署名更正等其他要求可一并提出。