主题全功能深度测试指南

1. 复杂 Markdown 语法测试

#

除了基础的粗体、斜体和删除线，这里测试更复杂的 Markdown 边缘情况。

1.1 嵌套与混合列表

#

• 第一层无序列表

  • 第二层无序列表
    1. 第三层有序列表 A
    2. 第三层有序列表 B
       • 第四层无序列表（测试缩进渲染）

• 包含段落的列表项：

  这是同一列表项中的另一个段落。只需保持缩进即可。

1.2 任务列表与定义列表

#

• 配置 Hugo 基础环境
• 安装 Blowfish 主题
• 调整 hugo.toml 参数
• 部署到生产环境

HTML 定义列表测试：

Hugo

世界上最快的构建网站的框架之一。

Blowfish

一个高度可定制的、基于 Tailwind CSS 的 Hugo 主题。

1.3 脚注与内联 HTML

#

这里有一个脚注的引用¹，这里还有另一个²。 你可以使用 <kbd> 标签来表示按键操作：请按 Ctrl + C 复制。

2. Blowfish 核心 Shortcode 测试

#

2.1 警告与提示 (Alerts)

#

Blowfish 支持多种上下文类型的警告框，用于区分信息层级：

2.2 徽章、按钮与图标 (Badges, Buttons & Icons)

#

图标 (Icons): 支持 FontAwesome。例如：

徽章 (Badges): 用于标签或状态： v2.70.0 Stable

按钮 (Buttons): 访问个人站点测试

2.3 Github / Gitlab 仓库卡片

#

通过 API 实时拉取仓库信息（测试时请确保本地网络可访问外部 API）：

nunocoracao/blowfish

Personal Website & Blog Theme for Hugo

HTML

2689

708

2.4 打字机效果 (TypeIt)

#

2.5 标签页选项卡 (Tabs)

#

用于在有限空间内展示并列的内容（例如不同操作系统的安装命令）：

brew install hugo

winget install Hugo.Hugo.Extended

snap install hugo --channel=extended

2.6 时间线 (Timeline)

#

用于展示项目历程或个人履历：

1. 项目启动

   2026-01

   确定技术栈为 Hugo + Blowfish，完成本地环境搭建。
2. 功能开发

   2026-02

   完成自定义 Shortcode 编写与 CI/CD 流程配置。
3. 正式上线

   2026-03

   域名解析完成，全站正式对外提供访问。

2.7 详情折叠 (Details)

#

{
  "status": "ok",
  "theme": "blowfish"
}

3. 高级代码与多媒体支持

#

3.1 代码高亮与行号

#

测试 Hugo 原生的高亮引擎 (Chroma)，支持高亮特定行和行号显示：

1
2
3
4
5
6
7

package main

import "fmt" // 这行将被高亮

func main() {
    fmt.Println("Testing code highlighting!") // 这行也将被高亮
}

3.2 数学公式 (KaTeX/MathJax)

#

请确保 Front Matter 中已开启 math: true。

行内公式测试：物理学中的经典公式 $F=ma$，以及概率论中的贝叶斯定理 $P(A|B)=\frac{P(B|A)P(A)}{P(B)}$。

独立公式块测试（高斯积分）：

3.3 图表渲染

#

Mermaid 图表

#

请确保 Front Matter 中已开启 mermaid: true。

sequenceDiagram
    participant User as 用户
    participant Hugo as Hugo 引擎
    participant Browser as 浏览器
    
    User->>Hugo: 执行 `hugo server`
    Hugo-->>Hugo: 解析 Markdown & 模板
    Hugo->>Browser: 热重载推流 (LiveReload)
    Browser-->>User: 渲染页面

Chart.js 图表

#

请确保 Front Matter 中已开启 chart: true。

4. 图库与轮播图 (Media & Galleries)

#

注意：要使此部分生效，你需要将多张图片放入与本 Markdown 文件同名的文件夹中（Page Bundles 模式），或者在 static 目录下放置图片并修改路径。

4.1 图片画廊 (Gallery)

#

4.2 轮播图 (Carousel)

#

结尾

#

至此，大部分 Blowfish 的高频及复杂组件均已覆盖。