Ga naar inhoud

Gebruikershandleiding — tour

Voor wie / wanneer

Voor: notatie-auteur of wie de CLI nog niet kent. Wanneer: je wilt weten welke pagina bij jouw taak hoort. Niet: volledige flags of foutcodes — die staan in de CLI-referentie.

Antwoord in het kort: kies je taak in de tabel hieronder; open die pagina; flags alleen in de man-page.

Wat doet de tool?

De VSA-tool helpt bij VSA-notatie: controleren, als SVG tonen, en Markdown/Hugo-sites bouwen (hugo-output).

VSA-notatie  →  validate  →  SVG / MusicXML / Hugo-Markdown

Welke taak → welke pagina?

Ik wil … Ga naar
Lokaal installeren en eerste OK Starten
.mvsa leren typen (L, stemmen, octaven) mvsa schrijven 101
Bladmuziek → .mvsa (werkbank-import) mvsa schrijven 101 — bladmuziek · mvsa import
Het juiste commando kiezen CLI-taken
Begrijpen waarom validate faalt Validatie · vsa validate
Eén bestand of site als SVG SVG exporteren
MusicXML / Coria MusicXML-export
Platte gezongen tekst (zoek / lyrics) vsa text · CLI-taken
Hugo-consumer / waar hoort wat Consumer-site
Tool in een andere repo of CI Integratie
Formele taalregels Specificaties

Klaar als …

Doel Check
Omgeving OK vsa --version toont een versie
Notatie OK vsa validate examples\docs-walkthroughs\svg-phrase-kort.vsa → OK
Eerste SVG vsa svg examples\docs-walkthroughs\svg-phrase-kort.vsa … schrijft een .svg 
cd /d C:\Git\orthodox-ronl\VSA-tooling
test
vsa validate examples\docs-walkthroughs\svg-phrase-kort.vsa

Belangrijk onderscheid

Commando Doet wél Doet níet
vsa validate Syntax + semantiek controleren SVG schrijven
vsa svg Eén .vsa → SVG Volledige semantische validatie (zie man-page)

Zie ook