Skip to content

Latest commit

 

History

History
119 lines (94 loc) · 5.17 KB

File metadata and controls

119 lines (94 loc) · 5.17 KB

由 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 並為你的repo 加上 giscus topic!🎉

進階用法

你可以依照進階用法指南添加其他設定(例如允許特定來源)。

要在 React、Vue 和 Svelte 中使用 giscus,請查看 giscus components。

轉移

如果你曾經使用過其它利用 GitHub Issue 的留言系統(如 utterances、gitalk),你可以把已有的 issue 轉換成 discussion。轉換後,只要確保 discussion 標題與頁面的對應關係正確,giscus 就會自動使用這些 discussion。

正使用 giscus 的網站

貢獻

請查看 CONTRIBUTING.md。


此 README 有以下語言版本:

由 Vercel 技術支援