第21章 配置 Vite 与插件
配置 Vite 和插件
环境:node
此配置函数只在 Node.js 环境下运行,因此可以访问 Node 的 API。
Slidev 底层由 Vite 驱动,这意味着你可以借助 Vite 强大的插件系统进一步自定义幻灯片。如果你已有 vite.config.ts,Slidev 会将它与自身、主题及 addons 提供的 Vite 配置合并。
配置内部插件
Slidev 内部向 Vite 添加了以下插件:
- @vitejs/plugin-vue - unplugin-vue-components - unplugin-icons - vite-plugin-vue-markdown - vite-plugin-remote-assets - unocss/vite
要配置上述内置插件,请创建一个内容如下的 vite.config.ts。注意 Slidev 对这些插件有默认配置,这种用法会覆盖其中部分配置,可能导致应用出问题。请将此视为高级功能,在继续之前确保你清楚自己在做什么。
vite.config.ts
```ts import { defineConfig } from 'vite'
export default defineConfig({ slidev: { vue: { /* vue options */ }, markdown: { /* markdown-exit options */ markdownSetup(md) { /* custom markdown-exit plugins */ md.use(MyPlugin) }, }, /* options for other plugins */ }, }) ```
更多选项请参阅类型声明。
WARNING
不允许重复添加 Slidev 内部已使用的插件。例如,不要这样写:
```ts import Vue from '@vitejs/plugin-vue' import { defineConfig } from 'vite'
export default defineConfig({ plugins: [ Vue({ /* vue options */ }) ], }) ```
而应按照上文所述,把 Vue 的选项传给 slidev.vue 字段。
根据幻灯片数据添加自定义插件
通常你可以直接在 vite.config.ts 中添加 Vite 插件(见上文)。但如果需要根据幻灯片数据来添加插件,则需创建一个内容如下的 ./setup/vite-plugins.ts:
```ts import { defineVitePluginsSetup } from '@slidev/types'
export default defineVitePluginsSetup((options) => { return [ // Your plugins here // Slide data is available as options.data.slides ] }) ```