Conversiemechanismen

Referentie voor conversiemechanismen (bijv. .vsa → .svg / .mxl).

Conversie is geen export: conversie verandert het formaat; export bepaalt hoe afgeleiden in een samenstelling verschijnen (Exportcontracten — exportmechanismen).

Uitvoering gebeurt met VSA-tooling (CLI-overzicht). Afgeleide output hoort niet in de bron-repository.

---

Conversie vs. export

Laag	Vraag	Voorbeeld
Conversiemechanisme	Wat is de afgeleide en hoe maak ik die?	.vsa → .svg of .mxl
Exportmechanisme	Hoe toon ik die in een samenstelling?	:::include svg "lied.vsa"

---

Geregistreerde mechanismen

Mechanisme	Contract	Output	CLI
vsa svg	conversie-vsa-svg	.svg	man-page
vsa musicxml	conversie-vsa-musicxml	.mxl / .musicxml	man-page

---

Pipeline-volgorde (doel)

flowchart LR
  VSA[".vsa bron"]
  ConvSvg["vsa svg"]
  ConvMxl["vsa musicxml"]
  SVG[".svg"]
  MXL[".mxl"]
  Site["samenstelling / site"]
  VSA --> ConvSvg --> SVG
  VSA --> ConvMxl --> MXL
  SVG --> Site
  MXL --> Site

Huidige stand: SVG-conversie draait deels inline tijdens document-build; MXL wordt handmatig of in de site-build gegenereerd. Een expliciete conversiestap vóór export is gepland — zie CI-architectuur.

---

Toekomstige conversies

Mechanisme	Input	Output	Status
Scan → VSA	PDF/png	.vsa	Niet geautomatiseerd; handmatige transcriptie
Audio	—	—	Nog niet gedefinieerd

Nieuwe conversiemechanismen krijgen een volledig org-contract vóór opname in CI.

---

Gerelateerd

• Exportcontracten
• Inhoudslevenscyclus Deel 2
• Schrijfconventies
• VSA CLI-overzicht