前置数据 (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 表示添加。

这些数据是控制页面显示的内容、样式和功能,为生成页面提供定制。