Skip to content

Latest commit

 

History

History
100 lines (75 loc) · 4.55 KB

README.zh-TW.md

File metadata and controls

100 lines (75 loc) · 4.55 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 的留言系统(如 utterancesgitalk),你可以把已有的 issue 轉換成 discussion。轉換後,只要確保 discussion 標題與頁面的對應關係正確,giscus 就會自動使用這些 discussion。

正使用 giscus 的網站

貢獻

請查看 CONTRIBUTING.md


此 README 有以下語言版本:

威力本源 Vercel