Frontmatter

lang

  • 类型： string

  • 详情：

    页面的语言。

    它将会覆盖站点配置中的 lang 配置项

  • 参考：

title

  • 类型： string

  • 详情：

    页面的标题。

    如果你不在 Frontmatter 中设置 title ，那么页面中第一个一级标题（即 # title）的内容会被当作标题使用。

description

  • 类型： string

  • 详情：

    页面的描述。

    它将会覆盖站点配置中的 description 配置项

  • 参考：

head

  • 类型： HeadConfig[]

  • 详情：

    页面 <head> 标签内添加的额外标签。

  • 示例：

  1. ---
  2. head:
  3.   - - meta
  4.     - name: foo
  5.       content: bar
  6.   - - link
  7.     - rel: canonical
  8.       href: foobar
  9. ---

渲染为：

  1. <head>
  2.   <meta name="foo" content="bar" />
  3.   <link rel="canonical" href="foobar" />
  4. </head>

date

permalink

permalinkPattern

  • 类型： string

  • 详情：

    为页面生成永久链接的 Pattern 。

    如果 Frontmatter 中设置了 permalink ，那么这个字段则不会生效。

  • 使用：

    Pattern描述
    :year创建日期的 年 部分
    :month创建日期的 月 部分
    :day创建日期的 日 部分
    :slug页面文件名的 Slug
    :raw原始路由路径

    :year, :month 和 :day Pattern 根据如下优先级进行解析：

    • Frontmatter 中的 date 字段。
    • 符合 yyyy-MM-dd-foobar.md 或 yyyy-MM-foobar.md 日期格式的文件名。
    • 符合 yyyy/MM/dd/foobar.md 或 yyyy/MM/foobar.md 日期格式的目录名。
    • 默认值 0000-00-00 。

  • 示例 1 ：

    页面文件名是 foo-bar.md 。

    页面 Frontmatter 是：

  1. ---
  2. date: 2021-01-03
  3. permalinkPattern: :year/:month/:day/:slug.html
  4. ---

那么页面的永久链接将会是 2021/01/03/foo-bar.html 。

  • 示例 2 ：

    页面文件名是 2021-01-03-bar-baz.md。

    页面 Frontmatter 是：

  1. ---
  2. permalinkPattern: :year/:month/:day/:slug.html
  3. ---

那么页面的永久链接将会是 2021/01/03/bar-baz.html 。

layout

  • 类型： string

  • 详情：

    页面的布局。

    布局是由主题提供的。如果你不指定该 Frontmatter ，则会使用默认布局。你应该参考主题自身的文档来了解其提供了哪些布局。

    如果主题布局无法满足你的需求，你可以使用自定义布局组件。

  • 示例：

在 .vuepress/clientAppEnhance.ts 文件中注册一个布局组件：

  1. import { defineClientAppEnhance } from '@vuepress/client'
  2. import CustomLayout from './CustomLayout.vue'
  4. export default defineClientAppEnhance(({ app }) => {
  5.   app.component('CustomLayout', CustomLayout)
  6. })

在 Frontmatter 中设置自定义布局：

  1. ---
  2. layout: CustomLayout
  3. ---

externalIcon