NAME
scripts\lyrics-products.cmd — platte zoektekst naast .vsa / .mvsa /
.mscz
SYNOPSIS
scripts\lyrics-products.cmd [pad] [--force] [--dry-run]
DESCRIPTION
Haalt de gezongen tekst uit een catalogus-bron (via vsa text /
MusicXML-lyrics in VSA-tooling) en schrijft die naast de bron als sibling:
| Bron | Lyrics-product |
|---|---|
{stam}.vsa | {stam}.vsa.lyrics.txt |
{stam}.mvsa | {stam}.mvsa.lyrics.txt |
{stam}.mscz (basispartituur) | {stam}.mscz.lyrics.txt |
Bij een basispartituur-.mscz gebruikt het script bij voorkeur een verse
sibling {stam}.mscz.mxl (geen MuseScore-aanroep). Ontbreekt die of is die
ouder dan de .mscz, dan exporteert tooling tijdelijk via MuseScore (geen
.mscz.mvsa).
Bovenaan het tekstbestand staan herkomstregels (# vsa-source-sha256: …),
zodat check kan zien of de bron nieuwer is dan de lyrics. Bij .mscz is
vsa-source-kind = partituur. Na een geslaagde run vernieuwt dit script
ook static\zoek\index.json (zelfde stap als products en check). Op
GitHub Pages (productie, preview én branch-previews) bouwt de deploy-workflow
die index opnieuw vóór Hugo, zodat zoeken altijd bij de gecommitte catalogus
past.
Zoekt onder het opgegeven pad (of, zonder pad, onder
content-source\catalogus). Overgeslagen: input\, mappen met
artefacten_handmatig: true, *.print.mscz.
CI genereert geen lyrics; jij wel lokaal (of via products /
all-products), daarna committen. De zoekindex wel: die wordt
bij elke Pages-deploy opnieuw gebouwd.
EXAMPLES
scripts\lyrics-products.cmd
scripts\lyrics-products.cmd content-source\catalogus\cherubijnenhymne
scripts\lyrics-products.cmd --dry-run
SEE ALSO
all-products , mscz-products , check , Zoeken (handleiding) , Publicatiecontrole , Zangstuk-soorten