Deploy
Render Quarto `.qmd` slides to HTML and sync to `docs/` for GitHub Pages.
Install
npx skills add pedrohcgs/claude-code-my-workflow --skill deploy -g -a claude-code -y- Repository
- pedrohcgs/claude-code-my-workflow1.7k
- Category
- Documents
- Updated
- 1mo ago
- License
- MIT
- Context cost
- Lightabout 367 tokens
- Runs scripts
- No, instructions only
What it does
Render Quarto `.qmd` slides to HTML and sync to `docs/` for GitHub Pages. Use when user says "deploy", "publish the slides", "ship to pages", "push the lecture live", "render and publish", or after Quarto edits that need to go public. NOT for local Quarto render only, use `quarto render` directly for that.
Deploy Slides to GitHub Pages
Render Quarto slides and sync all files to docs/ for GitHub Pages deployment.
Steps
-
Run the sync script:
- If
$ARGUMENTSis provided (e.g., "Lecture4"):./scripts/sync_to_docs.sh $ARGUMENTS - If no argument:
./scripts/sync_to_docs.sh(syncs all lectures)
- If
-
Verify deployment:
- Check that HTML files exist in
docs/slides/ - Check that
_files/directories were copied (RevealJS assets) - Check that
docs/Figures/was synced fromFigures/ - Check that
docs/files/code/contains the R scripts (ifscripts/R/has any)
- Check that HTML files exist in
-
Verify interactive charts (if applicable):
- Grep rendered HTML for interactive widget count
- Confirm count matches expected
-
Verify TikZ SVGs (if applicable):
- Check that all referenced SVG files exist in
docs/Figures/LectureN/
- Check that all referenced SVG files exist in
-
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
-
Report results to the user
What the sync script does:
- Renders all
.qmdfiles inQuarto/(skips*_backup*files) - Copies HTML and
_files/directories todocs/slides/ - Copies Beamer PDFs from
Slides/todocs/slides/ - Syncs
Figures/todocs/Figures/using rsync - Copies every
scripts/R/*.Rintodocs/files/code/(published beside the slides)


