Skip to content

/deploy

Category: submission
Field: economics
License: MIT
Updated: 2026-08-22
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. Check that docs/files/code/ contains the R scripts (if scripts/R/ has any)

  9. Verify interactive charts (if applicable):

  10. Grep rendered HTML for interactive widget count

  11. Confirm count matches expected

  12. Verify TikZ SVGs (if applicable):

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

  14. Open in browser for visual verification:

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

  17. Confirm slides render, images display, navigation works

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