什么是 Gitalk
Gitalk 利用了 GithubAPI 基于 GitHub Issue 和 Preact 開(kāi)發(fā)的評(píng)論插件,官方網(wǎng)址: https://gitalk.github.io
Gitalk 特性
- 使用 GitHub 登錄
- 支持多語(yǔ)言 [en, zh-CN, zh-TW, es-ES, fr, ru]
- 支持個(gè)人或組織
- 無(wú)干擾模式(設(shè)置 distractionFreeMode 為 true 開(kāi)啟)
- 快捷鍵提交評(píng)論 (cmd|ctrl + enter)
配置Gitalk
- 要使用 Gitalk 需要先在 GitHub 上注冊(cè)新應(yīng)用,鏈接:https : //github.com/settings/applications/new

OAuth Apps
- 點(diǎn)擊注冊(cè)后,頁(yè)面大致如下,其中
Client ID和Client Secret在后面的配置中需要用到,也是應(yīng)用訪(fǎng)問(wèn)你 Github 的憑證,到時(shí)復(fù)制粘貼即可:

連接密匙
- Next 主題 v7.6.0 中已經(jīng)默認(rèn)集成了gitalk,只需在
\themes\next\_config.yml鎖定gitalk配置開(kāi)啟使用:

修改gittalk配置
gitalk:
enable: true #啟用gitalk
github_id: #github帳號(hào) 例:CodeHaotian
id: location.pathname #此設(shè)置參照下文常見(jiàn)問(wèn)題說(shuō)明
repo: #存放評(píng)論的倉(cāng)庫(kù)名稱(chēng)
client_id: #application的id,即上文Client ID
client_secret: #application的密碼,即上文Client Secret
admin_user: #頁(yè)面顯示聯(lián)系**初始化評(píng)論 例:CodeHaotian
distraction_free_mode: true # Facebook-like distraction free mode
# Gitalk's display language depends on user's browser or system environment
# If you want everyone visiting your site to see a uniform language, you can set a force language value
# Available values: en | es-ES | fr | ru | zh-CN | zh-TW
language: zh-CN
- 重新部署博客,打開(kāi)頁(yè)面進(jìn)入某一博客內(nèi)容下,評(píng)論會(huì)出現(xiàn)在頁(yè)面最下方
常見(jiàn)問(wèn)題說(shuō)明
1、未找到相關(guān)的issue進(jìn)行評(píng)論,請(qǐng)聯(lián)系@XXX初始化創(chuàng)建。

未初始化
- 解決辦法:出現(xiàn)這總情況是因?yàn)椴┲魑唇o文章評(píng)論初始化,博主只需要登錄 GitHub 賬戶(hù)即可。
2、瀏覽器進(jìn)入開(kāi)發(fā)者模式,看見(jiàn)類(lèi)似https://api.github.com/user 401 (Unauthorized)
- 解決辦法:找到主題配置文件, 在 gitalk 配置里添加
id: location.pathname
3、Error: Not Found.

Error: Not Found
- 解決辦法:未能正確找到倉(cāng)庫(kù) repo,檢查一下你的倉(cāng)庫(kù)是否配置正確
文章具體為 Hexo Next v7.6.0 環(huán)境下集成 Gitalk