補上穩定討論識別碼與動態載入限制,修正為本機啟用留言的錯誤建議。
適用: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