Afgeleiden bijwerken
Wat je nu doet: afgeleiden opnieuw laten maken nadat de bron is
gewijzigd, en controleren of preview en check geen verouderde-afgeleiden-
banner of -fout tonen.
Afgeleiden = bestanden die uit een bron komen en niet zelf die bron zijn.
Basispartituur: {stam}.pdf en {stam}.mxl. VSA: {stam}.vsa.mxl. De bron blijft de
plek waar je editet (basispartituur-.mscz of .vsa).
Wanneer: na elke inhoudelijke wijziging aan een basispartituur-.mscz of
catalogus-.vsa die al gepubliceerd wordt, vóór je opnieuw
publicatiestatus: reviewable (of hoger) zet. Eerste keer basispartituur-producten:
PDF en Coria
. Eerste keer VSA-Coria:
.vsa schrijven
.
Basispartituur: volgorde (niet omdraaien)
- Basispartituur in MuseScore 4 bewerken → Opslaan.
- Opnieuw normaliseren (
scripts\layout.cmdop diezelfde basispartituur). - Producten (
mscz-products.cmdop de catalogus-map). check --strict.- Preview: koormap-slot openen; PDF-download en Oefenen testen.
Sla je stap 2 over, dan kunnen PDF/Coria een basispartituur met verouderde layout of
reciteertoon-encoding weergeven. Sla je stap 3 over, klaagt check of toont
de preview een rode banner dat de basispartituur-afgeleiden niet bij de partituur-hash horen.
Basispartituur: stap voor stap
- Sla de basispartituur-
.msczop in het bibliotheek (niet alleen in_werk). - Normaliseer opnieuw:
scripts\layout.cmd content-source\catalogus\trisagion\8a-nederlands\hemelum\trisagion-8a-nederlands-hemelum.mscz
- Maak PDF en Coria-
.mxlopnieuw:
scripts\mscz-products.cmd content-source\catalogus\trisagion\8a-nederlands\hemelum
- Controleer:
scripts\check.cmd --strict
- Lokale preview (poort 18732): open het koormap-slot; test de PDF-knoppen en Oefenen.
VSA: Coria-.vsa.mxl
vsa-products syllabificeert ongescoopte tekst alleen tijdens export
(Pyphen, temp-bestand). De canonieke .vsa blijft geschikt voor SVG op de
site. Zie Werktrajecten
(basispartituur: Basispartituur
).
Na een wijziging in de catalogus-.vsa:
scripts\vsa-products.cmd
scripts\check.cmd --strict
Lokale check vernieuwt stale .vsa.mxl ook zelf. Commit bron en product
samen. Banner “VSA-afgeleiden niet in orde”: zelfde commando’s. Mappen met
artefacten_handmatig: true doen niet mee — daar houd jij PDF/MXL zelf bij.
Print-.mscz
Een bestand dat op .print.mscz eindigt, wordt door mscz-products
overslagen. PDF (en eventuele Coria-.mxl) maak je handmatig — zie
Print-.mscz
.
Banner of check-fout
| Symptoom | Meest waarschijnlijke oorzaak | Actie |
|---|---|---|
| Preview-banner: basispartituur-afgeleiden niet in orde | PDF/MXL niet vernieuwd na basispartituur-edit | Basispartituur-stappen 2–4 opnieuw |
| Preview-banner: VSA-afgeleiden niet in orde | .vsa.mxl ontbreekt of ouder dan .vsa | vsa-products + commit |
check weigert Coria-.mxl | Verkeerde .mxl (bijv. uit input\) of verouderd product | Alleen bibliotheek-producten uit mscz-products / vsa-products |
| Producten lijken niet te vernieuwen | Tijdstempels kloppen niet | mscz-products … --force of vsa-products … --force |
Meer storingen: Als het misgaat .
Klaar als
check --strict is groen; basispartituur-PDF/MXL horen bij de huidige basispartituur; VSA-.vsa.mxl
hoort bij de huidige .vsa (tenzij handmatig); preview toont geen
verouderde-afgeleiden-banner.