.vsa schrijven en op de pagina

Wat je nu doet: de gezongen tekst in VSA-notatie zetten en via de catalogus op de site tonen, inclusief oefenen in Coria. Nog geen vierstemmig blad — daarvoor is de volgende pagina , alleen voor tropaar toon 4.

Wanneer: je hebt tekst (en een bekende melodie) in plaats van een Capella-partituur. Voorbeeld-catalogus-id: eerste-antifoon/weekdagen/hemelum.

Wat de site van je .vsa maakt

Op een gewone eenstemmige catalogus-pagina (geen basispartituur-.mscz ernaast) doet de build twee aparte dingen met hetzelfde .vsa-bestand:

AfgeleideRol op de paginaHoe maak je die
SVG onder static\vsa\bladermap\…Het plaatje dat shortcode bieb toontPipeline-stap scripts\oefenhoek-index.cmd --svg (zit in check / build / serve zonder --no-build)
{stam}.vsa.mxl naast de .vsaKnop Oefenen (Coria)scripts\vsa-products.cmd (of dezelfde check-keten); export syllabificeert woorden tijdelijk voor Coria, zonder je .vsa te wijzigen

scripts\opkuisen.cmd past geen Capella-/MusicXML-heuristieken toe op een .vsa. Met --analyze of --dry-run kan opkuisen wél vsa validate rapporteren; automatische inhoudsfix op .vsa bestaat in v1 niet — zie opkuisen .

Volledig overzicht van de pijplijnen: Werktrajecten (VSA-werktraject: VSA → SVG en Coria ). HOW op deze pagina; de werktrajectpagina beschrijft waartoe, CI en commando’s.

*.print.mscz in dezelfde map blokkeert de SVG niet (dat is een printvel, geen basispartituur). Een basispartituur-.mscz wél: dan toont de pagina de PDF uit de basispartituur-spoor, geen VSA-SVG.

Los alleen SVG vernieuwen (na vsa build-markdown, of als static\vsa al bestaat):

scripts\oefenhoek-index.cmd --svg

serve --no-build slaat generate + --svg over. Zie je Hugo-waarschuwing “SVG ontbreekt”, draai dan eerst die regel of een volle check / serve zonder --no-build.

Stap voor stap

  1. Maak of kies de catalogus-map (publiceren ).
  2. Open een bestaand .vsa dat op het nieuwe stuk lijkt. Verzin de tekens niet vanaf nul. Antifoon-voorbeeld:

content-source\catalogus\eerste-antifoon\weekdagen\hemelum\eerste-antifoon-weekdagen.vsa

  1. Kopieer dat bestand naar jouw catalogus-map, hernoem naar de publicatiestam (geen spaties), plak jouw tekst in dezelfde notatie. Een .vsa is geen Markdown-pagina: zet geen #-koppen in de notatie zelf. Zet wél YAML bovenaan tussen --- met minstens do, mode en tempo (default in de toolchain is 120 BPM):
---
do: F4
mode: major
tempo: 130
---
  1. In het Windows-opdrachtvenster:
vsa validate content-source\catalogus\eerste-antifoon\weekdagen\hemelum\eerste-antifoon-weekdagen.vsa

Foutmelding: de markering zit in de gezongen tekst, niet in het programma. Verbeter de notatie. “Even stil krijgen” door tekens weg te halen is geen oplossing.

  1. In catalogus-index.md (kopieer een bestaand voorbeeld):
---
title: "…"
publicatiestatus: reviewable
automatische_inhoud: false
---

# …

{{< bieb id="eerste-antifoon/weekdagen/hemelum" >}}

  1. Hetzelfde id in de slot-pagina van de koormap (bijv. koormappen/hemelum/liturgie-weekdagen\eerste-antifoon\weekdagen\index.md). Meerdere VSA’s op één liturgische plek? Sectie met kindpagina’s, of één compositieblad — zie Catalogus en koormappen .

  2. Draai scripts\check.cmd --strict. Die keten:

    • schrijft de SVG voor het plaatje (scripts\oefenhoek-index.cmd --svg);
    • maakt of vernieuwt {stam}.vsa.mxl naast de .vsa (scripts\vsa-products.cmd doet dat ook los).

    Commit .vsa en .vsa.mxl samen. De SVG onder static\vsa\ hoort bij de build-output (niet handmatig committen). Op de preview verschijnt het plaatje én de knop Oefenen.

Catalogus-includes horen niet in de oefenhoek (geen verwijzing naar content-source/lokaal/). Kondaken en troparen: catalogus-leaf + bieb. Zie Catalogus en koormap .

Uitleg van de VSA-tekens ({/, {_, *, …): de pagina’s onder Tooling Demo , niet deze handleiding. Hier gaat het over waar het .vsa-bestand hoort en hoe het op de catalogus-site komt.

Handmatige artefacten

Zet je op de catalogus-index.md artefacten_handmatig: true, dan vernieuwt vsa-products de Coria-.mxl niet. Dat hoort bij print-velden of template-exports die jij zelf bijhoudt — zie Print-.mscz en de gele banner op die cataloguspagina. Afspraak over namen en sporen: Publicatiecontrole .

Ligt er wél een .vsa naast een {stam}.print.mscz, dan mag de build nog steeds de SVG van die .vsa maken (notatie naast de handmatige PDF). Alleen basispartituur-.mscz onderdrukt die SVG-route.

Rode banner “VSA-afgeleiden niet in orde”, of check rood op main: de .vsa.mxl ontbreekt, is ouder dan de .vsa, of mist de provenance-stamp. Oplossing: scripts\vsa-products.cmd, daarna opnieuw check, en beide bestanden committen. Zie ook Als het misgaat .

Hugo-waarschuwing “SVG ontbreekt”

Shortcode bieb zoekt static\vsa\bladermap\catalogus\<…>\<naam>.svg. Ontbreekt dat bestand:

scripts\oefenhoek-index.cmd --svg

of scripts\check.cmd --strict. Daarna opnieuw previewen. Met serve --no-build gebeurt die SVG-stap niet.

Klaar als

vsa validate is stil, catalogus en koormap verwijzen met hetzelfde id, na check zie je het plaatje op de lokale preview, en er ligt een verse {stam}.vsa.mxl naast de .vsa (knop Oefenen), tenzij artefacten_handmatig: true op die cataloguspagina staat (dan houd jij de Coria-.mxl zelf bij; de SVG mag de pipeline nog steeds schrijven).

Volgende: template SATB