mcpField
D
deploy

deploy

github.com/pedrohcgsCloud & DevOps1.7k47 installsUpdated 5w ago
Repository

About deploy

deploy is a skill for rendering Quarto slides and preparing their files for GitHub Pages. It runs a sync script and guides checks for assets, charts, SVGs, and rendered slides before reporting results.

Key features

  1. 01Run the slide sync script
  2. 02Copy rendered slides and assets
  3. 03Sync figures and R scripts
  4. 04Check charts, SVGs, and browser rendering

Use cases

  1. 01Publish all lecture slides to GitHub Pages
  2. 02Sync a selected lecture using an argument
  3. 03Verify slide assets and interactive content

Install

Copy the command and run it in a terminal.

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

After installing, type/deployin Claude Code to confirm it loaded.

Details

From the project README

Deploy Slides to GitHub Pages

Render Quarto slides and sync all files to docs/ for GitHub Pages deployment.

Steps

  1. Run the sync script:

    • If $ARGUMENTS is provided (e.g., "Lecture4"): ./scripts/sync_to_docs.sh $ARGUMENTS
    • If no argument: ./scripts/sync_to_docs.sh (syncs all lectures)

  2. Verify deployment:

    • Check that HTML files exist in docs/slides/
    • Check that _files/ directories were copied (RevealJS assets)
    • Check that docs/Figures/ was synced from Figures/
    • Check that docs/files/code/ contains the R scripts (if scripts/R/ has any)

  3. Verify interactive charts (if applicable):

    • Grep rendered HTML for interactive widget count
    • Confirm count matches expected

  4. Verify TikZ SVGs (if applicable):

    • Check that all referenced SVG files exist in docs/Figures/LectureN/

  5. Open in browser for visual verification:

    • open docs/slides/LectureX_Name.html # macOS
    • # xdg-open docs/slides/LectureX_Name.html # Linux
    • Confirm slides render, images display, navigation works

  6. Report results to the user

What the sync script does:

  • Renders all .qmd files in Quarto/ (skips *_backup* files)
  • Copies HTML and _files/ directories to docs/slides/
  • Copies Beamer PDFs from Slides/ to docs/slides/
  • Syncs Figures/ to docs/Figures/ using rsync
  • Copies every scripts/R/*.R into docs/files/code/ (published beside the slides)

Comments

Markdown supported