配置 Vite 及其扩展
运行环境: node
该文件中的代码将仅在 Node.js 环境中运行,您可以访问 Node 的 API。
Slidev 基于 Vite 实现。这意味着你可以利用 Vite 强大的插件系统来进一步定制你的幻灯片。
如果项目中存在 vite.config.ts
文件,将被自动读取,并将与 Slidev,你的主题和扩展插件提供的配置文件合并
配置内部插件
Slidev 已经内置了以下插件:
- @vitejs/plugin-vue
- unplugin-vue-components
- unplugin-icons
- vite-plugin-vue-markdown
- vite-plugin-remote-assets
- unocss/vite
如需对内置插件列表进行配置,先创建 vite.config.ts
,其内容如下。请注意,Slidev 对这些插件有些预设配置,如下做法会覆盖其中一些配置,可能会导致应用崩溃。请将此功能视为高级功能,在继续操作前,请确保了解配置的作用。
ts
import { defineConfig } from 'vite'
export default defineConfig({
slidev: {
vue: {
/* vue 的选项 */
},
markdown: {
/* markdown-it 的选项 */
markdownItSetup(md) {
/* 自定义的 markdown-it 插件 */
md.use(MyPlugin, /* ... */)
},
},
/* 其他插件的选项 */
},
})
了解更多:类型定义
WARNING
Slidev 中不可以重新添加已内置使用的插件。例如,以下配置将会导致错误:
ts
import { defineConfig } from 'vite'
import Vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [
Vue({
/* vue 的选项 */
})
],
})
请将Vue选项传递给 slidev.vue
字段,如上文所述。