进阶 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

评论 (0)