0%

Hexo 搭建系列 - 為HEXO NexT主題安裝Gitalk評論功能

前段時間使用過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)

準備工作

  1. 如果你打算在自己的網站使用GITALK並且網站的源碼在github的倉庫上,你可以直接使用這個倉庫(Gitalk只會把評論放在倉庫的issues里面);如果不是,請創建一個倉庫。
  2. 申請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) }}',

更詳細的建議參考:

參考網站

------------ 本文結束 ------------

【版權聲明】
本文鏈接: https://zenreal.github.io/posts/10105/
本文為博主(ZEN)原創文章,遵循CC BY-NC-SA 4.0 版權協議,轉載請附上原文出處鏈接和本聲明。