VSA plus template (SATB)

Wat je nu doet: de eenstemmige tropaar-.vsa (sopraan plus tekst) laten uitwerken tot een vierstemmig blad. Alt, tenor en bas komen uit de formule tropaar-toon-4, niet uit extra VSA-regels.

Wanneer: tropaar op toon 4 die al een corpus-id heeft (zoals Nikolaas T4-11). Een willekeurige antifoon of een andere toon: sla deze pagina over; blijf bij .vsa op de pagina . Nieuw corpus-id nodig? Vragen, niet zelf een code verzinnen.

Dit is niet de toekomstige meerstemmige VSA-syntax. Het is de keten die vandaag werkt: tekst in VSA, stemmen in de template, MuseScore-bestand als resultaat.

Stap voor stap

  1. De .vsa heeft bovenaan minstens:
---
title: Nicolaas van Myra
do: F4
mode: major
tempo: 130
genre: tropaar
tone: 4
template: tropaar-toon-4
corpus_id: T4-11
---

Bestandsnaam in de tooling-corpus: T4-11-nicolaas-van-myra.vsa (id, streepje, korte naam).

  1. Open een tweede Windows-opdrachtvenster, nu in VSA-tooling:
cd /d C:\Git\orthodox-ronl\VSA-tooling
  1. Render alleen corpus-id T4-11, plus PDF via MuseScore:
python scripts\render_tropaar_toon4_corpus.py --id T4-11 --pdf

Zonder --id doet het script de hele corpus — dat hoeft niet.

  1. Het resultaat landt in:

VSA-tooling\docs\specification-vsa-templates\library\tropaar-toon-4\examples\corpus\

naast de .vsa: .mscz, .mxl, en met --pdf ook .pdf.

  1. Kopieer naar de catalogus (voorbeeld Nikolaas: catalogus\tropaar-nikolaas-van-myra\liturgikon\hemelum\). Bestandsnamen zonder spaties. Voor dit soort template-blad:

    • hernoem de .mscz naar {stam}.print.mscz (buiten basispartituur-pijplijn);
    • houd PDF en Coria-.mxl handmatig bij naast die print;
    • zet op catalogus-index.md artefacten_handmatig: true (gele beheerdersbanner; vsa-products en partituur-publicatiecontrole laten de map met rust);
    • de eenstemmige .vsa mag ernaast blijven staan voor de notatie (SVG via scripts\oefenhoek-index.cmd --svg / volle check; zie .vsa schrijven ).

    Daarna koormap-slot via Catalogus en koormap . Print-details: Print-.mscz .

  2. Fout TemplateInstanceError: de VSA-sopraan landt niet op de formule (verkeerde toon of een verplicht slot overgeslagen). De melding zegt welke noot. Pas de VSA aan en render opnieuw — begin niet met de .mscz met de hand “bijkleuren”.

De formule zelf (template.yaml) wijzig je als beheerder van materiaal niet even tussendoor. Dat is een andere taak, in VSA-tooling.

Klaar als

In de catalogus liggen {stam}.print.mscz, handmatige PDF/MXL en de .vsa, met artefacten_handmatig: true op de index.md. MuseScore toont SATB; de preview (koormap-slot) heeft PDF plus Oefenen / Downloaden waar je die bestanden hebt neergezet.

Volgende: catalogus en koormap