NAME

bieb accepteer — partituur of tekstblad opnemen in de catalogus

SYNOPSIS

scripts\bieb.cmd accepteer [id] [bestand...] [opties]
scripts\bieb.cmd accepteer [bestand] [opties]
scripts\bieb.cmd accept [id] [bestand...] [opties]

Engelse alias: accept. Compat-shim: scripts\bieb-accepteer.cmd (zelfde argumenten).

DESCRIPTION

Neemt een klaar bestand op in de bibliotheek (de catalogus onder content-source\catalogus\), onder een catalogus-id van drie lagen: zangstuk/variant/uitvoeringsvorm. Toegestaan: basispartituur-.mscz, .vsa, .mvsa, handmatig .mscz (met --artefacten-handmatig of legacy .print.mscz), of .tekstblad.md (optioneel sibling-.pdf / .mxl). Bij .tekstblad.md zet het script indien nodig frontmatter build: render: never zodat de bron geen Hugo-pagina wordt.

Bestand eerst, id uit de bestandsnaam

Zonder argumenten vraagt het script eerst het bronbestand (of stub). Dat bestand wordt meteen gecontroleerd (formaat; bij .vsa / .mvsa ook validate). Pas daarna komt het catalogus-id — zo verspil je geen tijd aan een id als de bron nog niet klopt.

Geef het bronbestand bij voorkeur al de publicatiestam-naam:

zangstuk-variant-uitvoeringsvorm.ext

voorbeeld: kondak-johannes-de-theoloog-toon-2-liturgikon.vsa.

Daaruit leidt accepteer het id af en vraagt ter bevestiging. Als je zowel id als bestand doorgeeft, moet de bestandsstam bij het id passen; anders stopt het script (typo-vangnet; --force om toch door te gaan).

Je mag het bestand ook als eerste CLI-argument geven (zonder id); het script herkent een pad en leidt het id af.

Bladpagina: title en linkTitle

Het script maakt ontbrekende _index.md / index.md met shortcode bieb en hernoemt naar de publicatiestam. Getoonde namen leidt Hugo/zoek af uit het id (en de bron); zie Catalogus en koormappen (§ Titels). Op de leaf mag het script nog afgeleide title / linkTitle zetten:

VeldDefault (afgeleid)
titleUit VSA-frontmatter (titel: / soort:), anders uit id
linkTitleUitvoeringsvorm-label (Liturgikon, Hemelum, …)

--title alleen als uitzondering. check --strict controleert dat de UV-labels in data/uitvoeringsvorm-link-titles.yaml gelijk blijven aan Python (check_catalogus_leaf_titles).

Sibling-PDF/MXL krijgen de doelvorm {stam}.mscz.pdf / {stam}.mscz.mxl (of .vsa.mxl / .tekstblad.pdf). Een kale ongekuiste .mxl wordt geweigerd — eerst opkuisen / layout . Default publicatiestatus: reviewable (voorzien bij --stub). Status productie alleen met --force.

Ontbreekt bestand of id, dan vraagt het script die interactief. Typ ? voor uitleg.

Andere subcommando’s van bieb: hernoem (catalogus-id wijzigen), verwijder (wissen + dangling refs), kopieer (uitvoeringsvorm dupliceren).

OPTIONS

OptieBetekenis
--titleUitzondering: overschrijf afgeleide leaf-titel
--statusPublicatiestatus
--stubLege leaf (voorzien)
--moveBronbestanden verplaatsen (default: kopieer)
--forceOverschrijven / productie / stam-mismatch toestaan
--dry-runAlleen tonen
--skip-vsa-validateGeen vsa/mvsa validate
--artefacten-handmatigZet artefacten_handmatig: true

EXAMPLES

rem Interactief: eerst bestand, dan bevestig afgeleid id
scripts\bieb.cmd accepteer

rem Bestand met publicatiestam-naam (id wordt afgeleid)
scripts\bieb.cmd accepteer pad\naar\trisagion-8a-nederlands-hemelum.vsa --dry-run

rem Klassiek: id + bestand (stammen moeten kloppen)
scripts\bieb.cmd accepteer trisagion/8a-nederlands/hemelum pad\naar\bestand.mscz --dry-run

WHEN

Als de partituur klaar is om van de Werkbank naar de Catalogus te gaan (na opkuisen / normaliseren, of na een werkende .vsa / .mvsa). Overgangscriteria: Werkbank . Daarna producten + check --strict — Catalogus .

SEE ALSO