布局
您可以通过将layout
选项设置为页面frontmatter
来选择页面布局。这有3种layout
选项,doc
、page
、和 home
。如果未指定任何内容,则将该页视为doc
页。
yaml
---
layout: doc
---
文档布局
选项doc
是默认布局,它将整个Markdown
内容设置为 “文档” 外观。它的工作原理是将整个内容包装在vp-doc
的css类中,并将样式应用于其下的元素。 几乎所有泛型元素(如p
或h2
)都有特殊的样式。因此,请记住,如果在Markdown
内容中添加任何自定义HTML
,这些HTML
也会受到这些样式的影响。 它还提供以下列出的文档特定功能。这些功能仅在此布局中启用。
- Edit Link
- Prev Next Link
- Outline
- Carbon Ads
页面布局
选项page
被视为“空白页”。Markdown
仍然会被解析,所有Markdown
扩展的工作方式与doc
布局相同,但它不会得到任何默认样式。
页面布局将允许您自行设置所有内容的样式,而VitePress
主题不会影响标记。当您想要创建自己的自定义页面时,这非常有用。
注意,即使在这种布局中,如果页面具有匹配的侧边栏配置,侧边栏仍然会显示。
yaml
---
layout: page
---
主页布局
选项home
将生成模板化的“主页”。在此布局中,您可以设置hero
和features
等额外选项,以进一步自定义内容。请访问“主题:主页”了解更多详情。
yaml
---
layout: home
---
无布局
如果不需要任何布局,可以通过frontmatter
传递layout:false
。如果您想要完全自定义的登录页面(默认情况下没有任何侧边栏、导航栏或页脚),此选项很有用。
yaml
---
layout: false
---