note

# Jean Hu 的笔记（note.nageyqma.icu）

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

## 主题说明

| 项 | 值 |
|---|---|
| 主题 | [PaperMod](https://github.com/adityatelange/hugo-PaperMod) |
| 所用 commit | `d3768854d00ad003b0a8dbdba254ce9224377a01`（2026-08-02） |
| 获取方式 | `git clone --depth 1 https://github.com/adityatelange/hugo-PaperMod themes/PaperMod` |
| 是否入库 | **否**（`themes/` 已在 .gitignore 中忽略） |

选定理由：

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

## 主导航：按分类"逛"版块

顶部导航以分类（Categories）为栏目：**首页 · 笔记 · 公告 · 随笔 · 全部分类 · 主站**，
点击任一分类即进入该版块的文章列表；「全部分类」（`/categories/`）是总览页，
自动列出全部**已有文章**的版块及各自文章数（0 篇的版块暂不显示，发布首篇后出现）；
末尾的「主站」外链回 `www.nageyqma.icu` 总站。

- 配置位置：`hugo.toml` 的 `[[menu.main]]`（`pageRef` 指向站内页面，weight 定顺序）。
- **新增分类后**：在 `hugo.toml` 追加一个对应条目（`pageRef = "/categories/<分类名>"`）；
  即使忘记追加，「全部分类」页也会兜底展示新版块，不会丢入口。
- 版块页的标题/简介：`content/categories/<分类名>/_index.md`（`title` + `description`）。
- 当前版块在导航中自动高亮（PaperMod 的 `.active` 下划线），面包屑可逐级返回。

## 首页与版块页背景：圆形主楼插画

首页与主导航的 Categories 版块页（`/categories/` 总览、`/categories/<版块>/`）
铺一幅**全幅插画背景**：圆形主楼——柱形鼓楼市体 +
中央塔楼圆窗 + 两翼跌落裙楼，前坪台阶、草坪圆树、棕榈与灯柱，
画风与主站星期背景同一套扁平手绘语言（描边、配色、造型一致）：

- **亮色主题 = 黄昏**（暖金天空、落日光晕、染霞云鸟）；
  **暗色主题 = 星夜**（星月、圆窗与窗阵透出暖灯、点亮的灯柱带光池）；
  随主题切换两层交叉淡入（1.4s 标准缓动，正文与玻璃面板配色同步渐变），
  并尊重 `prefers-reduced-motion`（直接切换不播过渡）。
- 横竖屏各一套**独立构图**（横版 1600×900 / 竖版 900×1600，非裁切缩放）。
- 首屏留出「画框」露出天空与主楼：首页大画框（约半屏，露出主楼冠部与圆窗），
  版块页小画框（页标题浮于天际，卡片随后压在主楼之上）。
- 内容面板全部毛玻璃化（与主站面板同款取色，含 `@supports` 回退）：
  首页 = 首条 + 文章卡片；版块页 = 页头标题面板 + 文章卡片 + 「全部分类」药丸。
- 无 JS 时 `data-theme` 停留在 `auto`，背景用系统偏好媒体查询兜底选昼夜。

实现位置：

- 插画：`static/backgrounds/campus-main-building-{landscape,portrait}-{day,night}.svg`
  （`day` = 黄昏、`night` = 星夜；纯手绘路径，画面内无任何文字）。
- 注入：`layouts/_partials/extend_head.html`（覆盖主题同名扩展点；首页
  `.IsHome` 或 categories 分类法的 taxonomy/term 页时输出 `<style>`，
  文章页（single）零影响）。
- 改配色 / 构图直接编辑 SVG；改留白高度、玻璃透明度、淡入时长在
  `extend_head.html` 的样式内。

## 本地开发

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

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

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

调试构建产物（而非 `hugo server`）时，把站内绝对链接改写为根相对——
不改写则点导航/文章会跳出当前调试环境（localhost / 服务器 IP / hosts 指向）：

```bash
find public -name '*.html' -exec sed -i 's|https://note\.nageyqma\.icu||g' {} +
python3 -m http.server 8000 -d public    # 任意 host 均可正常跳转
```

`deploy-note.sh` 部署时已自动做同样改写；RSS / sitemap 始终保留绝对地址。

## 目录速览

```
note/
├── hugo.toml            # 站点配置（简体中文单语言、主题参数、主导航菜单）
├── content/posts/       # 文章（Markdown，路径即访问路径）
│   └── <slug>/          # 带配图时用 leaf bundle：index.md 与图片同目录
├── content/categories/  # 分类（版块）页的标题与简介：_index.md
├── i18n/zh-cn.yaml      # 界面文案（主题只带 zh.yaml，zh-cn 需站点级补齐）
├── assets/css/extended/ # 自定义样式（毛玻璃头部，自动被主题加载）
├── layouts/_partials/   # extend_head.html：首页与版块页注入背景样式（覆盖主题扩展点）
├── static/backgrounds/  # 首页背景插画 SVG（横/竖 × 黄昏/夜 共 4 张）
└── themes/PaperMod/     # 主题（不入库）
```

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