Render or preview the site

BNR info-hub Technical Manual

1 Render or preview the site

1.1 Purpose

This guide explains how to preview and render the BNR info-hub Quarto website.

Use preview while editing. Use render when checking the full site before committing or publishing.

1.2 Important folder rule

Run Quarto commands from the site/ folder:

C:\yoshimi-hot\output\analyse-bnr\info-hub\site

2 Stage 1: Preview the site

cd C:\yoshimi-hot\output\analyse-bnr\info-hub\site
quarto preview --port 4200

Stop preview with:

Ctrl + C

Then restart:

quarto preview --port 4200

3 Stage 2: Render the full site

quarto render

Quarto writes the rendered site to:

site/_site/

This folder is generated and ignored by Git.

Do not manually edit files in _site/.

4 Stage 3: Render one page only

quarto render surveillance/cvd/briefings/case-counts.qmd
quarto render surveillance/cvd/briefings/case-counts-pdf.qmd --to typst

5 Stage 4: Common checks

Check:

  • top navigation works
  • briefing pages render
  • figures appear
  • download links work
  • release catalogue links work
  • PDF link works
  • no private paths appear
  • no confidential data appear
Back to top