Posts on Zhenda's Blog

微信小程序合作流程

Tue, 31 Mar 2026 00:21:10 +0800

电子设备的多用户模式整理

Sat, 28 Mar 2026 21:07:46 +0800

圣经译本

Sat, 21 Mar 2026 15:59:01 +0800

Creed

Mon, 16 Mar 2026 23:01:23 +0800

Theology（神学）的重要分支

Mon, 16 Mar 2026 21:45:01 +0800

Gfw

Mon, 02 Mar 2026 12:13:39 +0800

多肉饲养笔记

Sat, 03 Jan 2026 12:28:30 +0800

我的生态系统(鱼缸)

Sun, 28 Dec 2025 22:33:38 +0800

Math

Tue, 11 Nov 2025 14:47:44 +0800

R Jung

Thu, 16 Oct 2025 15:30:10 +0800

Height

Thu, 16 Oct 2025 08:54:27 +0800

Time

Tue, 14 Oct 2025 15:30:58 +0800

Baby

Tue, 14 Oct 2025 11:07:00 +0800

Healthy

Fri, 10 Oct 2025 17:39:21 +0800

Energy

Fri, 10 Oct 2025 15:15:39 +0800

Exercise

Fri, 10 Oct 2025 15:00:31 +0800

Eat

Fri, 10 Oct 2025 15:00:22 +0800

Sleep

Thu, 09 Oct 2025 17:23:23 +0800

M2m W2w

Thu, 09 Oct 2025 16:08:19 +0800

Quit Smoking

Thu, 09 Oct 2025 14:41:13 +0800

Face Care

Fri, 26 Sep 2025 15:28:58 +0800

Hair Care

Fri, 26 Sep 2025 10:42:09 +0800

Homepage

Tue, 23 Sep 2025 08:57:51 +0800

生活中的虚拟化

Thu, 18 Sep 2025 00:53:19 +0800

骚然电话防治研究

Wed, 17 Sep 2025 20:43:31 +0800

Readme Guide

Fri, 12 Sep 2025 10:35:02 +0800

Invest

Thu, 28 Aug 2025 00:12:11 +0800

间谍

Wed, 20 Aug 2025 11:57:51 +0800

Wenziyu

Wed, 20 Aug 2025 11:53:08 +0800

Electron Stu

Tue, 12 Aug 2025 16:12:13 +0800

IDE Shortcut Key

Wed, 23 Apr 2025 17:12:39 +0800

经济模式

Wed, 09 Apr 2025 10:13:09 +0800

Blowfish 图表使用

Mon, 07 Apr 2025 00:00:00 +0800

KaTeX 数学公式

Mon, 07 Apr 2025 00:00:00 +0800

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 基于空格分词，对中文不适用。使用 `

Umami 统计部署指南

Mon, 07 Apr 2025 00:00:00 +0800

Blowfish 布局说明

Sun, 06 Apr 2025 00:00:00 +0800

Blowfish 搜索功能

Sun, 06 Apr 2025 00:00:00 +0800

Blowfish 迁移记录

Sun, 06 Apr 2025 00:00:00 +0800

Blowfish 配置指南

Sun, 06 Apr 2025 00:00:00 +0800

Blowfish 配置选项
#

配置项	当前值	可选值	说明
外观
`colorScheme`	blowfish	blowfish, avocado, fire, ocean, forest, neon, etc.	主题配色
`defaultAppearance`	light	light, dark	默认外观
`autoSwitchAppearance`	true	true, false	自动切换深浅色
导航栏
`header.layout`	fixed	basic, fixed, fixed-fill, fixed-fill-blur	导航栏样式
首页
`homepage.layout`	profile	profile, page, hero, card, background, custom	首页布局
`homepage.showRecentItems`	999	数字	显示文章数
`homepage.cardView`	true	true, false	卡片视图
文章
`article.showHero`	false	true, false	显示 Hero 图片
`article.heroStyle`	-	basic, big, background, thumbAndBackground	Hero 样式
`article.showBreadcrumbs`	false	true, false	面包屑导航
`article.sharingLinks`	-	bluesky, email, facebook, linkedin, mastodon, etc.	分享按钮
列表页
`list.showHero`	false	true, false	列表 Hero 图片
`list.showSummary`	false	true, false	显示摘要
其他
`footer.showAppearanceSwitcher`	false	true, false	底部外观切换
`smartTOC`	-	true, false	智能 TOC 高亮

当前已启用的功能
#

✅ 搜索 (enableSearch = true)
✅ 代码复制 (enableCodeCopy = true)
✅ 固定导航栏 (header.layout = "fixed")
✅ 文章目录 (article.showTableOfContents = true)
✅ 阅读时间 (article.showReadingTime = true)
✅ 字数统计 (article.showWordCount = true)
✅ 标题锚点 (article.showHeadingAnchors = true)
✅ 分类标签 (article.showTaxonomies = true)
❌ 按年份分组 (list.groupByYear = false)
✅ 卡片视图 (list.cardView = true)
⏸️ Giscus 评论（需要自定义 partial）
⏸️ 文章缩略图（可选）
⏸️ 面包屑导航

待配置功能
#

⏸️ 作者头像（需要添加图片）
⏸️ 分享按钮
⏸️ Hero 图片

文章创建配置
#

修改 archetypes/default.md 可设置新文章的默认 front matter：

+++
title = '{{ replace .File.ContentBaseName "-" " " | title }}'
subtitle = ""
date = {{ .Date }}
draft = false # 默认发布状态
toc = true
series = []
+++

创建新文章时使用：

hugo new posts/my-new-article.md

文章摘要配置
#

Blowfish 主题根据文章开头格式自动生成摘要：

开头格式	摘要来源	示例
正文 + `

Firebase 集成指南

Sun, 06 Apr 2025 00:00:00 +0800

Hugo 主题对比

Sun, 06 Apr 2025 00:00:00 +0800

Hugo 缓存问题

Sun, 06 Apr 2025 00:00:00 +0800

Mermaid 图表支持

Sun, 06 Apr 2025 00:00:00 +0800

如何自定义文章标题

Sun, 06 Apr 2025 00:00:00 +0800

Pc Cmd

Mon, 10 Feb 2025 16:03:26 +0800

Sqlalchemy Stu

Fri, 07 Feb 2025 12:19:54 +0800

操作系统大全

Thu, 06 Feb 2025 23:26:55 +0800

Prompts

Thu, 16 Jan 2025 10:20:23 +0800

Bible Words

Sat, 11 Jan 2025 19:50:33 +0800

Python Import

Fri, 10 Jan 2025 15:37:28 +0800

Js Ts Base

Tue, 31 Dec 2024 15:48:54 +0800

English Stu

Thu, 26 Dec 2024 17:52:42 +0800

Algorithm

Tue, 24 Dec 2024 11:08:01 +0800

Crawler

Wed, 18 Dec 2024 18:56:31 +0800

行业发展

Tue, 03 Dec 2024 16:13:01 +0800

个人商业

Wed, 27 Nov 2024 00:15:56 +0800

Ai Tool

Wed, 13 Nov 2024 21:08:52 +0800

Win Shell

Tue, 12 Nov 2024 20:32:30 +0800

Fastapi Tutorial

Sat, 09 Nov 2024 22:57:03 +0800

去中心化

Thu, 07 Nov 2024 02:07:14 +0800

Python Pip

Tue, 05 Nov 2024 16:42:27 +0800

Go_base

Wed, 25 Sep 2024 17:17:57 +0800

Python_basic

Wed, 18 Sep 2024 15:15:14 +0800

Css Guide

Thu, 27 Jun 2024 15:35:55 +0800

圣经主题

Sun, 23 Jun 2024 18:17:06 +0800

传福音

Sun, 23 Jun 2024 18:14:07 +0800

Python Small Tools

Mon, 03 Jun 2024 13:06:57 +0800

云服务器

Mon, 03 Jun 2024 09:49:51 +0800

Tornado Tutorial

Sun, 26 May 2024 01:17:25 +0800

Flask Tutorial

Sun, 26 May 2024 01:17:16 +0800

Browser

Sun, 26 May 2024 01:02:36 +0800

Flow Chart

Sun, 26 May 2024 00:21:47 +0800

Instruments

Sat, 25 May 2024 16:24:32 +0800

Markdown

Sat, 25 May 2024 15:47:33 +0800

进击的巨人

Fri, 24 May 2024 11:24:12 +0800

海贼王

Fri, 24 May 2024 11:19:38 +0800

火影忍者

Fri, 24 May 2024 11:00:04 +0800

Computer Science Crash Course

Fri, 24 May 2024 10:25:32 +0800

AI教程

Fri, 24 May 2024 10:16:53 +0800

Vue教程

Fri, 24 May 2024 10:16:28 +0800

Programming Paradigm

Wed, 22 May 2024 11:19:53 +0800

Django教程

Tue, 30 Apr 2024 14:07:14 +0800

Ubuntu使用配置

Tue, 30 Apr 2024 13:43:06 +0800

Docker指南

Tue, 09 Jan 2024 00:04:35 +0800

数据可视化资源

Mon, 08 Jan 2024 23:38:55 +0800

数据分析资源

Mon, 08 Jan 2024 23:38:45 +0800

Git资源

Mon, 08 Jan 2024 23:37:30 +0800

博客统计

Mon, 01 Jan 2024 00:00:00 +0800

Pyqt5指南

Sat, 25 Nov 2023 11:48:21 +0800

Linux系统教程

Sat, 25 Nov 2023 11:29:37 +0800

Python基础类2

Thu, 23 Nov 2023 22:49:27 +0800

Python基础类

Thu, 23 Nov 2023 21:54:28 +0800

Python基础虚拟环境管理 Anaconda

Thu, 23 Nov 2023 21:49:57 +0800

Python基础编程章法2

Thu, 23 Nov 2023 00:37:34 +0800

Python基础编程章法

Thu, 23 Nov 2023 00:31:29 +0800

First

Thu, 23 Nov 2023 00:03:40 +0800

Puppet - Getting Started

Tue, 09 Aug 2022 15:38:30 +0800

Puppet is a responsive, simple and clean Hugo theme based on the Huxblog Jekyll theme.

Markdown Syntax Guide

Wed, 11 Mar 2020 00:00:00 +0000

This article offers a sample of basic Markdown syntax that can be used in Hugo content files, also it shows whether basic HTML elements are decorated with CSS in a Hugo theme.

Rich Content

Sun, 10 Mar 2019 00:00:00 +0000

Hugo ships with several Built-in Shortcodes for rich content, along with a Privacy Config and a set of Simple Shortcodes that enable static and no-JS versions of various social media embeds.

Placeholder Text

Sat, 09 Mar 2019 00:00:00 +0000

Lorem est tota propiore conpellat pectoribus de pectora summo.

Math Typesetting

Fri, 08 Mar 2019 00:00:00 +0000

Mathematical notation in a Hugo project can be enabled by using third party JavaScript libraries.

Emoji Support

Tue, 05 Mar 2019 00:00:00 +0000

Emoji can be enabled in a Hugo project in a number of ways.

About Hugo

Thu, 28 Feb 2019 00:00:00 +0000

Posts on Zhenda's Blog

微信小程序合作流程

电子设备的多用户模式整理

圣经译本

Creed

Theology（神学）的重要分支

Gfw

多肉饲养笔记

我的生态系统(鱼缸)

Math

R Jung

Height

Time

Baby

Healthy

Energy

Exercise

Eat

Sleep

M2m W2w

Quit Smoking

Face Care

Hair Care

Homepage

生活中的虚拟化

骚然电话防治研究

Readme Guide

Invest

间谍

Wenziyu

Electron Stu

IDE Shortcut Key

经济模式

Blowfish 图表使用

KaTeX 数学公式

KaTeX 数学公式 #

启用方法 #

支持的公式格式 #

行内公式 #

块级公式 #

配置原理 #

两层配置 #

Hugo Goldmark 配置 #

KaTeX delimiters 定义 #

常见问题 #

Q: 为什么 $E = mc^2$ 不渲染？ #

Q: 如何添加 $...$ 支持？ #

Q: 中文文章自动摘要不工作？ #

Umami 统计部署指南

Blowfish 布局说明

Blowfish 搜索功能

Blowfish 迁移记录

Blowfish 配置指南

Blowfish 配置选项 #

当前已启用的功能 #

待配置功能 #

文章创建配置 #

文章摘要配置 #

Firebase 集成指南

Hugo 主题对比

Hugo 缓存问题

Mermaid 图表支持

如何自定义文章标题

Pc Cmd

Sqlalchemy Stu

操作系统大全

Prompts

Bible Words

Python Import

Js Ts Base

English Stu

Algorithm

Crawler

行业发展

个人商业

Ai Tool

Win Shell

Fastapi Tutorial

去中心化

Python Pip

KaTeX 数学公式
#

启用方法
#

支持的公式格式
#

行内公式
#

块级公式
#

配置原理
#

两层配置
#

Hugo Goldmark 配置
#

KaTeX delimiters 定义
#

常见问题
#

Q: 为什么 $E = mc^2$ 不渲染？
#

Q: 如何添加 $...$ 支持？
#

Q: 中文文章自动摘要不工作？
#

Blowfish 配置选项
#

当前已启用的功能
#

待配置功能
#

文章创建配置
#

文章摘要配置
#

Python基础类2

Python基础类

Python基础虚拟环境管理 Anaconda

Python基础编程章法2

Python基础编程章法