[GH-ISSUE #953] Move publish scripts out of quarto/ into tools/scripts directory and update workflows #1644

New Issue

GiteaMirror · 2026-04-11T07:59:57-05:00

GiteaMirror commented

2026-04-11 07:59:57 -05:00

Originally created by @profvjreddi on GitHub (Aug 25, 2025).
Original GitHub issue: https://github.com/harvard-edge/cs249r_book/issues/953

Move the post-build publish and compression scripts out of the quarto/ directory and into tools/scripts/publish/ or another appropriate location, as illustrated in the attached diagram.

Tasks:

Move publish/compression scripts (such as compress_epub.py, compress_pdf.py, render_compress_publish.py, publish.sh, and modify_dev_announcement.py) from quarto/scripts/ to tools/scripts/publish/.
Update any workflows, Dockerfiles (especially the Windows container), and references so files are copied correctly to the new location.
Ensure all script paths are updated to use ../../-style relative paths, maintaining compatibility (do not switch to github.workspace).
Test that the compression scripts and publishing workflow continue to function as expected after these changes.

This will provide clear separation between Quarto build tools (which stay in quarto/) and external workflow tools (which live in the project tools directory), as shown below:

See attached image for reference structure. Please make sure all path and workflow updates are handled carefully to avoid CI breakage.

Originally created by @profvjreddi on GitHub (Aug 25, 2025). Original GitHub issue: https://github.com/harvard-edge/cs249r_book/issues/953 Move the post-build publish and compression scripts out of the `quarto/` directory and into `tools/scripts/publish/` or another appropriate location, as illustrated in the attached diagram. **Tasks:** - Move publish/compression scripts (such as `compress_epub.py`, `compress_pdf.py`, `render_compress_publish.py`, `publish.sh`, and `modify_dev_announcement.py`) from `quarto/scripts/` to `tools/scripts/publish/`. - Update any workflows, Dockerfiles (especially the Windows container), and references so files are copied correctly to the new location. - Ensure all script paths are updated to use `../../`-style relative paths, maintaining compatibility (do not switch to `github.workspace`). - Test that the compression scripts and publishing workflow continue to function as expected after these changes. This will provide clear separation between Quarto build tools (which stay in `quarto/`) and external workflow tools (which live in the project tools directory), as shown below: <img alt="image2" width="1164" src="https://github.com/user-attachments/assets/cc40051b-11e7-46ae-af6c-598f284e1fdb" /> --- See attached image for reference structure. Please make sure all path and workflow updates are handled carefully to avoid CI breakage.

GiteaMirror added the area: tools label 2026-04-11 07:59:57 -05:00

GiteaMirror closed this issue

2026-04-11 07:59:59 -05:00

GiteaMirror commented

2026-04-11 07:59:59 -05:00

@profvjreddi commented on GitHub (Oct 19, 2025):

📊 Status Update: Partially completed.

✅ Moved to tools/scripts/publish/:

modify_dev_announcement.py
publish.sh
render_compress_publish.py

❌ Still in quarto/publish/:

compress_epub.py
compress_pdf.py

📝 Related commits: 1a6dfdb52, 5a447f045

Remaining work: Move compression scripts and update workflow references.

@profvjreddi commented on GitHub (Oct 19, 2025): 📊 Status Update: Partially completed. ✅ **Moved to tools/scripts/publish/:** - modify_dev_announcement.py - publish.sh - render_compress_publish.py ❌ **Still in quarto/publish/:** - compress_epub.py - compress_pdf.py 📝 Related commits: 1a6dfdb52, 5a447f045 Remaining work: Move compression scripts and update workflow references.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/cs249r_book#1644