Skip to content

Broken PDF link in rendered quarto demo notebooks #3737

@S1DDHEY

Description

@S1DDHEY

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: default

This keeps local PDF rendering intact while preventing broken links in the deployed documentation.
Correct me if I am wrong.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions