用途
slidev-deployment 用于将 Slidev 演示文稿部署为静态网站,使其可以通过网址在线访问。资料中列出的适用场景包括:通过 URL 分享演示、为会议或活动托管、创建永久演示归档、为演示设置 CI/CD,以及将演示嵌入网站。
主要能力
该技能覆盖构建与部署两部分。构建方面,使用 npx slidev build 或 npm run build,会在 dist/ 目录生成 index.html、JavaScript 打包文件、CSS 文件和资源文件。构建选项包括:--out 自定义输出目录、--base 设置基础路径(用于子目录)、--download 启用 PDF 下载、--without-notes 排除演讲者备注。
部署方面涵盖以下平台与方式:
- GitHub Pages:可用 GitHub Actions(推荐,需在 Settings → Pages 中将 Source 设为 GitHub Actions,并提供 deploy.yml 工作流),或用 gh-pages 分支方式(安装 gh-pages,添加 deploy 脚本后运行 npm run deploy)。
- Netlify:可通过 Netlify 界面配置(构建命令 npm run build,发布目录 dist),或使用 netlify.toml 文件配置构建、NODE_VERSION 与 redirects。
- Vercel:可用 Vercel CLI(npm install -g vercel 后运行 vercel),或通过 vercel.json 配置 buildCommand、outputDirectory、framework 与 rewrites;也可在 Vercel 面板导入项目并连接 GitHub 仓库自动部署。
- Cloudflare Pages:连接仓库,配置构建命令 npm run build、输出目录 dist;可选 wrangler.toml。
- Docker:提供 Dockerfile(基于 node:20-alpine 构建,再用 nginx:alpine 提供静态服务)、nginx.conf、构建运行命令以及 Docker Compose 配置。
- 自托管静态服务器:可用 serve、http-server 或 Python 的 http.server 提供 dist 目录。
此外还涵盖:基础路径配置(子目录用 --base /slides/,根路径用 --base /,也可在 frontmatter 中设置 base)、自定义域名与 DNS 配置、SSL/HTTPS(多数平台自动提供)、环境变量(通过 .env 中 VITE_ 前缀变量并用 import.meta.env 访问,或在平台面板设置)、CI/CD 工作流示例(含构建、导出 PDF、上传产物与部署步骤),以及部署排错与最佳实践。
使用方式
典型流程为:先执行构建命令生成 dist 产物,再按目标平台选择对应的配置或工作流完成部署。构建时可按需设置 base 路径与构建选项。部署完成后,资料建议按输出格式记录:平台、构建命令、配置文件、部署 URL 与检查清单。
适用场景
适合需要在线分享或长期托管 Slidev 演示的开发者,尤其是使用 GitHub Pages、Netlify、Vercel、Cloudflare Pages 或 Docker 自建托管的场景,以及希望用 CI/CD 自动化部署演示的团队。
限制与注意事项
资料中的安全注意事项指出:可用 --without-notes 在构建版本中移除演讲者备注;私密演示可借助 Netlify Identity 或密码保护、Vercel Authentication,或在服务器配置中加基础认证;构建后的演示默认不包含远程控制。排错方面提到构建失败需检查 Node 版本(≥18)、清理 node_modules、检查语法错误;资源无法加载需核对 base 路径与资源路径;字体缺失需使用网络字体并检查样式中的字体加载;部署后空白页需检查浏览器控制台、SPA 路由配置与 base 路径是否匹配。
暂未提供
资料未说明该技能的收费、价格、具体平台免费额度或效果数据。