Bestandsformaten & CLI¶

Overzicht van de bronformaten die de toolchain leest of schrijft, en de commando’s / .cmd-scripts per bron. Normatieve details staan in de specificaties; dit is de navigatiehub.

Conversiematrix (kort)¶

Rijen = bron, kolommen = doel. Diagonaal = normaliseren naar canonieke vorm.

Bron ↓ \ Doel →	`.vsa`	`.mvsa`	`.mxl`	`.mscz`	`.mp3` / audio	`.midi`
`.vsa`	(waar relevant)	—	`vsa musicxml`	via mxl / templates	`vsa audio`	— (niet gepland)
`.mvsa`	—	`mvsa kuiser` / `normalize`	`mvsa mxl`	`mvsa mscz`	`mvsa mp3`/`ogg`/`wav`	— (niet gepland)
`.mxl`	—	`mxl import`	(checklist)	`mxl mscz`	`vsa audio`	— (niet gepland)
`.mscz`	—	`mscz import`	`mscz mxl`	(checklist)	`vsa audio` (fallback)	— (niet gepland)
`.midi`	—	—	—	—	—	— (niet gepland)

Audio (.mp3 / .ogg / .wav): preview-luisteren; CLI vsa audio — zie .mp3 / audio.
.midi / .mid: niet gepland (preview = audio) — zie .midi.
Zoektekst in canonieke .vsa / .mvsa: veld zoektekst in YAML-frontmatter — zoektekst. Extractie / export: vsa text op .vsa / .mvsa / MusicXML / .mscz (geen aparte matrixkolom; schrijft geen .mvsa-sibling). Alias op MuseScore-bron: mscz text.
Volledige matrix / keuzes: mvsa-conversies.
Import (.mxl / .mscz → .mvsa): werkbank-bewerkvorm (niet catalogus-klaar); soft-wrap, holds, recite; default --pitch ag-vsa (a–g per systeem + EHM + eindankers) — zie mvsa import.
Normaalvorm-checklists MXL / MSCZ / PDF: canonieke checklists (MXL = vier parts; MSCZ = twee balken SA/TB zonder stem-labels). Leesbaarheid partituur: MSCZ-leesbaarheid.

Bestandsformaten¶

Extensie	Rol	Spec / profiel	CLI (bron = command)
`.vsa`	Eenstemmige VSA-bron	Specificatie VSA	`vsa`
`.mvsa`	Meerstemmige tekstbron (draft)	specification-mvsa	`mvsa`
`.mxl` / `.musicxml`	MusicXML (Coria / bewerking)	checklists · MusicXML-export	`mxl`
`.mscz`	MuseScore-partituur	checklists · templates	`mscz`
`.mp3` / audio	Preview-luisteren (afgeleide)	dunne checklist; MuseScore	`vsa audio`
`.midi` / `.mid`	Los MIDI (niet gepland)	superseded door audio	—

Commando’s¶

Command	Bron	Man-pagina
`vsa`	`.vsa` (+ Markdown-workflows)	CLI-overzicht
`vsa text`	`.vsa` / `.mvsa` / MusicXML / `.mscz`	`text`
`vsa audio`	`.mxl` / `.vsa` / …	`audio`
`mvsa` ≡ `vsa mvsa`	`.mvsa`	`mvsa`
`mxl`	`.mxl` / `.musicxml`	`mxl`
`mscz`	`.mscz` (import / mxl / text)	`mscz`

Na pip install -e . staan vsa, mvsa, mxl en mscz op PATH.

Bestandsnaamgeving (kort)¶

Zonder -o schrijft de CLI stem.brontype.doeltype naast de bron (laatste segment = echte extensie), bv. lied.mvsa → lied.mvsa.mscz. In generated/ hetzelfde patroon, bv. alleluia.mvsa.mxl, lied.mvsa.mp3. Optioneel lyrics-product uit .mscz / .mxl: lied.mscz.lyrics.txt via vsa text — niet verplicht naast canonieke .vsa / .mvsa (daar: zoektekst). Expliciet -o mag een korte naam blijven. Details: canonieke checklists — naamgeving.

Windows `.cmd`-scripts¶

In de repo-root (via scripts\):

Script	Roept aan
`scripts\mvsa.cmd`	`python -m vsa.cli_mvsa`
`scripts\mxl.cmd`	`python -m vsa.cli_mxl`
`scripts\mscz.cmd`	`python -m vsa.cli_mscz`

Details: Scripts (cmd) · scripts/README.

cd /d C:\Git\orthodox-ronl\VSA-tooling
scripts\mvsa.cmd -h
scripts\mxl.cmd -h
scripts\mscz.cmd -h