前段時間使用過Disqus覺得不夠簡潔，而且有很多英文挺不方便的，在設置裡大致看過所有的評論系統，本來想使用Valine但是需要實名認證(需要有支付寶)，沒法完成認證所以改用Gitalk，那這邊就說明一下如何使用Gitalk。
Demo: https://gitalk.github.io
官方中文說明：https://github.com/gitalk/gitalk/blob/master/readme-cn.md
使用 GitHub 登录
支持多语言 [en, zh-CN, zh-TW, es-ES, fr, ru]
支持个人或组织
无干扰模式（设置 distractionFreeMode 为 true 开启）
快捷键提交评论 （cmd|ctrl + enter）
準備工作
- 如果你打算在自己的網站使用GITALK並且網站的源碼在github的倉庫上，你可以直接使用這個倉庫(Gitalk只會把評論放在倉庫的issues里面)；如果不是，請創建一個倉庫。
- 申請GitHub OAuth application，使Gitalk有權限操作github上的倉庫。
申請Github OAuth application
STEP 1
首先前往Github - Settings - Developer settings - OAuth Apps - New OAuth App，或者直接點擊
Register a new OAuth application創建OAuth App。
Application name：必填，OAuth的名字
Homepage URL：必填，使用組件的網站網址(填寫你的BLOG網址即可)
Application description：選填，該OAuth的說明
Authorization callback URL：必填，授權成功後回調網址，跟Homepage URL參數保持一致就好
這些參數在註冊成功後是可以修改。
STEP 2
創建成功後進入OAuth
你可以在這裡找到 client_id / client_secret
設定主題配置文件
請在主題配置文件設置
github_id 倉庫的創建者
repo 填你存放gitalk的倉庫名稱
client_id / client_secret 在你的OAuth裡頭可以找到
admin_user 你github倉庫的管理者(如是多人管理可以使用 ['admin_user1'],['admin_user2'] 這個格式)
language: zh-TW (也可設置其他 如:en | es-ES | fr | ru | zh-CN | zh-TW)
第一次Gitalk需要初始化評論，需要你先點擊使用GitHub登陸，然後刷新頁面才會初始化，
或者自己去倉庫里手動創建一個issues，並添加issues的labels值為Gitalk的labels參數和id參數的值。
Gitalk 評論是通過 issues 的 labels 來標示一篇文章的。
如果 labels 中存在相應文章的 label 標籤，那就說明該文章已經初始化過了。
例如
補充
管理評論
點擊評論右上方的鉛筆圖示可以管理評論。
可以對評論做reaction或是其他管理動作。
你也可以在右方設定通知方式
分別為
不訂閱: 僅當你參與了或者被@提及時才會收到通知
訂閱: 接收這個問題的所有通知
自訂: 有以下兩種
- 解決問題時收到通知
- 重新打開問題才會收到通知
在右側可以管理issue
創建issue
在issue頁面點擊New issue
設定issue
- Assignees: 選擇用於從當前倉庫的所有成員中，指派某個 Issue 的處理人員。
- Lagbels: 可以貼上標籤，這樣有利於分類管理和過濾查看。
創建labels
在issues頁面點擊Labels
點擊New Label
設定並創建Label
你可以在 .\themes\next\layout\_third-party\comments\gitalk.swig管理文章id格式
NexT 7.4.1的預設為
1 | id: '{{ gitalk_md5(page.path) }}', |
更詳細的建議參考：
- 如何使用 Issue 管理软件项目？
- Github Project-Card 與 Issue 的關係 （上）
- Github Project-Card 與 Issue 的關係 （下）
- 關於 GitHub 議題追蹤 ( Issue Tracker ) 的關鍵字搜尋技巧