將部落格的留言系統換成giscus

本站用的留言系統是Cusdis,最近發現iframe高度顯示問題(〈Height is not being set properly〉),開發者似乎在半放生狀態,幾乎沒在更新和解決問題,所以決定換到其他留言系統。本來是相中Remark42,多次深思熟慮後,我認為留言數不多,要額外維護一個伺服器,非常不切實際。後來選擇以GitHub Discussions為基礎的giscus,因為簡單方便,使用上幾乎沒什麼限制。

安裝步驟不多,流程大致上是:

  1. 到GitHub新建一個儲存庫(必須設為公開),開啟Discussions功能。
  2. 安裝giscus App
  3. giscus官網,設定一些選項,選完自動產生Script程式碼。
  4. 將程式碼貼到部落格主題的留言區塊,例如hexo-theme-lightcomment.ejs

修改CORS安全性和預設留言排列順序(最新到最舊):

  1. 到留言系統的儲存庫新增一個giscus.json檔案。
  2. 內容如下:
    {
    "origins": ["https://carlos.mynet.tw", "http://127.0.0.1:4000"],
    "defaultCommentOrder": "newest"
    }
    

其中本機網域localhost127.0.0.1是不一樣的,如果不需要可以刪掉。最後:

  1. 留言通知會發Email到你的GitHub信箱。
  2. 所有留言可到GitHub進行管理。
  3. 留言分類建議選Announcements,以確保新的discussion只能由維護者和giscus建立,而且GitHub Discussions預設以此分類顯示。

參考文章: