https://www.wkun.top/tags/papermod/Recent content in Papermod on 拾光笔记Hugozh-CNThu, 03 Sep 2026 21:00:00 +0800https://www.wkun.top/posts/hugo-papermod-%E7%A7%BB%E5%8A%A8%E7%AB%AF%E5%AF%BC%E8%88%AA%E6%A0%8F%E6%B1%89%E5%A0%A1%E8%8F%9C%E5%8D%95/Thu, 03 Sep 2026 21:00:00 +0800https://www.wkun.top/posts/hugo-papermod-%E7%A7%BB%E5%8A%A8%E7%AB%AF%E5%AF%BC%E8%88%AA%E6%A0%8F%E6%B1%89%E5%A0%A1%E8%8F%9C%E5%8D%95/<p>博客用的是 Hugo 的 PaperMod 主题，默认的导航栏在手机上是<strong>横向滚动</strong>的：菜单项一多就溢出屏幕，想看后面的得用手指拖着划，很难受。我希望把它改成常见的「点一下汉堡按钮弹出菜单」的形式，顺手还要让导航栏吸顶、点空白处能收回。这篇记录一下完整的改法。</p>https://www.wkun.top/posts/hugo-papermod-%E8%87%AA%E5%AE%9A%E4%B9%89404%E4%B8%8E%E7%B3%BB%E5%88%97%E5%AF%BC%E8%88%AA/Tue, 01 Sep 2026 20:00:00 +0800https://www.wkun.top/posts/hugo-papermod-%E8%87%AA%E5%AE%9A%E4%B9%89404%E4%B8%8E%E7%B3%BB%E5%88%97%E5%AF%BC%E8%88%AA/<p>PaperMod 主题自带的 404 页面只有一句纯文字，很简陋；右侧侧边栏的「系列」卡片此前也只放了系列名链接，不显示系列里的其他文章。这次给博客补上自定义 404 页面，并把系列内导航做进右侧系列卡片里。本文记录实现过程。</p>https://www.wkun.top/posts/hugo-papermod-%E6%96%87%E7%AB%A0%E5%88%86%E7%B1%BB%E7%B3%BB%E5%88%97%E6%A0%87%E7%AD%BE%E5%8F%B3%E4%BE%A7%E4%BE%A7%E8%BE%B9%E6%A0%8F/Sat, 22 Aug 2026 19:00:00 +0800https://www.wkun.top/posts/hugo-papermod-%E6%96%87%E7%AB%A0%E5%88%86%E7%B1%BB%E7%B3%BB%E5%88%97%E6%A0%87%E7%AD%BE%E5%8F%B3%E4%BE%A7%E4%BE%A7%E8%BE%B9%E6%A0%8F/<p>想把文章的标签放到网页右侧，做法是仿照 PaperMod 已有的左侧目录（TOC）侧边栏机制，在后面又加上了分类和系列，做成三个独立卡片，随页面滚动固定不动。本文记录实现过程和踩的坑。</p>https://www.wkun.top/posts/giscus-%E8%AF%84%E8%AE%BA%E5%8C%BA%E8%B7%9F%E9%9A%8F%E4%B8%BB%E9%A2%98%E6%98%8E%E6%9A%97/Sat, 22 Aug 2026 18:00:00 +0800https://www.wkun.top/posts/giscus-%E8%AF%84%E8%AE%BA%E5%8C%BA%E8%B7%9F%E9%9A%8F%E4%B8%BB%E9%A2%98%E6%98%8E%E6%9A%97/<p>折腾评论区的时候发现一个事：站点的评论区不会跟随主题变色，一直白底。查阅资料发现giscus官方配置中的<code>data-theme=&quot;preferred_color_scheme&quot;</code>表示跟随系统变色，我把系统颜色从浅色改成深色后，评论区就变成了深色，但是我希望评论区跟随主题变色，所以需要做一些调整。</p>https://www.wkun.top/posts/%E9%A6%96%E9%A1%B5%E6%89%93%E5%AD%97%E6%9C%BA%E7%89%B9%E6%95%88%E6%89%8B%E6%9C%BA%E7%AB%AF%E6%98%BE%E7%A4%BA%E4%B8%8D%E5%85%A8%E4%BF%AE%E5%A4%8D/Sat, 22 Aug 2026 09:00:00 +0800https://www.wkun.top/posts/%E9%A6%96%E9%A1%B5%E6%89%93%E5%AD%97%E6%9C%BA%E7%89%B9%E6%95%88%E6%89%8B%E6%9C%BA%E7%AB%AF%E6%98%BE%E7%A4%BA%E4%B8%8D%E5%85%A8%E4%BF%AE%E5%A4%8D/<p>最近发现手机端访问首页时，标题「半知半解，且过且学！」的打字机特效走完之后，文字右侧被截断、显示不全，而桌面端一切正常。本文记录排查过程与修复方案。</p>https://www.wkun.top/posts/hugo-papermod-%E8%87%AA%E5%AE%9A%E4%B9%89/Tue, 11 Aug 2026 20:13:53 +0800https://www.wkun.top/posts/hugo-papermod-%E8%87%AA%E5%AE%9A%E4%B9%89/<p>这一部分主要是跟着问道凌虚的<a href="https://www.zeyes.org/posts/tech/hugo-papermod-customization">《Hugo折腾记》</a>来做的（注：该站点目前已无法访问，链接仅作出处记录）。</p> <h2 id="下面是我自行修改的配置">下面是我自行修改的配置</h2> <h3 id="1-侧边目录及阅读进度条">1 侧边目录及阅读进度条</h3> <p>侧边目录最初参考了<a href="https://www.zhouxin.space/logs/introduce-side-toc-and-reading-percentage-to-papermod/">在PaperMod中引入侧边目录和阅读进度显示</a>，基本没有修改。后来把目录内容换成了Hugo内置的<code>.TableOfContents</code>（由Hugo直接生成嵌套<code>&lt;ul&gt;</code>），模板只保留外框和滚动高亮；阅读进度条则挂在「回到顶部」按钮上。下面记录最终的做法。</p> <h4 id="11-配置hugoyaml">1.1 配置（hugo.yaml）</h4> <p>目录收录的标题层级交给Hugo内置目录控制，保持h1~h6全收（我站内有文章用<code>#</code>当章节标题）：</p>