Skip to content

/deploy

Category: submission
Field: economics
License: MIT
Updated: 2026-04
Stages: dissemination

Deploy Slides to GitHub Pages

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

Steps

  1. Run the sync script:
  2. If $ARGUMENTS is provided (e.g., "Lecture4"): ./scripts/sync_to_docs.sh $ARGUMENTS

  3. If no argument: ./scripts/sync_to_docs.sh (syncs all lectures)

  4. Verify deployment:

  5. Check that HTML files exist in docs/slides/
  6. Check that _files/ directories were copied (RevealJS assets)

  7. Check that docs/Figures/ was synced from Figures/

  8. Verify interactive charts (if applicable):

  9. Grep rendered HTML for interactive widget count

  10. Confirm count matches expected

  11. Verify TikZ SVGs (if applicable):

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

  13. Open in browser for visual verification:

  14. open docs/slides/LectureX_Name.html # macOS
  15. # xdg-open docs/slides/LectureX_Name.html # Linux

  16. Confirm slides render, images display, navigation works

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