术语表单页¶
该功能提供一个独立的术语表单页，直接读取 data/glossary.yaml，并在中英文页面中展示统一的术语定义，兼顾 SEO 与快速检索体验。
主要能力¶
- 服务端渲染完整术语列表，利于搜索引擎收录。
- 通过字母分组与搜索框完成快速定位。
- 中英文页面共享同一数据源，确保术语一致。
组成与路径¶
- 模板：
layouts/glossary/single.html - 数据源：
data/glossary.yaml - 页面入口：
content/zh/glossary/index.md、content/en/glossary/index.md - 样式：
assets/scss/templates/_glossary-page.scss - 交互脚本：
assets/js/glossary-page.js
使用方式¶
- 在
data/glossary.yaml追加或更新术语条目。 - 若涉及中文条目，请运行
npm run content:glossary:pinyin生成拼音索引字段。 - 内容页无需手动维护条目，只更新页面描述或引导文本即可。
- 构建时 Hugo 会自动渲染术语列表并注入搜索与分组能力。
拼音分组规则¶
中文页面按拼音首字母分组与排序，依赖 data/glossary.yaml 中的 py 字段。该字段由 pinyin-pro 自动生成，用于保证中文术语的拼音顺序一致。
自定义提示¶
- 页面简介与描述来自对应语言的
content/*/glossary/index.md。 - 若需调整分组规则，可在
layouts/glossary/single.html中修改分组逻辑。 - 搜索仅在浏览器端执行，不影响首屏渲染与 SEO。