Jean Hu 的笔记（blog.nageyqma.icu）

基于 Hugo（extended 版）+ PaperMod 主题的简体中文单语言笔记站。

主题说明

选定理由：

1. 支持暗色模式（defaultTheme = "auto"：系统跟随 + 手动切换 + localStorage 持久化，与主站语义一致）；
2. 头部样式可定制（assets/css/extended/ 扩展点 + 覆盖 CSS，已改造成与主站一致的毛玻璃）；
3. 内建界面 i18n（简体中文文案开箱即用，单语言站点无需额外配置）；
4. 维护活跃（近期持续有提交）。

本地开发

# 安装主题（首次）
git clone --depth 1 https://github.com/adityatelange/hugo-PaperMod themes/PaperMod

# 本地预览（含草稿）
hugo server -D

# 构建产物到 public/
hugo --minify --gc

目录速览

blog/
├── hugo.toml            # 站点配置（简体中文单语言、主题参数、导航菜单）
├── content/posts/       # 文章（Markdown，路径即访问路径）
│   └── <slug>/          # 带配图时用 leaf bundle：index.md 与图片同目录
├── assets/css/extended/ # 自定义样式（毛玻璃头部，自动被主题加载）
└── themes/PaperMod/     # 主题（不入库）

写作与发布流程见仓库根目录 docs/blog-workflow.md：新增文章、标签与分类、配图、移除文章、构建部署。