Bibliotheek en koormappen

Wat je nu doet: het model kennen waarmee de Oefenhoek werkt, zodat publicatie, ids en navigatie niet door elkaar lopen.

Drie invalshoeken

Kernregel

De bibliotheek is de bron van waarheid. Koormappen zijn views: ze bevatten geen tweede kopie van de basispartituur-bestanden, maar verwijzen met bieb naar zangstuk/variant/uitvoeringsvorm.

Een uitvoeringsvorm mag publiek in de bibliotheek staan terwijl geen enkele koormap ernaar wijst. Dat is bewust: ontdekking en latere opname in een map (feest, collectie, parochiekeuze) komen daarna.

Bouwstenen in een koormap

Een koormap is geen platte lijst “één zangstuk = één pagina”. De liturgiemap Hemelum is een inhoudsopgave van liturgische plekken. Een titel in die inhoudsopgave kan naar één zangstuk wijzen, of naar een hoofdstuk met meerdere keuzes (bijvoorbeeld eerste antifoon: weekdagen, zondag, later feestdagen).

Sectie (_index.md): zet automatische_inhoud: true als de layout de kindpagina’s mag tonen (voorbeeld: liturgiemap-hemelum\2-eerste-antifoon\). Zet false als je zelf de inhoudsopgave van dat hoofdstuk schrijft (zoals de root van de liturgiemap). Gebruik in sectie-_index.md geen #-titel in de body; die titel komt uit de layout.

Slot-pagina (index.md): gewone markdown. Daartussen kun je één of meer shortcodes bieb zetten. Elke shortcode zet eerst de knoppen Oefenen / Downloaden / Printen voor die uitvoeringsvorm, en daarna de PDF of VSA-SVG. De partituur blijft in de bibliotheek; de slot-pagina is alleen de view. Navigatie naar Bibliotheek of Koormap loopt via de sticky broodkruimelregel bovenaan de pagina.

Boom of compositieblad?

Twee manieren om meerdere uitvoeringsvormen op één liturgische plek te tonen —zelfde mechaniek, andere leeservaring:

Voorbeeld compositieblad (schets):

# Prokimen weekdagen (Kiev, Groningen)

## Maandag
{{< bieb id="9-prokimen/9a-maandag/groningen" >}}

## Dinsdag
{{< bieb id="9-prokimen/9a-dinsdag/groningen" >}}

Let op: elke bieb op dezelfde pagina heeft een eigen knoppenrij direct boven de partituur van die uitvoeringsvorm. Je hoeft geen aparte kindpagina’s te maken alleen om knoppen te scheiden.

Alias-varianten

Soms heeft dezelfde variant meerdere namen. Voorbeeld: de tropaar-variant maandag-toon-4 is dezelfde variant als heilige-engelen-toon-4 (de tropaar van de Heilige Engelen, gezongen op maandag). Dat is een alias op variant-niveau, niet een tweede uitvoeringsvorm.

Dan:

• partituren (.vsa, PDF, …) staan alleen bij de canonieke variant, hier de uitvoeringsvorm 110-tropaar/maandag-toon-4/hemelum;
• de alias-variant heeft alleen een _index.md met frontmatter alias_van: 110-tropaar/maandag-toon-4 — geen map hemelum/, geen index.md, geen partituur;
• de bibliotheek-index van het zangstuk (110-tropaar/, 120-kondak/, …) noemt beide varianten; achter de alias-naam staat dat het een alias is.

Shortcode bieb krijgt een uitvoeringsvorm-id (drie lagen). Wie de alias-variant in dat id zet, bijvoorbeeld 110-tropaar/heilige-engelen-toon-4/hemelum, wordt herschreven naar de canonieke uitvoeringsvorm. Product-tools (vsa-products, basispartituur-producten) slaan alias-varianten over: daar is niets te genereren.

check weigert een alias-variant die toch een uitvoeringsvorm-map of partituur bevat. Dat patroon mag voor elk zangstuk waarvan een variant onder meerdere namen bekend is.

Soorten koormap (classificatie)

Zelfde mechaniek, andere bedoeling — geen nieuwe id-laag:

Optioneel later: frontmatter type: op de koormap-_index (liturgie, feest, collectie, parochie).

Wat de bibliotheek-root toont

De root van de bibliotheek is geen sitemap van alle stubs. Koorleden zien daar vooral oefenbare zangstukken (nette titel, liturgienummer-volgorde). Voorzien-items en technische registers staan onder Speciaal en het Id-register .

Special pages

Automatisch bijgehouden (bij elke sitebuild):

Klaar als

Je kunt uitleggen waarom een Zwolle-cherubijn eerst in de bibliotheek hoort; waarom de Hemelum-liturgiemap géén tweede opslag van PDF’s is; en wanneer je een sectie (boom) kiest versus een compositieblad (meerdere shortcodes op één pagina).