github-starred/cs249r_book
2
0
Fork 0
mirror of https://github.com/harvard-edge/cs249r_book.git synced 2026-05-06 09:38:33 -05:00
Code Issues 85 Packages Projects Releases 24 Wiki Activity

Support dynamic generation of Quarto HTML, PDF, and EPUB with shared configuration #417

New Issue
Open
opened 2026-03-22 15:39:05 -05:00 by GiteaMirror · 0 comments
GiteaMirror commented 2026-03-22 15:39:05 -05:00
Owner
Copy Link

Originally created by @profvjreddi on GitHub (Aug 12, 2025).

Currently, there is significant code duplication across files to enable generation of Quarto outputs (_quarto-html, -pdf, -epub). To improve maintainability and reduce duplication, we should refactor the setup to use shared/common YAML configuration files and reusable code. This will allow dynamic generation of Quarto files (HTML, PDF, EPUB) as needed, without manual copy-pasting or redundant configuration.

Proposal:

  • Identify duplicated code and configuration across the existing output files.
  • Design a set of shared YAML files and supporting scripts to centralize configuration.
  • Refactor the build process so that output types (HTML, PDF, EPUB) are generated dynamically from common sources.
  • Document the updated workflow for future contributors.

Benefits:

  • Easier maintenance and updates
  • Reduced risk of inconsistencies
  • Streamlined workflow for generating multiple output formats

This change will make the Quarto book workflow more robust and easier for contributors to work with.

Originally created by @profvjreddi on GitHub (Aug 12, 2025). Currently, there is significant code duplication across files to enable generation of Quarto outputs (_quarto-html, -pdf, -epub). To improve maintainability and reduce duplication, we should refactor the setup to use shared/common YAML configuration files and reusable code. This will allow dynamic generation of Quarto files (HTML, PDF, EPUB) as needed, without manual copy-pasting or redundant configuration. Proposal: - Identify duplicated code and configuration across the existing output files. - Design a set of shared YAML files and supporting scripts to centralize configuration. - Refactor the build process so that output types (HTML, PDF, EPUB) are generated dynamically from common sources. - Document the updated workflow for future contributors. Benefits: - Easier maintenance and updates - Reduced risk of inconsistencies - Streamlined workflow for generating multiple output formats This change will make the Quarto book workflow more robust and easier for contributors to work with.
GiteaMirror added the area: tools label 2026-03-22 15:39:05 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area: book
area: collabs
area: kits
area: socratiq
area: tinytorch
area: tools
area: website
bug
dependencies
format: epub
format: pdf
link-health
link-rot
priority-high
pull-request
Mirrored from GitHub Pull Request
 staffml
type: bug
type: citation
type: code
type: errata
type: improvement
type: new
type: question
vault-sli
No Label area: tools
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/cs249r_book#417
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?