Opnemen in de bibliotheek

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

Wat je nu doet: een klaar oefenbestand opnemen in de catalogus (de bibliotheek), zodat de Oefenhoek 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 (na opkuisen en normaliseren bij MuseScore, of na een werkende .vsa). Nog niet klaar? Laat het bestand in input\ staan; zie Opnemen — ruw binnenhalen .

Bibliotheek-id = drie namen, gescheiden door /, bijvoorbeeld 5-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 scripts\bieb-accepteer.cmd (kort: bieb-accepteer):

• maakt de mappen content-source\praktijk\oefenhoek\bibliotheek\<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 bibliotheek 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 VSA-demo (hoe ).
2. Eenvoudigste weg: alleen het script starten. Het vraagt wat ontbreekt:

scripts\bieb-accepteer.cmd

Typ het bibliotheek-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):

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

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

scripts\bieb-accepteer.cmd 5-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. Optioneel: geef een leesbare titel mee:

scripts\bieb-accepteer.cmd 5-eniggeboren-zoon/default/hemelum "C:\pad\naar\bestand.mscz" --title "5 Eniggeboren Zoon"

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 Bibliotheek en koormap . De partituur blijft in de bibliotheek; 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?

scripts\bieb-accepteer.cmd 1-vredeslitanie/default/hemelum --stub

Dan wordt publicatiestatus standaard voorzien.

Als het misgaat

Meer storingen: Als het misgaat .

Klaar als

• Onder bibliotheek\<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.