Skip to content

Layout

您可以通过设置 layout 选项为页面 frontmatter 来选择页面布局。 有 3 个布局选项,doc, page, 和 home。 如果未指定任何内容,则该页面被视为文档页面。

yaml
---
layout: doc
---

Doc 布局

doc 是默认布局,它将整个 Markdown 内容样式化为“文档”外观。 它的工作原理是将整个内容包装在 vp-doc css 类中,并将样式应用于它下面的元素。

几乎所有通用元素,例如 ph2 都具有特殊样式。 因此,请记住,如果你在 Markdown 内容中添加任何自定义 HTML,这些元素也会受到这些样式的影响。

同时还提供下面列出的文档特定功能。这些功能仅在此布局中生效。

Page 布局

选项 page 被视为“空白页”。 Markdown 仍然会被解析,并且所有 Markdown Extensionsdoc 布局同样生效,但它不会获得任何默认样式。

页面布局可让您自行设计所有内容,而 VitePress 主题不会影响标签。 当您要创建自己的自定义页面时,这很有用。

注意,即使在此布局中,如果页面具有匹配的侧边栏配置,侧边栏仍会显示。

Home 布局

选项 home 将生成模板化的“主页”。 在此布局中,您可以设置额外的选项,例如herofeatures ,以进一步自定义内容。 请访问 主题:主页 了解更多详情。

No 布局

如果你不想要任何布局,你可以通过frontmatter传递 layout: false。如果您想要一个完全可定制的登录页面(默认情况下没有任何侧边栏、导航栏或页脚),这个选项很有用。

Powered by VitePress