由 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 並為你的repo 加上 giscus
topic!🎉
你可以依照進階用法指南添加其他設定(例如允許特定來源)。
要在 React、Vue 和 Svelte 中使用 giscus,請查看 giscus components。
如果你曾經使用過其它利用 GitHub Issue 的留言系统(如 utterances、gitalk),你可以把已有的 issue 轉換成 discussion。轉換後,只要確保 discussion 標題與頁面的對應關係正確,giscus 就會自動使用這些 discussion。
請查看 CONTRIBUTING.md。
此 README 有以下語言版本: