Opnemen in de catalogus

Werktraject (waartoe, criteria, CI, binnenhalen): Opnemen in de catalogus . Deze pagina is de HOW voor bieb accepteer.

Wat je nu doet: een klaar oefenbestand opnemen in de catalogus, zodat de site het kan tonen. Het script maakt de mappen en de pagina-bestanden voor je; jij hoeft die niet met de hand te typen.

Wanneer: als de partituur inhoudelijk klaar genoeg is voor de overgang van Werkbank naar Catalogus (na opkuisen en normaliseren bij MuseScore, of na een werkende .vsa). Nog niet klaar? Laat het bestand in input\ staan; zie Opnemen — ruw binnenhalen .

Catalogus-id = drie namen, gescheiden door /, bijvoorbeeld eniggeboren-zoon/default/hemelum. Elke naam mag alleen kleine letters, cijfers, - en _ bevatten. Lijst: Id-register . Ken je het id niet? Niet verzinnen — vraag na.

Wat het script voor je doet

Het commando bieb accepteer:

• maakt de mappen content-source\catalogus\<zangstuk>\<variant>\<uitvoeringsvorm>\ als die nog ontbreken;
• zet daar een index.md met de knoppen via shortcode bieb;
• kopieert je bestand en geeft het de publicatiestam als naam (zonder spaties), afgeleid van het id;
• weigert bestanden die niet in de catalogus horen (bijvoorbeeld Capella .capx, of alleen een ruwe .mxl zonder basispartituur of VSA);
• controleert een .vsa met vsa validate voordat die wordt opgenomen.

Het script doet niet de muzikale opkuis in MuseScore en maakt niet automatisch PDF/Coria — dat blijft PDF en Coria of VSA .

Stap voor stap

1. Open het Windows-opdrachtvenster in bibliotheek (hoe ).
2. Eenvoudigste weg: alleen het script starten. Het vraagt wat ontbreekt:

bieb accepteer

Typ het catalogus-id, daarna het pad naar het bestand. Weet je even niet wat er gevraagd wordt? Typ ? en Enter — dan komt uitleg, en mag je daarna alsnog invullen. Geen partituur, alleen een lege pagina? Typ stub als bestand.

3. Of alles in één regel (handig als je id en pad al weet). Eerst een droge proef (niets wordt weggeschreven):

bieb accepteer eniggeboren-zoon/default/hemelum "C:\pad\naar\mijn-bestand.mscz" --dry-run

4. Klopt de uitvoer? Draai dezelfde regel zonder --dry-run:

bieb accepteer eniggeboren-zoon/default/hemelum "C:\pad\naar\mijn-bestand.mscz"

5. Voor een VSA-bestand hetzelfde patroon, met .vsa in plaats van .mscz. Voor een print-vel: bestandsnaam eindigend op .print.mscz (het script zet dan ook artefacten_handmatig aan).

6. De paginatitel volgt uit het catalogus-id (en bij VSA uit de bron). Geen aparte --title nodig — zie Catalogus en koormappen (§ Titels).

7. Draai de controle:

scripts\check.cmd --strict

8. Hoort het stuk in de liturgiemap (koormap)? Zet of controleer daar een slot-pagina met bieb — zie Catalogus en koormap . De partituur blijft in de catalogus; de koormap is alleen de route voor koorleden.

Welke bestanden mag je aanleveren?

Lege plek reserveren (stub)

Wil je het id en de pagina alvast, maar nog geen partituur?

bieb accepteer ektinia/vrede/hemelum --stub

Dan wordt publicatiestatus standaard voorzien.

Als het misgaat

Meer storingen: Als het misgaat .

Klaar als

• Onder catalogus\<zangstuk>\<variant>\<uitvoeringsvorm>\ staat je bestand met de publicatiestam-naam.
• Er staat een index.md met shortcode bieb en hetzelfde id.
• scripts\check.cmd --strict eindigt zonder fout.
• (Optioneel) De koormap-slotpagina verwijst naar hetzelfde id.