SuperAPI AI 工具集

deploy

部署与运维

查看项目

更新于 10-16 03:17

技能介绍

用途:把 Quarto 幻灯片渲染成 HTML,并将相关文件同步到 docs/ 目录,用于 GitHub Pages 部署。

主要能力:运行同步脚本 ./scripts/sync_to_docs.sh;若提供参数(如 Lecture4)则只同步该讲,无参数则同步全部讲座。脚本会渲染 Quarto/ 下所有 .qmd 文件(跳过 _backup 文件),把 HTML 与 _files/ 目录复制到 docs/slides/,把 Slides/ 中的 Beamer PDF 复制到 docs/slides/,用 rsync 将 Figures/ 同步到 docs/Figures/,并把 scripts/R/*.R 复制到 docs/files/code/。

使用方式:先执行同步脚本,再检查 docs/slides/ 中是否存在 HTML 文件、_files/ 目录是否已复制(RevealJS 资源)、docs/Figures/ 是否同步、docs/files/code/ 是否包含 R 脚本;如适用,可检查渲染后 HTML 中的交互式组件数量是否与预期一致,以及 docs/Figures/LectureN/ 中引用的 TikZ SVG 是否齐全。最后可在浏览器打开 docs/slides/LectureX_Name.html(macOS 用 open,Linux 用 xdg-open)确认渲染、图片与导航正常,并向用户报告结果。

适用场景:需要把 Quarto 讲座幻灯片发布到 GitHub Pages 时。

限制:资料未提供脚本内部实现细节、依赖安装方式、错误处理与平台兼容性说明;交互式图表与 TikZ SVG 的验证仅在适用时进行。