VuePress 生态系统VuePress 生态系统
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • 主题指南
  • 默认主题
    • 配置
    • 插件配置
    • 语言配置
    • Frontmatter
    • 内置组件
    • Markdown
    • 样式
    • 继承
  • Hope 主题
  • Plume 主题
  • Reco 主题

Frontmatter

@vuepress/theme-default

所有页面

本章节中的 Frontmatter 会在所有类型的页面中生效。

externalLinkIcon

  • 类型: boolean

  • 详情:

    是否在外部链接上显示外部链接图标。

  • 参考:

    • 默认主题 > 配置 > externalLinkIcon

navbar

  • 类型: boolean

  • 详情:

    是否在当前页面展示导航栏。

    如果你在主题配置中禁用了导航栏,那么该 Frontmatter 将不会生效。

  • 参考:

    • 默认主题 > 配置 > navbar

pageClass

  • 类型: string

  • 详情:

    为当前页面添加额外的类名。

  • 示例:

---
pageClass: custom-page-class
---

然后你可以在 .vuepress/styles/index.scss 文件中为这个页面添加自定义样式:

[vp-container].custom-page-class {
  /* 页面样式 */
}
  • 参考:
    • 默认主题 > 样式 > Style 文件

首页

本章节中的 Frontmatter 只会在首页中生效。

home

  • 类型: boolean

  • 详情:

    设定该页面是首页还是普通页面。

    如果你不设置该 Frontmatter 或将其设为 false ,则该页面会是一个 普通页面

  • 示例:

    ---
    home: true
    ---

heroImage

  • 类型: string

  • 详情:

    首页图片的 URL 。

  • 示例:

    ---
    # Public 文件路径
    heroImage: /images/hero.png
    # URL
    heroImage: https://vuepress.vuejs.org/images/hero.png
    ---
  • 参考:

    • 指南 > 静态资源 > Public 文件

heroImageDark

  • 类型: string

  • 详情:

    在夜间模式中使用的首页图片的 URL 。

    如果你想在夜间模式中使用不同的首页图片,就可以使用该配置项。

  • 参考:

    • 默认主题 > Frontmatter > heroImage
    • 默认主题 > 配置 > colorMode

heroAlt

  • 类型: string

  • 详情:

    首页图片的 alt 属性。

    如果不设置,则默认使用 heroText 。

heroHeight

  • 类型: number

  • 默认值: 280

  • 详情:

    首页图片 <img> 标签的 height 属性。

    当你的首页图片高度小于默认值时,你可能需要减小该属性。

    需要注意的是,首页图片的高度同样受到了 CSS 的约束。设置这个属性主要是为了减少由加载首页图片引起的 累积布局偏移 (CLS) 。

heroText

  • 类型: string | null

  • 详情:

    首页的大标题。

    如果不设置,则默认使用站点 title 。

    设置为 null 来禁用首页大标题。

tagline

  • 类型: string | null

  • 详情:

    首页的标语。

    如果不设置,则默认使用站点 description 。

    设置为 null 来禁用首页标语。

actions

  • 类型:
Array<{
  text: string
  link: string
  type?: 'primary' | 'secondary'
}>
  • 详情:

    配置首页按钮。

  • 示例:

---
actions:
  - text: 快速上手
    link: /zh/guide/getting-started.html
    type: primary
  - text: 项目简介
    link: /zh/guide/introduction.html
    type: secondary
---

features

  • 类型:
Array<{
  title: string
  details: string
}>
  • 详情:

    配置首页特性列表。

  • 示例:

---
features:
  - title: 简洁至上
    details: 以 Markdown 为中心的项目结构,以最少的配置帮助你专注于写作。
  - title: Vue 驱动
    details: 享受 Vue 的开发体验,可以在 Markdown 中使用 Vue 组件,又可以使用 Vue 来开发自定义主题。
  - title: 高性能
    details: VuePress 会为每个页面预渲染生成静态的 HTML,同时,每个页面被加载的时候,将作为 SPA 运行。
---

footer

  • 类型: string

  • 详情:

    首页的页脚。

footerHtml

  • 类型: boolean

  • 详情:

    是否允许页脚中使用 HTML 。

    如果设置为 true ,那么 footer 会被作为 HTML 代码处理。

普通页面

本章节中的 Frontmatter 只会在普通页面中生效。

editLink

  • 类型: boolean

  • 详情:

    是否在本页面中启用 编辑此页 链接。

  • 参考:

    • 默认主题 > 配置 > editLink

editLinkPattern

  • 类型: string

  • 详情:

    本页面中 编辑此页 链接的 Pattern 。

  • 参考:

    • 默认主题 > 配置 > editLinkPattern

lastUpdated

  • 类型: boolean

  • 详情:

    是否在本页面中启用 最近更新时间戳 。

  • 参考:

    • 默认主题 > 配置 > lastUpdated

contributors

  • 类型: boolean

  • 详情:

    是否在本页面中启用 贡献者列表 。

  • 参考:

    • 默认主题 > 配置 > contributors

sidebar

  • 类型: false | SidebarOptions

  • 详情:

    配置本页面的侧边栏。

  • 参考:

    • 默认主题 > 配置 > sidebar

sidebarDepth

  • 类型: number

  • 详情:

    配置本页面的侧边栏深度。

  • 参考:

    • 默认主题 > 配置 > sidebarDepth

prev

  • 类型: AutoLinkConfig | string | false

  • 详情:

    上一个页面的链接。

    如果你不设置该 Frontmatter ,该链接会自动根据侧边栏配置进行推断。

    为了手动配置上一页面的链接,你可以将其设置为一个 AutoLinkConfig 对象或者一个字符串:

    • AutoLinkConfig 对象应该有一个 text 字段和一个 link 字段。
    • 字符串应为目标页面文件的路径。它将会被转换为 AutoLinkConfig 对象,将页面标题作为 text ,将页面路由路径作为 link 。
    • 如果你不想显示上一个页面的链接,可以将其设置为 false 。
  • 示例:

---
# AutoLinkConfig
prev:
  text: Get Started
  link: /guide/getting-started.html

# AutoLinkConfig - 外部 URL
prev:
  text: GitHub
  link: https://github.com

# 字符串 - 页面文件路径
prev: /guide/getting-started.md

# 字符串 - 页面文件相对路径
prev: ../../guide/getting-started.md
---

next

  • 类型: AutoLinkConfig | string | false

  • 详情:

    下一个页面的链接。

    如果你不设置该 Frontmatter ,该链接会自动根据侧边栏配置进行推断。

    类型和 prev Frontmatter 相同。

在 GitHub 上编辑此页
上次更新: 2025/4/12 18:23
贡献者: Mister-Hope, 张怀文
Prev
语言配置
Next
内置组件