Markdown naar PDF

Wat je hier leert: van een Markdownblad (tekst, VSA, includes, paginascheidingen) een A4-PDF maken. De site-build maakt de PDF niet automatisch; wel controleert check / serve of de demo-PDF up-to-date is. Beheerder-pijplijn: Markdown naar PDF (Werktrajecten) .

Bron

assets\voorbeeld-blad.md — niet als Hugo-pagina gepubliceerd; alleen bron voor de PDF. Gebruikt o.a. ::: vsa-notatie en :::include svg (zie de SVG-demootjes voor die onderwerpen apart).

---
title: "Tropaar voor het voorbeeldblad"
build:
  render: never
  list: never
---

# Tropaar voor het Voorbeeldblad

Dit blad is bedoeld om te laten zien hoe Markdown met VSA tot een printbare
PDF wordt. Onderstaande melodie staat eerst inline, daarna via een include
van `voorbeeld.vsa` (zie de SVG-demootjes voor die vormen apart).

::: vsa-notatie
[\\:] Dat {//he}melse en {\aard}{/se} {/&/we}{zens_} *
jubelen en zich ver{\&\&\blij_&~&~}{\den_}, *
want {/de} {/Heer} heeft de kracht van Zijn {\arm} {/ge}{/&/o}pen{baard_}. *
Uit de doden was Hij de eerstge{/bo_}re{\ne_}, *
uit de schoot van de {-&\ha}{/des} {/heeft} {/Hij_} {\ons} ver{\lost_} *
// en aan de wereld grote ge{na_}{\de} {\ge}{/&/&/&\&\&\&/schon.&.&.&.&.&.&~}{\ken__}. [:]
:::

Zelfde melodie via bestand (handig bij hergebruik; in `.vsa` geen
`::: vsa-notatie`-hekjes):

:::include svg "voorbeeld.vsa" alt="Tropaar toon 3 (include)" scale="85%":::

:::pagebreak:::

# Tweede blad: kleinere schaal

Na de paginascheiding volgt dezelfde melodie nog eens, kleiner gezet.

:::include svg "voorbeeld.vsa" alt="Tropaar toon 3 (kleiner)" scale="70%":::

:::print-only:::
[Oefenen in Coria](https://orthodox-ronl.github.io/VSA-demo/coria/praktijk/demo/assets/voorbeeld.html)

*Dit zinnetje en de Coria-link hierboven staan alleen in de PDF
(`print-only`), niet op de website. De link wijst naar de gepubliceerde
site (niet naar localhost).*
:::end-print-only:::

:::pagebreak::: forceert een nieuw A4-blad.
:::print-only::: … :::end-print-only::: verschijnt wel in de PDF, niet op de website.
Een Coria-oefenlink in de PDF is een gewone markdown-link met een absoluut adres op de gepubliceerde site (zie het blad). De directive :::include coria is voor de website; in PDF-export wordt die weggelaten — een relatieve site-knop werkt niet vanuit een PDF-bestand.

Resultaat

voorbeeld-blad.pdf — download

Commando

Na wijziging van het blad (of voorbeeld.vsa):

scripts\demo-pdf.cmd

Dat schrijft static\demo\voorbeeld-blad.pdf. Hard refresh in de browser als de oude PDF gecached blijft.

Is de PDF ouder dan de bronnen, dan faalt check / serve met precies dit commando als herstel.

Generiek (andere bestanden): scripts\pdf.cmd — zie scripts\h.cmd pdf.

Probleem	Controle
Include niet gevonden	`--content-root` naar `content-source` (zit in `demo-pdf.cmd`)
Geen browser	Edge/Chrome; of `CHROME_PATH` / `--chrome`
Validatiefout	Zelfde meldingen als `vsa validate`

Zie ook: scripts\h.cmd demo-pdf.