↓ 跳过正文
tag — Starmap & Dust

Hugo

13 篇文章 · 持续更新中

Blowfish 自定义规范与本博客的轻量做法

Blowfish 自定义规范与本博客的轻量做法

·2281 字·5 分钟
给一个 Hugo 主题做自定义,最怕的不是写不出来,而是写法不符合主题的设计意图 —— 升级主题时全崩,或者改了半天发现配置项被自己的模板吞掉了。 这篇把 Blowfish 官方文档(/docs/advanced-customisation/)的硬性规定和本站的实际做法放在一起,方便以后照着改。
Umami 统计部署指南

Umami 统计部署指南

·2726 字·6 分钟
Umami 统计部署指南 # 本指南帮助你在 Railway 上部署 Umami 统计,为博客添加隐私友好的网站分析功能。Umami 是 Google Analytics 的开源替代方案,数据完全掌控在自己手中。
KaTeX 数学公式

KaTeX 数学公式

·607 字·2 分钟
KaTeX 数学公式 # Blowfish 主题使用 KaTeX 渲染数学公式。KaTeX 是一个快速的数学排版库。 启用方法 # 在文章中添加 shortcode(放在任意位置): +++ title = "文章标题" +++ 文章内容... 支持的公式格式 # 行内公式 # 使用 \(...\) 包裹: 行内公式: \(E = mc^2\) 效果:行内公式: \(E = mc^2\) 块级公式 # 使用 $$...$$ 或 \[...\] 包裹: $$ \varphi = \frac{1 + \sqrt{5}}{2} = 1.6180339887… $$ 效果: $$ \varphi = \frac{1 + \sqrt{5}}{2} = 1.6180339887… $$ 配置原理 # 两层配置 # 层级 文件 作用 Hugo Goldmark config/_default/markup.toml 保留 LaTeX 语法,不转换为 HTML 实体 KaTeX auto-render themes/blowfish/assets/lib/katex/auto-render.min.js 渲染数学公式 Hugo Goldmark 配置 # config/_default/markup.toml: [goldmark.extensions.passthrough.delimiters] block = [['\[', '\]'], ['$$', '$$']] inline = [['\(', '\)']] 这告诉 Hugo:不要转义这些分隔符之间的内容。 KaTeX delimiters 定义 # KaTeX auto-render 的默认分隔符(在 auto-render.min.js 中): 分隔符 类型 说明 $$...$$ 块级 标准块级公式 \(...\) 行内 标准行内公式 \[...\] 块级 LaTeX 标准块级 \begin{equation}...\end{equation} 块级 equation 环境 \begin{align}...\end{align} 块级 align 环境 注意:默认配置不支持 $...$ 作为行内公式分隔符。 常见问题 # Q: 为什么 $E = mc^2$ 不渲染? # A: KaTeX 默认不支持 $...$ 分隔符。使用 \(...\) 代替: ❌ $E = mc^2$ ✅ \(E = mc^2\) Q: 如何添加 $...$ 支持? # A: 需要自定义 KaTeX 配置。创建 layouts/partials/extend-head.html: <script> document.addEventListener("DOMContentLoaded", function() { renderMathInElement(document.body, { delimiters: [ {left: "$$", right: "$$", display: true}, {left: "$", right: "$", display: false}, {left: "\\(", right: "\\)", display: false}, {left: "\\[", right: "\\]", display: true} ] }); }); </script> Q: 中文文章自动摘要不工作? # A: Hugo 的 .Summary 基于空格分词,对中文不适用。使用 `
Blowfish 图表使用

Blowfish 图表使用

·650 字·2 分钟
Blowfish 图表使用 # Blowfish 主题内置了 Chart.js 支持,可以通过 Frontmatter 变量灵活地管理图表数据。 为什么使用 Frontmatter 变量? # 数据集中管理:所有数据在文章开头定义,便于查看和修改 数据复用:同一组数据可用于多个图表 维护方便:更新数据时只需修改 frontmatter 使用 Frontmatter 管理图表数据 # 虽然 Hugo 不能直接在 <script> 标签中处理 frontmatter 变量,但你仍然可以在 frontmatter 中定义数据结构,然后复制到 shortcode 中使用。这样做的好处是:
如何自定义文章标题

如何自定义文章标题

·476 字·1 分钟
概述 # 在 Hugo 中,文章显示的标题由 frontmatter 中的 title 字段控制,与文件名无关。这意味着你可以自由命名文件,而页面显示的标题完全由 frontmatter 决定。