Front Matter 规范

文章页

以下字段常用于 content/ 下的文章（如 实践笔记、我的清单 中的页面）：

字段	说明
`title`	必需。页面标题。Hugo 没有它无法渲染页面。
`created`	创建日期，`YYYY-MM-DD`。用于页面显示的"创建于"。
`tags`	标签数组，如 `[Docker, NAS]`。Hugo 自动为其生成标签页。不写就没有标签。
`updated`	手动指定更新日期，`YYYY-MM-DD`。不写则由 Git 提交时间自动填充。
`description`	页面描述。在搜索引擎结果和社交分享中展示。不写则 Hugo 自动截取正文前 70 字。
`weight`	整数，控制页面在列表中的排序，数字越小越靠前。
`draft`	`true` 则页面不构建。
`toc`	`false` 则禁用右侧目录。Hextra 主题字段。
`excludeSearch`	`true` 则排除在搜索索引外。Hextra 主题字段。
`sidebar.exclude`	`true` 则不在左侧边栏显示。Hextra 主题字段。

提示：Hugo 还支持 aliases、slug、layout、keywords 等字段，详见 Hugo 官方文档。本站目前不需要。

文章页模板

created: YYYY-MM-DD
title: 本文标题
tags: [标签1, 标签2]

索引页

以下字段常用于各分类下的 _index.md：

字段	说明
`title`	必需。分类名称。
`description`	分类描述，用于 SEO。不写则 Hugo 自动截取。
`weight`	整数，控制该分类在父级列表中的排序。

索引页模板

title: 分类名称
description: 分类描述
weight: 1

日期机制

hugo.yml 中配置了 front matter 的取值优先级：

frontmatter:
  date:
    - created       # 第一优先级 → 页面创建日期
    - date
  lastmod:
    - updated       # 手动覆盖（可选）
    - :git          # 由 Git 提交记录自动填充
    - lastmod

创建日期：Hugo 从 created 取值
更新日期：默认由 :git 自动填充（最后一次 commit 时间），如需手动指定，在 front matter 中写 updated 即可覆盖

最后更新于 2026年7月12日

修复 Git 提交时间无法显示