插件
借助于 插件 API , VuePress 插件可以为你提供各种不同的功能。
社区插件
module.exports = {
plugins: [
'foo',
['bar', { /* 配置项 */ }]
],
}
插件名称 | 简称 |
---|---|
vuepress-plugin-foo | foo |
@org/vuepress-plugin-bar | @org/bar |
@vuepress/plugin-foobar | @vuepress/foobar |
提示
大部分插件只能使用一次,如果同一个插件被多次使用,那么只有最后一次会生效。
然而,部分插件是可以被多次使用的(例如 @vuepress/plugin-container),你应该查看插件本身的文档来获取详细指引。
本地插件
推荐你直接将 配置文件 作为插件使用,因为 几乎所有的插件 API 都可以在配置文件中使用,这在绝大多数场景下都更为方便。
但是如果你在配置文件中要做的事情太多了,最好还是将它们提取到单独的插件中,然后通过设置绝对路径或者通过 require 来使用它们:
module.exports = {
plugins: [
path.resolve(__dirname, './path/to/your-plugin.js'),
require('./another-plugin'),
],
}
前往 深入 > 开发插件 学习如何开发你自己的插件。