Markdown naar PDF

Dit werktraject maakt van één Markdownbestand (tekst, VSA-blokken, includes, paginascheidingen) een A4-PDF. Gebruik dit voor demo’s en losse bladen buiten de oefenhoek-bibliotheek. Voor liturgische tekst in de bibliotheek: werktraject Tekstblad ({stam}.tekstblad.md → {stam}.tekstblad.pdf).

Waartoe

Je wilt een printbaar blad (bijvoorbeeld een demo of een liturgisch leesblad) dat markdown en ::: vsa-notatie combineert, zonder een basispartituur-.mscz.

Eindresultaat en criteria

Klaar (demo) als: de PDF niet ouder is dan voorbeeld-blad.md en eventuele includes (zoals voorbeeld.vsa); check_demo_pdf_fresh onder check is groen. Op de demopagina staat een PDF-voorbeeldviewer.

Kenmerken van de export: :::pagebreak::: start een nieuw A4-blad; :::print-only::: … :::end-print-only::: verschijnt in de PDF, niet op de website; ruwe HTML in het markdownblad mag mee (Chrome/Edge rendert de tussen-HTML).

Wanneer wel / wanneer niet

Volgorde (bestanden)

1. Schrijf of bewerk het markdownblad (bij de demo: content-source\praktijk\demo\assets\voorbeeld-blad.md, met build: render: never zodat Hugo het blad niet als pagina publiceert).
2. Bouw de PDF:

scripts\demo-pdf.cmd

of generiek:

scripts\pdf.cmd content-source\praktijk\demo\assets\voorbeeld-blad.md -o static\demo\voorbeeld-blad.pdf --content-root content-source

3. Hard refresh in de browser als een oude PDF gecached blijft.
4. Commit bron én PDF samen als de demo-gate groen moet blijven.

Site-demo-uitleg: Markdown naar PDF (Tooling Demo) .

Automatisch (CI)

CI en lokale check / build / serve genereren geen willekeurige markdown-PDF’s. Wel faalt check_demo_pdf_fresh.py als static\demo\voorbeeld-blad.pdf ontbreekt of ouder is dan de bronnen. Herstel: scripts\demo-pdf.cmd, daarna opnieuw committen.

Handmatig

Vereist: Edge of Chrome (of CHROME_PATH / --chrome); zelfde validatiefouten als vsa validate bij kapotte VSA-blokken.

Zie ook

• Site-build (waar de demo-PDF-gate in de keten zit)
• Ingebedde VSA (SVG op de site, geen A4-PDF)