Status, check en live
Werktraject voor de hele site-keten: Site-build . Deze pagina is de HOW voor publicatiestatus en lokale controle.
Wat je nu doet: zeggen wat koorleden mogen verwachten, de keten laten controleren, zelf de pagina nalopen, daarna pas publiceren op internet.
Publicatiestatus
Op elke Oefenhoek-pagina die koorleden zien (bibliotheek en koormap),
in de --- bovenaan:
| Waarde | Wanneer |
|---|---|
voorzien | Gepland, nog geen oefenbare uitgave (stub) |
concept | Eerste versie; vooral op sectie-_index |
reviewable | Er staat iets in; feedback welkom |
productie | Alleen bewust, nooit gokken |
Bibliotheek mét basispartituur, VSA of print-PDF: meestal reviewable. Lege stub:
voorzien. Intern Stap in de werkvoorraad (opkuisen, layout, …) is
iets anders — dat zien koorleden niet.
Optioneel op bibliotheek-index.md: artefacten_handmatig: true als PDF
en Coria-.mxl in die map niet via de product-pipeline mogen lopen (print /
template). Zie Print-.mscz
.
Check
In de map VSA-demo:
scripts\check.cmd --strict
Dat controleert onder meer VSA-notatie, Coria-.mxl (basispartituur én .vsa.mxl),
of publicatiestatus erop staat, of partituur-/VSA-afgeleiden bij hun bron
horen, en of links op de site kloppen. Rood = niet naar live; eerst
als het misgaat
.
Lokaal vernieuwt check ook stale basispartituur-PDF/MXL (MuseScore) en stale
.vsa.mxl. Commit gewijzigde producten mee. Op branch main faalt de
build als die producten ontbreken of verouderd zijn.
Preview
Als check groen is en je niet opnieuw wilt genereren:
scripts\serve.cmd --no-build
Browser: http://127.0.0.1:18731/ — nooit poort 1313. Open jouw koormap-slot in de liturgiemap. Klik Oefenen, Downloaden, blader de PDF. Alsof je koorlid bent. Rode banner over partituur- of VSA-afgeleiden? Terug naar Afgeleiden . Gele banner “Handmatige artefacten”? Verwacht — jij houdt PDF/MXL zelf bij.
Alles opnieuw opbouwen (langer): scripts\serve.cmd zonder --no-build.
Op internet
De publieke site is
orthodox-ronl.github.io/VSA-demo
.
Die site volgt branch main. Lokaal groen is de drempel; daarna
committen en pushen (of iemand vragen die git doet). Preview-branches
komen onder /preview/.
Je hoeft git niet uit deze handleiding te leren. Wél: nooit pushen met
een rode check --strict.
Klaar als
De publicatiestatus klopt op bibliotheek én koormap, check is groen, jij hebt de preview als koorlid geklikt, en live is een bewuste volgende stap.