本站用的 Hugo 主题:yukikaze

这个博客使用的是自制 Hugo 主题 yukikaze(雪风)。它的目标很明确:为中文长文提供一个版心稳定、字距和行距克制、阅读节奏清楚的界面。

它解决了什么

  • 阅读区:正文默认两端对齐,标题层级和段落间距按长文阅读场景做了专门调整。
  • 目录:文章包含 h2h4 时自动生成目录;在宽屏布局下,目录固定在侧栏,过长时仅在侧栏内部滚动。
  • 滚动联动:侧栏目录会随着正文滚动高亮当前章节。
  • 列表页:首页和归档页的文章条目整行可点击,命中范围更大。
  • 代码块:代码块带复制按钮,语法高亮由 Hugo 的 Chroma 提供。

字体怎么来的

正文和顶栏站点名使用 霞鹜文楷(LXGW WenKai),代码部分仍保持等宽字体,不和正文混排。

主题内使用的 Web 字体资源来自 lxgw-wenkai-webfont 分包,字形版权和许可仍以霞鹜文楷原始项目的 SIL OFL 1.1 为准。

如果要更换字体,直接修改 main.css 里的 font-family,或者替换 static/cssstatic/fonts 下的相关资源即可。

外观与配置

  • 深色模式:站点级可用 colorScheme = 'auto' | 'light' | 'dark',与系统或固定主题一致。
  • 目录开关:默认开;单篇可在 front matter 里写 toc = false 关掉。
  • Hugo 版本:主题声明的最低版本为 0.116.0;目录层级与 hugo.toml 里的 [markup.tableOfContents] 配置保持一致即可。

许可

主题代码以 MIT 发布;字体部分的许可和署名要求以 OFL 为准。若要 fork、再分发或用于商用,保留相应的字体版权说明即可。