Render a PDF briefing

BNR info-hub Technical Manual

1 Render a PDF briefing

1.1 Purpose

This guide explains how to render a PDF briefing using Quarto and Typst.

The PDF briefing is separate from the HTML briefing because print layout and web layout have different needs.

1.2 Current pattern

Output File
HTML briefing site/surveillance/cvd/briefings/case-counts.qmd
PDF briefing source site/surveillance/cvd/briefings/case-counts-pdf.qmd
Rendered PDF generated under site/_site/ during Quarto render

1.3 Design rule

Stata-generated files are copied into:

site/downloads/files/

Quarto-generated PDFs are created by Quarto during render.

2 Stage 1: Check the PDF QMD

For the case-count pilot:

site/surveillance/cvd/briefings/case-counts-pdf.qmd
format:
  typst:
    output-file: bnr_cvd_cases_2023_v1.pdf
    toc: false
    number-sections: false

3 Stage 2: Render the PDF

cd C:\yoshimi-hot\output\analyse-bnr\info-hub\site
quarto render surveillance/cvd/briefings/case-counts-pdf.qmd --to typst

The rendered PDF should appear under _site.

Example:

site/_site/surveillance/cvd/briefings/bnr_cvd_cases_2023_v1.pdf

4 Stage 3: Link the PDF from the HTML page

For the HTML and PDF files in the same source folder, use:

[Download the PDF briefing](bnr_cvd_cases_2023_v1.pdf)

5 Stage 4: Common PDF problems

If Typst reports an unknown CSL style, the PDF QMD may be inheriting site-level bibliography settings.

For a briefing PDF with no references, use:

bibliography: []
citeproc: false
csl: apa

Check image paths from the PDF QMD location.

For QMD files in:

site/surveillance/cvd/briefings/

paths back to site downloads usually start with:

../../../downloads/files/
Back to top