自动生成front matter

当你没有给.md文件的front matter指定标题(title)、时间(date)、永久链接(permalink)、分类(categories)、标签(tags)、主题配置中extendFrontmatter配置的字段时，在运行开发服务npm run dev或打包npm run build时将自动为你生成这些数据，你也可以自己手动设置这些数据，当你手动设置之后，相应的数据就不会再自动生成。

生成示例

  1. ---
  2. title: 《JavaScript教程》笔记
  3. date: 2020-01-12 11:51:53
  4. permalink: /pages/d8cae9
  5. categories:
  6.   - 前端
  7.   - JavaScript
  8. tags:
  9.   -
  10. ---

title

  • 类型: string

  • 默认值：.md文件的名称

当前页面的标题

date

  • 类型: string
  • 格式：YYYY-MM-DD HH:MM:SS
  • 默认值：.md文件在系统中创建的时间

当前页面的创建时间，如需手动添加或修改该字段时请按照格式添加或修改

permalink

  • 类型: string
  • 默认值：/pages/+ 6位字母加数字的随机码

当前页面的永久链接

Q：自动生成front matter为什么要包含永久链接？

A：使用永久链接是出于以下几点考虑:

  • 在config.js配置nav时使用永久链接，就不会因为文件的路径或名称的改变而改变。
  • 对于博客而言，当别人收藏了你的文章，在未来的时间里都可以通过永久链接来访问到。
  • 主题中的目录页需要通过永久链接来访问文章。

categories

  • 类型: array
  • 默认值：
    • .md所在的文件夹名称。
    • 如果.md文件所在的目录是三级目录，则会有两个分类值，分别是二级目录和一级目录的文件夹名称。如果在四级目录，则再多一个三级目录的文件夹名称分类。（级别说明）
    • 如果.md文件所在的目录是_posts，则默认值是随笔，这个默认值可以在config.js中修改，参考：config.js配置
  • 如果在 config.js配置 设置了category: false 将不会自动生成该字段

当前页面的分类

tags

  • 类型: array
  • 默认值：空数组
  • 如果在 config.js配置 设置了tag: false 将不会自动生成该字段

当前页面的标签，默认值是空数组，自动生成该字段只是为了方便后面添加标签值。

扩展自动生成front matter

当在主题配置中配置了extendFrontmatter时，将在自动生成front matter时添加相应配置的字段和数据。详见：extendFrontmatter