Documentatie — bron repository¶
Welkom bij de documentatie van de bron-repository: de centrale bron van waarheid voor zangstukken binnen orthodox-ronl.
Deze site is voor wie zangstukken of documentatie beheert — niet voor het koor dat een dienst oefent of een partituur volgt. Daarvoor: de parochie-site (bijv. VSA-demo).
Wie ben je? (kies je route)¶
| Ik wil … | Voor wie | Start hier |
|---|---|---|
Sjablonen / zoek= / catalogus voor de parochie |
Parochie-docs-maintainer | Catalogus-handleidingen |
Een zangstuk of bronvariant toevoegen / access: |
Bron-contentbeheerder | Zangstuk toevoegen · Handleidingen |
| Begrijpen wat wel/niet mag (afgeleide, ids, …) | Spec-/PR-reviewer | Specificaties · Terminologie |
| Docs of TEv2 bijdragen | Docs-/tool-contributor | Documentatie bijdragen |
| VSA schrijven / CLI / SVG / MusicXML | Notatie-auteur / consumer-site builder | VSA-tooling — documentatie |
| Partituur oefenen / liturgie volgen | Koor / liturgie | Niet hier — parochie-site / demo |
Rollen en toon: Schrijfconventies.
Wat vind je hier¶
| Sectie | Wat je er vindt |
|---|---|
| Starten | Lokaal ontwikkelen: repo openen, docs bekijken, zangstukken valideren. |
| Handleidingen | Stap-voor-stap procedures (zangstuk toevoegen, copyright, catalogus-voorbeelden). |
| Specificaties | Normatieve regels: terminologie, repo-structuur, zangstuk.yaml, catalogus-contracten. |
| Referentie | Contractpagina’s voor conversie, exporttypes en brontype-validatie — ter naslag naast de specificaties. |
| Terminologie | Gegenereerde glossary van org-brede begrippen (na TEv2-build). |
| Plannen | Ontwikkelplannen en ideeën. Die zijn niet normatief; bij twijfel gelden specificaties en handleidingen. |
Waar hoort wat?¶
| Vraag | Ga naar |
|---|---|
| Hoe voer ik een taak uit in de bron-repo? | Handleidingen |
| Wat betekent een term, en wat mag wel/niet? | Specificaties en Terminologie in deze site |
| Hoe werkt de VSA-CLI (validate, svg, MusicXML)? | VSA-tooling — documentatie |
Zie ook Documentatie-eigendom: normatieve org-specs horen alleen in bron; tool-docs horen in VSA-tooling.
Wat staat niet op deze site¶
De zangstukken zelf (zangstukken/, composities/) staan in git maar worden
niet als webpagina's gepubliceerd. Parochie-sites en build-pipelines consumeren
die inhoud rechtstreeks uit de repository.
Afgeleide bestanden (SVG, MXL, …) — zie Inhoudslevenscyclus.
Lokaal bekijken¶
cd /d C:\Git\orthodox-ronl\bron
serve
Met TermRefs: serve-tev2.
Externe tools¶
Conversie en validatie van vsa-bestanden gebeurt met
VSA-tooling
(documentatiesite)
(vsa validate,
vsa svg,
vsa musicxml).