Sjabloon schrijven (catalogus)¶

Praktische handleiding voor Rene en andere parochie-beheerders. Normatief contract: Zangstuk-opzoeken in sjablonen.

Voorbeeld workflow: verhaal 1.

Wat is een sjabloon?¶

Een sjabloon is een herbruikbaar markdown-bestand in de parochie content-source:

vaste tekst (kopjes, liturgische aanwijzingen) — jij schrijft dat zelf;
default.gelegenheidstype (en parochie-defaults) — geen individuele feesten;
:::include met exporttype en zoek="…" — liturgische rol, nog geen pad.

Als jij het sjabloon gebruikt voor een concrete dienst, maak je een sessie: zelfde structuur, plus default.gelegenheid (en evt. toon, titel, datum).

Drie soorten sjablonen¶

Soort	Wanneer	Typische `default` in sjabloon
Dienst	Goddelijke liturgie (alle vast-feesten)	`gelegenheidstype: vast-feest`, `uitvoeringsvorm`
Koormap	Zondagse stukken per toon	`gelegenheidstype: zondag-cyclus`, `uitvoeringsvorm`
Herkomst	Verzameling uit één bron (bijv. VOK)	`referentie`, `koormap_nummer`

Legacy (niet meer aanbevolen): yaml-inventarisatie goddelijke-liturgie.yaml in de VSA-demo — ruwe VOKN-koormap-notities, geen geldig sjabloon- of compositie-schema. Nieuw werk: markdown-sjablonen (hierboven) en catalogus-samenstelling-zangstuk. Zie ook samenvatting-project — sjabloon vs compositie.

Stap 1 — Frontmatter (sjabloon)¶

Minimaal default.gelegenheidstype. default.uitvoeringsvorm alleen als het sjabloon bedoeld is voor homogene sessies (zelfde parochie-praktijk overal).

Geen default.gelegenheid in het sjabloon — die zet Rene in de sessie.

---
sjabloon: goddelijke-liturgie-groningen
default:
  gelegenheidstype: vast-feest
  uitvoeringsvorm: Groningen
---

Sessie (Rene, Geboorte Moeder Gods — mixed session):

---
sjabloon: goddelijke-liturgie-groningen
titel: "Goddelijke liturgie — Geboorte Moeder Gods (8 september)"
default:
  gelegenheid: geboorte-moeder-gods
  gelegenheidstype: vast-feest
  toon: 4
---

Feest-stukken komen uit bron (liturgikon); Cherubijnenhymne uit lokaal (groningen). Daarom geen default.uitvoeringsvorm in deze sessie — één parochie-default dekt beide niet. Zie mixed session.

Eigen yaml-sleutels naast sjabloon / titel / default / bronnen mag — de catalogus negeert ze.

Stap 2 — Tekst en includes¶

Schrijf gewone markdown. Waar notatie komt — meteen het exporttype dat je op de site wilt:

## Kleine intocht

### Troparion

:::include svg zoek="Troparion" alt="Troparion" scale="85%":::
:::include coria zoek="Troparion" label="Oefenen Troparion" mode="auto":::

Tekst of aanwijzing voor het koor (vrij).

### Kondakion

:::include svg zoek="Kondakion" alt="Kondakion":::

Regels voor zoek=

Alleen de liturgische rol (Troparion, Kondakion, Prokimen) — geen feestnaam; die zit in default.gelegenheid van de sessie.
Meerdere :::include-regels met dezelfde zoek= voor svg, coria, mp3-player, …
(Kastorski) in zoek= mag voor disambiguation — bijv. Cherubijnenhymne.
Geen variant-id tenzij je na review een vast bron:…-pad zet (variant alleen dan expliciet).

Stap 3 — Koormap-sjabloon (voorbeeld)¶

---
sjabloon: groningen-koormap-zondag
default:
  gelegenheidstype: zondag-cyclus
  uitvoeringsvorm: Groningen
---

Rene zet in de sessie default.toon. In zoek= geen toon herhalen:

# Zondag — toon {{toon}}

:::include svg zoek="Troparion" alt="Troparion zondag":::
:::include svg zoek="Kondakion" alt="Kondakion zondag":::
:::include svg zoek="Prokimen" alt="Prokimen zondag":::

Stap 4 — Resolve en publiceren¶

Controleer dat de catalogus-index in orde is (Catalogus CLI).
Los elke zoek= op tot bron:… / lokaal:… (vsa resolve-catalogus). Bij meerdere treffers: lijst bekijken of default.* / zoek= verfijnen (catalogus zoek).
Valideer en bouw het opgeloste bestand (vsa validate, vsa build-markdown).

Let op (demo): mappen samenstellingen/ en sjablonen/ worden in de Hugo-demo niet automatisch gepubliceerd. Kopieer opgeloste inhoud naar een publishbare content-map, of pas de build-config aan — zie parochie-lokaal VSA.

Export: :::include svg op bron: werkt; :::include coria op bron: faalt zolang het .vsa buiten de content-root staat (org-bron). Coria op lokaal: werkt wel.