Starten — lokaal ontwikkelen¶
Deze pagina helpt je om de VSA-tooling lokaal te laten werken
(omgeving, eerste vsa-commando’s). Uitgebreidere procedures:
Handleidingen.
Voor wie
Voor notatie-auteurs en wie de CLI lokaal wil draaien — niet voor koorzangers die een dienst oefenen (parochie-site; zie Home).
Wie ben je? (kort)¶
| Ik wil … | Ga naar |
|---|---|
| Alleen lokaal opstarten | Stappen 1–5 hieronder |
| Foutmeldingen begrijpen | Validatie |
| SVG / Hugo-publicatie | SVG exporteren |
| Tour van typische taken | Gebruikershandleiding |
1. Repo-root¶
cd /d C:\Git\orthodox-ronl\VSA-tooling
2. Omgeving¶
test
3. Installatie controleren¶
vsa --version
Verwachte vorm: vsa 0.1.0 (of hoger).
4. Valideren¶
De validator controleert of VSA-notatie bruikbaar is
(vsa validate).
Voorbeeldinvoer (examples\docs-walkthroughs\svg-phrase-kort.vsa):
[:] {/Hei_}{/lig_} is de Heer. [//:]
vsa validate examples\docs-walkthroughs\svg-phrase-kort.vsa
Bij succes:
OK
5. SVG genereren¶
Met vsa svg (zelfde geldige demo):
vsa svg examples\docs-walkthroughs\svg-phrase-kort.vsa generated\vsa\svg-phrase-kort.svg
Verwachte stdout:
SVG geschreven naar: generated\vsa\svg-phrase-kort.svg
Zo ziet die frase eruit (vaste preview; regenereren via
python scripts\sync-docs-walkthrough-svgs.py):
Rijkere of bewust ongeldige demos (bijv. 050_svg_demo.vsa) mogen op
validate falen — zie vsa svg.
Volgende stappen¶
| Doel | Pagina |
|---|---|
| Tour + links naar de juiste pagina’s | Gebruikershandleiding |
| Het juiste commando per taak | CLI-taken |
| Foutmeldingen begrijpen | Validatie |
| Tool hergebruiken in een andere repo | Integratie |
| Docs lokaal met TermRefs | TEv2 in tool-docs |