前置元数据配置

日期

Page 对象上有四个返回日期的方法：

Hugo 依据下面这份默认配置决定各方法返回什么值：

[frontmatter]
date = ['date', 'publishdate', 'pubdate', 'published', 'lastmod', 'modified']
expiryDate = ['expirydate', 'unpublishdate']
lastmod = [':git', 'lastmod', 'modified', 'date', 'publishdate', 'pubdate', 'published']
publishDate = ['publishdate', 'pubdate', 'published', 'date']

以 ExpiryDate 方法为例：如果存在 expirydate 就用它，否则返回 unpublishdate。

也可以使用自定义的日期参数：

[frontmatter]
date = ["myDate", "date"]

上例中，Date 方法在存在 myDate 时返回它，否则返回 date。

要让序列在末尾回退到默认的日期顺序，使用 :default 记号：

[frontmatter]
date = ["myDate", ":default"]

上例中，Date 方法在存在 myDate 时返回它，否则从 date、publishdate、pubdate、published、lastmod、modified 中返回第一个有效日期。

别名

部分前置元数据字段有别名：

默认的前置元数据配置已包含这些别名。

记号

Hugo 提供以下记号，用于配置前置元数据。

:default

默认的、有固定顺序的日期字段序列。

:fileModTime

文件的最后修改时间戳。

:filename

从文件名中提取日期，前提是文件名以符合下列格式之一的日期开头：

• YYYY-MM-DD
• YYYY-MM-DD-HH-MM-SS（自 v0.148.0 起）

在 YYYY-MM-DD-HH-MM-SS 格式中，日期与时间之间可以用任意字符分隔，包括空格（例如 2025-02-01T14-30-00）。

Hugo 会把提取出的日期按项目配置中的 timeZone 解析，未配置时回退到系统时区。Hugo 还会用文件名剩余的部分推导页面的 slug，但页面已在前置元数据中定义 slug 时除外。

只有当 :filename 成为最终生效的日期来源时，才会推导 slug。如果列表中更靠前的条目提供了有效日期，Hugo 会完全跳过 :filename。例如配置为 date = ["date", ":filename"] 时，在前置元数据里定义了 date 的页面将使用该值，slug 也不会由文件名推导。

例如，把文件命名为 2025-02-01-article.md，Hugo 会把日期设为 2025-02-01，把 slug 设为 article。

:git

文件最后一次修订的 Git 作者日期。要使用该值，需将 enableGitInfo 设为 true。

示例

假设项目配置如下：

[frontmatter]
date = [':filename', ':default']
publishDate = [':filename', ':default']
lastmod = ['lastmod', ':fileModTime']

确定 date 与 publishDate 时，Hugo 先尝试从文件名中提取值，失败则回退到默认的日期字段序列。

确定 lastmod 时，Hugo 先查找前置元数据中的 lastmod 字段，失败则回退到文件的最后修改时间戳。