Basispartituur → PDF en Coria
Dit werktraject maakt uit een basispartituur-.mscz (MuseScore) de
bestanden die koorleden downloaden en in Coria oefenen. Representatie-id:
partituur.
Waartoe
Een vierstemmig (of meer) blad in de catalogus moet op de site als
A4-PDF leesbaar zijn en via de knop Oefenen in Coria afspeelbaar. Dit
traject houdt PDF en Coria-.mxl synchroon met de canonieke
basispartituur.
Eindresultaat en criteria
| Bestand (in de bladermap) | Rol |
|---|---|
{stam}.mscz | Canonieke basispartituur |
{stam}.mscz.pdf (doel) of legacy {stam}.pdf / {stam}.partituur.pdf | A4-afdruk |
{stam}.mscz.mxl (doel) of legacy {stam}.mxl / {stam}.partituur.mxl | MusicXML voor Coria |
Klaar als: de PDF/MXL de stamp partituur-sha256 van de huidige
.mscz dragen; de colofonregel Bibliotheek-id: klopt met het pad;
check_partituur_products (onderdeel van check --strict) is groen.
Meerdere producten van hetzelfde type in één map → expliciete
doelvorm (zie Publicatiecontrole
).
Wanneer wel / wanneer niet
| Wel | Niet |
|---|---|
| Gewoon oefenmateriaal: één tekst, standaardlayout, automatische Coria | Bestandsnaam eindigt op .print.mscz → Print-vel |
Na opkuisen, layout, en review | Ruwe Capella-.mxl zonder basispartituur |
| Alleen eenstemmige tekst → VSA |
Volgorde (bestanden)
- Ruw materiaal via Opnemen
(of al in
_werk\). Inhoudelijk opkuisen: Opkuisen . - Normaliseren naar basispartituur-standaard:
scripts\layout.cmd pad\naar\bestand.mscz
HOW: Standaard-.mscz
.
3. Review in MuseScore 4, daarna opnieuw layout indien nodig.
HOW: Reviewen
.
4. Bestand in de catalogus (als dat nog niet zo is):
bieb accepteer — zie Opnemen
.
5. Catalogus-id in colofon/meta (lokaal vaak al via check):
scripts\ensure-bibliotheek-id.cmd
- PDF en Coria-
.mxlexporteren:
scripts\mscz-products.cmd content-source\catalogus\trisagion\8a-nederlands\hemelum
Of heel content-source. --force als producten ouder zijn dan de
.mscz. HOW: PDF en Coria
.
7. Site zichtbaar maken: Site-build
.
Voorbeeldbladermap:
content-source\catalogus\trisagion\8a-nederlands\hemelum\.
Automatisch (CI)
Op GitHub Actions (workflows validate.yml / pages.yml):
- Wel:
check_partituur_products.pyencheck_bibliotheek_id.pycontroleren of PDF/MXL bij de.msczpassen en of het catalogus-id klopt. - Niet: MuseScore-export (
mscz-products). CI heeft geen MuseScore 4. Verouderde of ontbrekende producten laten de build falen — jij vernieuwt ze lokaal en commit PDF/MXL mee.
Lokaal vernieuwt scripts\check.cmd (via _pipeline.cmd) stale
basispartituur-producten wél met sync_mscz_products.py, en zet
ontbrekende catalogus-ids met ensure_bibliotheek_id.py.
Handmatig
| Situatie | Commando | Man-page |
|---|---|---|
| Layout / normaliseren | scripts\layout.cmd <pad> | layout |
| PDF + Coria | scripts\mscz-products.cmd [map] | mscz-products |
Catalogus-id in .mscz | scripts\ensure-bibliotheek-id.cmd | ensure-bibliotheek-id |
| Alles vóór commit | scripts\check.cmd --strict | check |