mcpField
D
deploy

deploy

github.com/pedrohcgs云与 DevOps1.7k47 次安装5 周前更新
代码仓库

关于 deploy

deploy 是用于渲染 Quarto 幻灯片并准备 GitHub Pages 发布文件的技能。它运行同步脚本，并指导检查资源、图表、SVG 和渲染结果，最后汇报验证情况。

主要功能

  1. 01运行幻灯片同步脚本
  2. 02复制渲染后的幻灯片和资源
  3. 03同步图表与 R 脚本
  4. 04检查图表、SVG 和浏览器显示

适用场景

  1. 01将所有课程幻灯片发布到 GitHub Pages
  2. 02通过参数同步指定课程
  3. 03验证幻灯片资源和交互内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill deploy

安装后在 Claude Code 中输入/deploy确认已加载。

详细介绍

将幻灯片部署到 GitHub Pages

渲染 Quarto 幻灯片，并将所有文件同步到 docs/，以便部署到 GitHub Pages。

步骤

  1. 运行同步脚本：

    • 如果提供了 $ARGUMENTS（例如，“Lecture4”）：./scripts/sync_to_docs.sh $ARGUMENTS
    • 如果没有参数：./scripts/sync_to_docs.sh（同步所有课程）

  2. 验证部署：

    • 检查 docs/slides/ 中是否存在 HTML 文件
    • 检查是否已复制 _files/ 目录（RevealJS 资源）
    • 检查是否已将 Figures/ 同步到 docs/Figures/
    • 检查 docs/files/code/ 是否包含 R 脚本（如果 scripts/R/ 中有脚本）

  3. 验证交互式图表（如适用）：

    • 使用 grep 统计渲染后的 HTML 中交互式小部件的数量
    • 确认数量符合预期

  4. 验证 TikZ SVG（如适用）：

    • 检查 docs/Figures/LectureN/ 中是否存在所有引用的 SVG 文件

  5. 在浏览器中打开以进行视觉验证：

    • open docs/slides/LectureX_Name.html # macOS
    • # xdg-open docs/slides/LectureX_Name.html # Linux
    • 确认幻灯片已渲染、图像正常显示且导航功能正常

  6. 向用户报告结果

同步脚本的功能：

  • 渲染 Quarto/ 中的所有 .qmd 文件（跳过 *_backup* 文件）
  • 将 HTML 和 _files/ 目录复制到 docs/slides/
  • 将 Slides/ 中的 Beamer PDF 复制到 docs/slides/
  • 使用 rsync 将 Figures/ 同步到 docs/Figures/
  • 将每个 scripts/R/*.R 复制到 docs/files/code/（与幻灯片一同发布）

评论

支持 Markdown