VSA-tooling¶
VSA-tooling is de Python-toolchain voor het verwerken van
VSA-notatie-bestanden. De kern is de vsa CLI: die parseert, valideert en
zet vsa-bestanden om naar afgeleiden (bijv. .svg, .mxl). Die
afgeleiden worden niet in de bron-repository bewaard, maar bij de build
opnieuw gemaakt.
Volledige commando’s, opties en voorbeelden:
CLI-referentie (vsa).
Wat je ermee doet¶
| Doel | Typisch subcommando |
|---|---|
| Controleren of VSA klopt | validate |
| Notatie als plaatje (SVG) | svg |
| MusicXML voor MuseScore/Coria | musicxml |
| Documenten voor de site bouwen | build-markdown |
zoek= in markdown oplossen |
resolve-catalogus |
VSA-tooling is een conversiemechanisme: het zet bronbestanden om naar afgeleiden. Org-contracten (wat/wanneer): conversiemechanismen.
Installatie (kort)¶
cd /d C:\Git\orthodox-ronl\VSA-tooling
scripts\bootstrap.cmd
Daarna kun je in de bron-repository valideren:
cd /d C:\Git\orthodox-ronl\bron
vsa validate zangstukken
Details: CLI-overzicht.
Motivatie¶
VSA-notatie-bestanden zijn tekst die mensen schrijven. Zonder tooling is er
geen garantie dat ze syntactisch kloppen, en is omzetten naar SVG of MusicXML
handmatig en foutgevoelig. VSA-tooling maakt dat automatisch en
reproduceerbaar — elke build genereert afgeleiden opnieuw uit de getrackte
bronbestanden. In CI valideert vsa validate zangstukken bij push of PR.