Ga naar inhoud

Verhaal 2 — Rene neemt Nana's Cherubijnenhymne op in de parochie-repo

Nana stuurt Rene een PDF met een Cherubijnenhymne die zij heeft gezet in de traditie van Kastorski, bewerkt voor hoe de parochie Groningen zingt. Rene wil het stuk in de lokale parochie-catalogus zodat het in liturgiemappen (samenstellingen) kan worden opgenomen, nog vóór het org-breed in de bron-repository staat.

Situatie

Aspect Waarde
Zangstuk Cherubijnenhymne (cherubijnenhymne)
Variant Kastorski (kastorski) — melodie-lijn
Uitvoeringsvorm Parochie Groningen (groningen)
Bronbestand (nu) PDF-scan van Nana's partituur
Status Parochie-lokaal — nog niet in org-brede bron

Terminologie en mappenstructuur: parochie-lokaal zangstukken.

Beoogde interface (GUI)

Rene kiest in de catalogus Materiaal toevoegen → Parochie-lokaal.

  1. Wizard stap 1 — Zangstuk: zoekt “cherubijnenhymne”. Bestaat al in bron? Ja → koppelen aan bestaand zangstuk-id. Nee → nieuw id voorstellen (hier: bestaand).
  2. Stap 2 — Variant: “Kastorski” / Касторский → kastorski.
  3. Stap 3 — Uitvoeringsvorm: naam “Groningen”, alias registreren.
  4. Stap 4 — Representatie: PDF slepen naar repr/; optioneel later VSA toevoegen als Nana transcribeert.
  5. Stap 5 — Manifesten: tool genereert variant.yaml en uitvoeringsvorm.yaml met aliases: en representaties:.
  6. Validatie: groene vinkjes; knop Open in Verkenner voor git commit.

GUI + lokaal-wizard

De wizard is gepland. Rene maakt de mappen en yaml vandaag handmatig (of met templates); catalogus index validate en catalogus zoek werken op CLI.

Wat Rene vandaag doet (CLI + bestanden)

1. Mappenstructuur aanmaken

In de parochie content-source:

content-source/
└── lokaal/
    └── cherubijnenhymne/
        └── kastorski/
            ├── variant.yaml
            └── groningen/
                ├── uitvoeringsvorm.yaml
                └── repr/
                    ├── nana-partituur.pdf      ← PDF van Nana
                    └── groningen.vsa           ← later, indien getranscribeerd

Referentie-fixture in bron-tests: tests/fixtures/alias-index/lokaal/cherubijnenhymne/.

2. Manifesten schrijven

variant.yaml:

zangstuk-id: cherubijnenhymne
variant-id: kastorski
title: "Cherubijnenhymne (Kastorski)"

aliases:
  - { text: "Kastorski", lang: en }
  - { text: "Касторский", lang: ru }

uitvoeringsvorm.yaml:

uitvoeringsvorm-id: groningen
based_on: kastorski
herkomst:
  author: "Nana (parochie Groningen)"
  note: "Bewerking op basis van Kastorski-traditie"

aliases:
  - { text: "Groningen", lang: nl }

representaties:
  - representatie-id: scan-nana
    file: repr/nana-partituur.pdf
  # Later, wanneer VSA klaar is:
  # - representatie-id: groningen-vsa
  #   file: repr/groningen.vsa

3. PDF plaatsen

Rene kopieert Nana's bestand naar repr/nana-partituur.pdf en commit in de parochie-repo.

4. Index valideren

Controleer dat er geen conflicterende aliassen zijn (Catalogus CLI).

5. Resolve testen

Los de alias “Groningen” voor de uitvoeringsvorm op binnen cherubijnenhymne / kastorski — verwacht canoniek id groningen (Catalogus CLI — resolve).

6. Gebruik in een sjabloon of samenstelling

In het liturgie-sjabloon (verhaal 1):

:::include svg zoek="Cherubijnenhymne (Kastorski)" alt="Cherubijnenhymne":::

Met default.uitvoeringsvorm: Groningen in de sessie (homogene liturgie) of disambiguation Cherubijnenhymne (Kastorski) in mixed session. Na oplossen van zoek= (bijv. :::include svg lokaal:cherubijnenhymne/kastorski/groningen:::) — zie vsa resolve-catalogus.

Zoektest: Catalogus CLI — zoek.

Afspraken met Nana

Wat Rene bereikt

Verder lezen