主题
VuePress 主题提供了布局、样式和其他功能,有一个默认主题,同时可以尝试使用 社区主题 或者创建 本地主题。
社区主题
社区用户创建了很多主题,并将它们发布到了 NPM 上。
module.exports = {
theme: 'foo',
}
你可以使用主题名称或者它的简称:
主题名称 | 简称 |
---|---|
vuepress-theme-foo | foo |
@org/vuepress-theme-bar | @org/bar |
@vuepress/theme-default | @vuepress/default |
本地主题
首先,创建本地主题目录,一般是 .vuepress/theme
:
└─ docs
├─ .vuepress
│ ├─ theme
│ │ └─ index.js
│ └─ config.js
└─ README.md
然后,将 theme 配置项设置为 主题入口 的绝对路径来使用它:
module.exports = {
theme: path.resolve(__dirname, './path/to/docs/.vuepress/theme/index.js'),
}
接下来,前往 深入 > 开发主题 学习如何开发你自己的主题。