首页 on 我的 Hugo 站点

表格测试

Fri, 26 Sep 2025 00:00:00 +0000

左对齐	居中	右对齐
a	b	c
`代码`	斜体	粗体

主题指南

Sun, 21 Sep 2025 00:00:00 +0000

这篇文章展示 hugo-trainsh 的主要渲染能力——标题、代码、表格、图表、公式、图片等。

三种主题模式
文字排版
代码
表格
图表
数学公式
图片
标签

三种主题模式

点击页头的切换按钮依次切换：

复古 (手柄) — NES 深蓝底色、像素字体标题、8-bit 对话框边框
明亮 (太阳) — 干净的现代浅色方案
暗黑 (月亮) — 适合夜间阅读

文字排版

常规 Markdown 正常渲染。粗体在复古模式下以金色高亮，斜体同样清晰可读。可以添加任意链接，样式会跟随主题变化。

引用块在复古模式下有独立的青色边框，在长文中一眼可辨。

代码

围栏代码块支持语法高亮、复制按钮和自动换行：

 
from datetime import date

def greet(name: str) -> str:
 return f"你好, {name}！今天是 {date.today()}。"

print(greet("世界"))

行内代码如 hugo server 也有对应样式。

归档与标签

Sun, 14 Sep 2025 00:00:00 +0000

归档

通过归档页按时间查看历史文章；首页展示最新文章列表。

代码示例

Sun, 24 Aug 2025 00:00:00 +0000

JavaScript

 
export function hasFeature(name) {
 return ['短代码', 'Mermaid', 'KaTeX', 'PhotoSwipe', 'i18n'].includes(name);
}
console.log(hasFeature('短代码'));

Python

 
from dataclasses import dataclass
from datetime import date

@dataclass
class DemoFeature:
 name: str
 enabled: bool

features = ["代码块增强", "搜索", "标签筛选", "点赞", "多语言"]
status = [DemoFeature(name=feature, enabled=True) for feature in features]

print(date.today().isoformat(), status[:2], f"total={len(status)}")

图表与公式演示

Sat, 07 Sep 2024 00:00:00 +0000

时序图

 sequenceDiagram
 participant 用户
 participant Hugo
 participant 主题 as 主题运行时
 用户->>Hugo: 保存内容
 Hugo->>主题: 模板渲染
 主题-->>用户: 实时刷新

公式

行内公式：$\alpha + \beta = \gamma$。

块级公式：

\sum_{i=1}^{n} i = \frac{n(n+1)}{2}

工程原则 2024

Mon, 22 Apr 2024 00:00:00 +0000

原则

小步快跑，频繁发布。
关键路径优先使用成熟技术。
测试即文档，保持可读性。
添加功能前先确保可回滚。

说明

这些原则刻意保持简洁，便于记忆和讨论。

图片与灯箱

Thu, 31 Aug 2023 00:00:00 +0000

外链图片

点击图片可在灯箱中查看大图：

打开原图

本地图片说明

若使用页面资源包（Page Bundle），请将图片与 index.md 放在同一目录，仅使用文件名引用以自动获取尺寸。

功能演示手册

Thu, 18 Mar 2021 00:00:00 +0000

这篇文章为什么更新

这篇 demo 文章改为用于核对最新版本主题特性，帮助你快速确认站点更新是否完整生效。

验证流程

语言切换器能正常跳转到对应语言的同类页面。
列表页支持搜索与标签筛选。
文章内容中的短代码（toc、tags、recent-posts）正常渲染。
代码块、Mermaid、KaTeX、PhotoSwipe 都可以正常使用。
主题切换按钮三态循环正常：明亮（太阳）→ 暗黑（月亮）→ 复古（手柄）→ 明亮。复古模式应显示 NES 像素风格（深蓝背景、像素字体标题）。

建议配置

params.mainSections 需要包含实际发文目录（示例为 posts）。
outputs.home 开启 JSON 才可使用客户端搜索索引。

备注

多语言同义内容可通过 translationKey 做一一对应。