ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Hugo Disqus:識別碼、本機停用與留言整合

任務導覽 TABLE OF CONTENTS

補上穩定討論識別碼與動態載入限制,修正為本機啟用留言的錯誤建議。

適用:Hugo現行Extended版本與本站NexT版面覆寫。原文的TOML/舊設定保留為歷史對照,實際以config.yaml及部署固定版本為準。

設定與主題差異

先在Disqus建立站點取得shortname。通用Hugo內建模板使用services.disqus.shortname;本站NexT設定及自訂rpg-disqus載入器可能讀取不同params,先從config.yaml與partial核對,不同主題不必同一key。

一般Hugo設定示意:

services:
  disqus:
    shortname: your-site-shortname

在自訂版面用Hugo內建Disqus模板或本站既有partial,擇一。不要在文章再插一個embed script造成重複thread。實際本文只沿用現有服務,不建立新shortname。

討論識別

每篇頁面的identifier與canonical URL需穩定,改標題或主題不能改成另一個討論。本站留言板有固定disqusIdentifier,用於避免討論分裂;文章以自己的穩定路徑設定,不讓所有文章共用同一個identifier。

若採官方JavaScript接線,配置this.page.url及this.page.identifier要在載入embed前完成,並使用正式HTTPS canonical URL。SPA導頁另按Disqus的resetAPI處理,Hugo一般整頁導航不用做SPA reset。

本機與正式驗證

loopback主機停用Disqus,避免把localhost建成正式討論。本文本機只驗證容器、載入狀態與說明,不發測試留言。正式站臺讀既有討論、檢查Network與Console及CSP來源;ad blocker或第三方cookie策略可能使載入失敗,應有可理解的提示與重試。

Disqus為外部服務,停用JS、斷網或指令碼被擋時文章仍應能閱讀。管理員稽核、通知及資料處理政策由站點設定維護,不把賬號管理token放前端。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文