https://www.leanku.com/tags/giscus/Recent content in Giscus on Leanku 的博客Hugozh-cnMon, 28 Oct 2024 00:00:00 +0000https://www.leanku.com/post/hugo-period/theme-integrations/Mon, 28 Oct 2024 00:00:00 +0000https://www.leanku.com/post/hugo-period/theme-integrations/<p>原 WordPress 主题的评论、搜索、联系表单在 Hugo 中由第三方服务替代，全部通过 <code>config.toml</code> 开关控制，<strong>未启用时页面不含任何相关脚本</strong>（性能优先）。</p> <table> <thead> <tr> <th>功能</th> <th>方案</th> <th>默认</th> </tr> </thead> <tbody> <tr> <td>评论</td> <td>Giscus / Utterances</td> <td>关闭</td> </tr> <tr> <td>搜索</td> <td>Pagefind</td> <td>开启</td> </tr> <tr> <td>联系表单</td> <td>Formspree / Netlify Forms</td> <td>关闭</td> </tr> </tbody> </table> <h2 id="评论giscus推荐">评论：Giscus（推荐）</h2> <h3 id="一次性准备github-侧">一次性准备（GitHub 侧）</h3> <ol> <li>仓库设为<strong>公开</strong>；</li> <li>Settings → General → Features → 开启 <strong>Discussions</strong>；</li> <li>安装 <strong>giscus App</strong>：https://github.com/apps/giscus → Configure → 选择该仓库。</li> </ol> <h3 id="生成配置">生成配置</h3> <p>打开 <a href="https://giscus.app/zh-CN">https://giscus.app/zh-CN</a>，选择仓库与分类，复制生成的配置填入：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">[</span><span class="nx">params</span><span class="p">.</span><span class="nx">comments</span><span class="p">]</span> </span></span><span class="line"><span class="ln">2</span><span class="cl"> <span class="nx">provider</span> <span class="p">=</span> <span class="s2">&#34;giscus&#34;</span> </span></span><span class="line"><span class="ln">3</span><span class="cl"> <span class="nx">repo</span> <span class="p">=</span> <span class="s2">&#34;你的用户名/你的仓库&#34;</span> </span></span><span class="line"><span class="ln">4</span><span class="cl"> <span class="nx">repoId</span> <span class="p">=</span> <span class="s2">&#34;R_kgDOxxxxxxx&#34;</span> </span></span><span class="line"><span class="ln">5</span><span class="cl"> <span class="nx">category</span> <span class="p">=</span> <span class="s2">&#34;Announcements&#34;</span> </span></span><span class="line"><span class="ln">6</span><span class="cl"> <span class="nx">categoryId</span> <span class="p">=</span> <span class="s2">&#34;DIC_kwDOxxxxxxx&#34;</span> </span></span><span class="line"><span class="ln">7</span><span class="cl"> <span class="nx">theme</span> <span class="p">=</span> <span class="s2">&#34;light&#34;</span> <span class="c"># 或 dark；勿用 preferred_color_scheme（SSR 缺陷）</span> </span></span></code></pre></div><blockquote> <p>排查：页面报 &ldquo;giscus is not installed&rdquo; → App 未安装/仓库非公开/Discussions 未开启； 控制台 MIME 报错 → theme 用了非法值。</p>