Zangstuk-soorten

De bibliotheek gebruikt overal dezelfde drie lagen: zangstuk → variant → uitvoeringsvorm. Niet elk zangstuk betekent hetzelfde. Dit blad legt drie soorten uit, zodat ids, titels en later hernoemen dezelfde taal spreken.

Drie soorten

Alias-varianten (alias_van) blijven een apart mechanisme: dezelfde variant onder een tweede naam (bijvoorbeeld maandag-tropaar = tropaar van de Heilige Engelen). Dat is geen vierde soort zangstuk.

De woorden genre-emmer, liturgische familie en enkelvoudig werk zijn cataloguslabels in deze handleiding. Ze zijn geen nieuwe org-termen in de glossary van bron, en ze vormen geen extra maplaag onder content-source\catalogus\.

Padmodel: geen collectie-laag

Het catalogus-id blijft altijd drie padsegmenten:

zangstuk-id / variant-id / uitvoeringsvorm-id

Daaronder liggen de bestanden (.vsa, .mscz, …): dat is de representatie uit de org-glossary, geen vierde URL-segment.

Collectie in Catalogus en koormappen is een soort koormap (thematische view, bijvoorbeeld «alle cherubijnen»). Dat is geen tussenmap boven zangstukken.

Waarom geen extra map «collectie»

Stel je de catalogus voor als een ladekast. Elke lade heeft een naam (tropaar, eerste-antifoon, eniggeboren-zoon). In de lade zitten varianten; daaronder de uitvoeringsvorm die je oefent. Shortcode bieb, publicatiestam, zoekindex en ID-REGISTER verwachten precies die drie stukken.

Een tussenmap als content-source\catalogus\genres\tropaar\… zou die afspraak breken: tooling zou de eerste drie padstukken als id lezen en colofon, bieb en zoeken zouden niet meer kloppen — tenzij alles org-breed wordt omgebouwd. Dat is disproportioneel: genre-emmers werken al als zangstuk-id.

Padvoorbeelden

Spanning met de org-glossary (bewust)

De glossary in bron zegt: varianten onder één zangstuk delen dezelfde liturgische functie. Bij tropaar en kondak is de variant juist welk tropaar of kondak (andere tekst of feestdag). Dat is een bewuste cataloguskeuze van de bibliotheek: browsen op genre. De liturgische plek in de dienst blijft in de koormap. Die spanning lossen we niet op met een vierde padlaag.

Wat wél en niet in het id hoort

Nieuwe zangstukken volgen dit beleid meteen. Bestaande genummerde ids blijven geldig tot een bewuste hernoem-golf.

Besluiten (vastgelegd)

1. Ektinia’s — Eén zangstuk-id ektinia (meervoud/familie). Litanieën is synoniem/alias in titels en zoeken, niet een tweede canonieke id. Varianten = soort ektinia (vrede, eerste-kleine, tweede-kleine, vragend-16, vragend-22, dringend, …).

2. Vragende ektinia — koormap-slots vragende-litanie-16 en vragende-litanie-22 zijn twee varianten onder ektinia (vragend-16, vragend-22): dezelfde antwoorden, maar andere priester-@tekst en bij 16 wél een slotamen. Per variant twee uitvoeringsvormen: hemelum en hemelum-ksl. De liturgienummers 16 en 22 staan in de _index van de liturgiemap.

3. Kruis / «Heer, red Uw volk» — 210-heer-red-uw-volk-en-zegen-uw-erfdeel, tropaar-alias heer-red-uw-volk en 220-uw-heilig-kruis horen bij de tropaar-familie (varianten onder tropaar na migratie), geen aparte top-level zangstukken op den duur.

4. Cherubijnen / trisagion (VO-nummers) — Het zangstuk heet gewoon cherubijnenhymne / trisagion (geen 15- / 8- in het zangstuk-id). De codes 15b, 15c, 15d, … komen uit de index van de Vereniging van Orthodoxen en onderscheiden settings die anders botsen (twee verschillende Kastorski’s). Die code hoort op variant-niveau, in id én zichtbaar label — niet alleen via beluisteren.

   Voorbeeld:

   Laag	Voorbeeld
   Zangstuk	cherubijnenhymne — titel «Cherubijnenhymne»
   Variant	15c-kastorski — linkTitle «Kastorski (15c)»
   Variant	15d-kastorski — linkTitle «Kastorski (15d)»
   Uitvoeringsvorm	hemelum, …

   Zo zeg je in gewone taal «de cherubijnenhymne», en bij de keuze tussen twee Kastorski’s zie je welke zonder te moeten afspelen. Trisagion houdt taal nog in de variant (8a-nederlands, 8a-slav) — dat is legacy. Voor nieuw werk: geen suffix = Nederlands; andere talen als suffix op de uitvoeringsvorm (-ksl, …); zie Taalvarianten .

5. Geen collectie-padlaag — Genre-emmers en liturgische families blijven een gewoon zangstuk-id. Geen tussenmap en geen vierde id-segment. «Collectie» blijft een koormap-type. Zie Padmodel hierboven. Geen glossary-PR op bron nodig voor dit besluit.

Inventaris (stand na PR #16–#22)

Kolom Huidig = mapnaam onder content-source\catalogus\ nu. De genummerde hernoem-golven zijn klaar; kolom Was in de opmerkingen is alleen geschiedenis.

Klaar (geen nummer meer in het zangstuk-id)

Er staan geen genummerde top-level zangstuk-ids meer onder content-source\catalogus\ (behalve variant-ids zoals 9a-… / 15c-… / 20d-…). Liturgienummers voor de volgorde staan in de _index van de liturgiemappen; de koormap-slotnamen zelf hebben geen voorvoegsel-cijfer meer (vredeslitanie, vragende-litanie-16, …). De Hugo-sectie heet catalogus (niet meer content-source\bibliotheek\).

Geen zangstuk-taxonomie

Wat al gebeurd is

• Overzicht-weight van genre-/familie-emmers rechtgezet (tropaar 750, kondak 760, kruis-buurt 755/765, prijslied 3000).
• Leesbare title / linkTitle op een aantal slug-achtige variantpagina’s.
• Sitezoeken + lyrics-producten (zie Zoeken ).
• Eerste hernoem-golf: 110-tropaar → tropaar, 120-kondak → kondak.
• Ektinia-golf: litanie-zangstukken geconsolideerd onder ektinia (varianten o.a. vrede, eerste-kleine, tweede-kleine, dringend, ontslapenen, catechumenen, gelovigen, vragend-16, vragend-22). Vragende 16/22 zijn aparte varianten (andere priestertekst; 16 met slotamen); per variant hemelum + hemelum-ksl. Script: scripts/migrate_ektinia.py.
• Cherubijnen-golf: 15-cherubijnenhymne → cherubijnenhymne; variant- linkTitle met VO-label (bijv. «Kastorski (15c)»).
• Trisagion-golf: 8-trisagion → trisagion.
• Kruis-golf: 210-heer-red-uw-volk-en-zegen-uw-erfdeel → tropaar/heer-red-uw-volk; 220-uw-heilig-kruis → tropaar/uw-heilig-kruis. Script: scripts/migrate_tropaar_kruis.py.
• Koormap-slotmappen voor trisagion/cherubijnenhymne hernoemd zodat inhoudsopgave-links en mapnamen weer overeenkomen.
• Antifonen + intocht: 2-eerste-antifoon → eerste-antifoon, 4-tweede-antifoon → tweede-antifoon, 6-derde-antifoon → derde-antifoon, 7-kleine-intocht → kleine-intocht (inclusief koormap-slots weekdagen/zondag).
• Prokimen + alleluia: 9-prokimen → prokimen, 9-alleluia → alleluia; koormap-slots 9a-prokimen → prokimen, 9b-alleluia → alleluia (TOC-kolom blijft 9a/9b).
• Prijslied: 250-prijslied → prijslied.
• Enkelvoudige / overige genummerde zangstukken: 5, 7d, 10, 17–29 zonder liturgienummer in het zangstuk-id; koormap-slots meegenomen (inclusief 19a-eucharistische-kanon → eucharistische-canon).

Volgende stappen

1. Eventueel speciaal beoordelen (utility, geen zangstuk).

Nieuwe hernoemingen: werktraject Zangstuk hernoemen (bieb hernoem neemt 1:1-koormap-slots mee; check bevat de slotlink-controle). Hugo-aliases voor oude URL’s (/bibliotheek/…, genummerde paden) zijn bewust weggelaten: die paden werden niet gebruikt.