Ingebedde VSA
Dit werktraject betreft VSA buiten de catalogus: notatie
in gewone content-pagina’s (demo’s, feesteigen, samenstellingen,
handleidingen). De site-build maakt daar SVG (en optioneel MusicXML)
onder static\vsa\.
Waartoe
Je wilt VSA tonen op een pagina die geen bladermap onder
catalogus\ is — bijvoorbeeld een samenstelling of de
Tooling Demo — zonder bieb en zonder catalogus-id.
Eindresultaat en criteria
| Output | Rol |
|---|---|
SVG onder static\vsa\ | Plaatje op de Hugo-pagina |
Optioneel MXL onder static\vsa\mxl\ | Embed-Coria voor die content-keten |
Klaar als: de pagina de SVG toont na build; vsa validate /
validate_content stil is voor die bronnen.
Dit vervangt niet sibling {stam}.vsa.mxl in de catalogus (dat is
VSA
).
Wanneer wel / wanneer niet
| Wel | Niet |
|---|---|
| Demo, feesteigen, samenstelling, handleiding | catalogus-uitvoeringsvorm → VSA
+ bieb |
Inline ::: vsa-notatie of include van een .vsa | Alleen een A4-PDF uit markdown → Markdown naar PDF |
Volgorde (bestanden)
- Schrijf markdown onder
content-source(buitencatalogus\…als bladermap), met VSA-blokken of includes. - Bouw de site (of laat
checkde generate-stap doen):
scripts\check.cmd --strict
Intern: vsa build-markdown → generated\content + static\vsa;
daarna vsa musicxml content-source static\vsa\mxl (embed-keten);
sanitize/check op die MXL-map.
3. Preview: Site-build
.
Automatisch (CI)
Onderdeel van elke PR-/push-build: vsa build-markdown,
sync_oefenhoek_index.py --svg (bibliotheek-SVG’s), vsa musicxml.
Geen apart “embed-product”-script; geen vsa-products voor deze pagina’s.
Handmatig
| Situatie | Commando | Man-page |
|---|---|---|
| Volledige keten | scripts\check.cmd of scripts\build.cmd | check , build |
| Alleen bibliotheek-SVG | scripts\oefenhoek-index.cmd --svg | oefenhoek-index |
Zie ook
- VSA (bibliotheek)
- Site-build
- Voorbeeldpagina’s onder
content-source\praktijk\demo\encontent-source\praktijk\samenstellingen\