deploy

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)

1. 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)

1. Verify interactive charts (if applicable):

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

1. Verify TikZ SVGs (if applicable):

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

1. 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

1. 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)