由 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 上管理留言。
如果你使用了 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 有以下語言版本: