前置数据 (Front Matter)
- title: 文章的标题。使用
replace
函数去除.Name
中的所有空格,然后用title
函数将首字母大写。 - date: 文章的日期。使用
.Date
变量,这个变量通常在创建文章时会自动填充。 - weight: 文章的权重,用于控制文章在列表中的排序。注释掉了,表示默认情况下不使用权重。
- aliases: 文章的别名,可以为文章提供多个 URL 路径。注释掉了,表示默认不使用。
- tags: 文章的标签,默认为空数组。
- author: 文章的作者,可以是字符串或字符串数组。这里设置为 “Me”,但可以设置为多个作者的数组。
- showToc: 是否显示目录(Table of Contents)。设置为
true
。 - TocOpen: 目录是否默认展开。设置为
false
。 - draft: 是否为草稿状态。设置为
false
表示不是草稿。 - hide meta: 是否隐藏元数据。设置为
false
表示显示。 - comments: 是否启用评论。设置为
false
表示禁用。 - description: 文章的描述,用于 SEO 或摘要显示。
- canonicalURL: 文章的规范 URL,用于 SEO。
- disableHLJS: 是否禁用 Highlight.js 语法高亮。设置为
true
表示禁用。 - disableShare: 是否禁用分享功能。设置为
false
表示启用。 - hideSummary: 是否隐藏摘要。设置为
false
表示显示。 - searchHidden: 是否在搜索结果中隐藏此页面。设置为
true
表示在搜索中隐藏。 - ShowReadingTime: 是否显示阅读时间。设置为
true
。 - ShowBreadCrumbs: 是否显示面包屑导航。设置为
true
。 - ShowPostNavLinks: 是否显示文章导航链接(上一篇/下一篇)。设置为
true
。 - ShowWordCount: 是否显示字数。设置为
true
。 - ShowRssButtonInSectionTermList: 在分类或标签列表页面是否显示 RSS 按钮。设置为
true
。 - UseHugoToc: 是否使用 Hugo 的内置目录功能。设置为
true
。
封面(Cover)
- image: 封面图片的路径或 URL。
- alt: 封面图片的替代文本(alt text),用于 SEO 和无障碍访问。
- caption: 封面图片的标题文字。
- relative: 是否使用相对路径。如果是页面包(page bundles),设置为
true
。 - hidden: 是否在当前页面隐藏封面。设置为
true
表示隐藏。
编辑文章(Edit Post)
- URL: 编辑文章的链接,通常指向 GitHub 仓库中的文件。
- Text: 编辑链接的显示文本。
- appendFilePath: 是否在编辑链接后添加文件路径。设置为
true
表示添加。
这些数据是控制页面显示的内容、样式和功能,为生成页面提供定制。