主题

VuePress 主题提供了布局、样式和其他功能,有一个默认主题,同时可以尝试使用 社区主题 或者创建 本地主题。

社区主题

社区用户创建了很多主题,并将它们发布到了 NPM 上。

module.exports = {
  theme: 'foo',
}

你可以使用主题名称或者它的简称:

主题名称简称
vuepress-theme-foofoo
@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'),
}

接下来,前往 深入 > 开发主题 学习如何开发你自己的主题。