Skip to content

配置 Vite 及其扩展

运行环境: node
该文件中的代码将仅在 Node.js 环境中运行,您可以访问 Node 的 API。

Slidev 基于 Vite 实现。这意味着你可以利用 Vite 强大的插件系统来进一步定制你的幻灯片。

如果项目中存在 vite.config.ts 文件,将被自动读取,并将与 Slidev,你的主题和扩展插件提供的配置文件合并

配置内部插件

Slidev 已经内置了以下插件:

如需对内置插件列表进行配置,先创建 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 字段,如上文所述。

Released under the MIT License.