Description
The Quarto demo notebooks under /documentation/tutorials/Demo_1_Basic_Run/ and /documentation/tutorials/Demo_02_Uncertainty_Analysis/ are rendered and deployed as HTML only via the render-quarto.yml GHA workflow.
However, because the notebooks are configured with both html and pdf formats, Quarto automatically adds a PDF link to the HTML sidebar. In the deployed documentation site, this link points to the root of the repo (e.g. /run_pecan.pdf) and is broken, since PDFs are neither rendered nor deployed by the CI pipeline.
Root Cause
The CI explicitly renders only HTML, PDFs are neither rendered nor copied as site assets, but Quarto still advertises them due to multi-format configuration in the .qmd files.
Probable Solution
Disable Quarto’s automatic download links for HTML output in the affected notebooks, for example:
format:
html:
downloads: false
pdf: defaultThis keeps local PDF rendering intact while preventing broken links in the deployed documentation.
Correct me if I am wrong.
Description
The Quarto demo notebooks under
/documentation/tutorials/Demo_1_Basic_Run/and/documentation/tutorials/Demo_02_Uncertainty_Analysis/are rendered and deployed as HTML only via therender-quarto.ymlGHA workflow.However, because the notebooks are configured with both html and pdf formats, Quarto automatically adds a PDF link to the HTML sidebar. In the deployed documentation site, this link points to the root of the repo (e.g.
/run_pecan.pdf) and is broken, since PDFs are neither rendered nor deployed by the CI pipeline.Root Cause
The CI explicitly renders only HTML, PDFs are neither rendered nor copied as site assets, but Quarto still advertises them due to multi-format configuration in the
.qmdfiles.Probable Solution
Disable Quarto’s automatic download links for HTML output in the affected notebooks, for example:
This keeps local PDF rendering intact while preventing broken links in the deployed documentation.
Correct me if I am wrong.