进阶 sli.dev 2026-11-21 18:58:32 · 1 阅读
第19章 Slidev 目录结构
目录结构
Slidev 采用了一些目录结构约定,以尽量减少配置工作,并让功能扩展更加灵活直观。
约定的目录结构如下:
bash
your-slidev/
├── components/ # 自定义组件
├── layouts/ # 自定义布局
├── public/ # 静态资源
├── setup/ # 自定义配置 / 钩子
├── snippets/ # 代码片段
├── styles/ # 自定义样式
├── index.html # 对 index.html 的注入
├── slides.md # 幻灯片主入口
└── vite.config.ts # 扩展 vite 配置
以上所有内容都是可选的。
组件
匹配模式:./components/*.{vue,js,ts,jsx,tsx,md}
📖 Components
布局
匹配模式:./layouts/*.{vue,js,ts,jsx,tsx}
📖 Layouts
Public
匹配模式:./public/*
该目录下的资源在开发时会在根路径 / 下提供服务,并在构建时原样复制到 dist 目录的根目录。了解更多关于资源处理的内容。
样式
匹配模式:./style.css | ./styles/index.{css,js,ts}
符合该约定的文件会被注入到 App 根节点。如果需要引入多个 CSS 入口,可以按以下结构组织,并自行管理引入顺序。
WARNING
这里的全局 CSS 也会作用于演示者界面。建议将样式限定在单个幻灯片内,或者把选择器包裹在 .slidev-layout 下,避免样式泄漏到演示者模式。
例如:用 .slidev-layout .grid { ... } 而不是 .grid { ... }。
bash
your-slidev/
├── ...
└── styles/
├── index.ts
├── base.css
├── code.css
└── layouts.css
ts
// styles/index.ts
import './base.css'
import './code.css'
import './layouts.css'
样式会经过 UnoCSS 和 PostCSS 处理,因此你可以开箱即用地使用 CSS 嵌套和 at 指令。例如:
css
.slidev-layout {
--uno: px-14 py-10 text-[1.1rem];
h1, h2, h3, h4, p, div {
--uno: select-none;
}
pre, code {
--uno: select-text;
}
a {
color: theme('colors.primary');
}
}
点击这里了解更多关于该语法的细节。
index.html
匹配模式:index.html
通过 index.html 可以向主 index.html 注入 meta 标签和/或脚本。
例如下面这个自定义的 index.html:
index.html
html
最终生成的 index.html 会是:
html
Global Layers 模式:global-top.vue | global-bottom.vue | custom-nav-controls.vue | slide-top.vue | slide-bottom.vue✨ Global Layers