Ga naar inhoud

Consumer-site — waar hoort wat

Voor wie / wanneer

Voor: consumer-site builder die wil weten wat in welke repo hoort. Wanneer: je hangt Hugo + vsa-tool aan elkaar. Niet: een volledige Hugo-cursus — die hoort bij VSA-demo.

Antwoord in het kort: tooling = package/CLI (validate, conversies, layoutprofielen); presentatievoorbeeld = VSA-demo; bibliotheek/productbeleid = consumer-repo’s; zangstukken/org-specs = bron-repository.

Ownership (wat hoort waar, bibliotheek-id, layoutprofielen): Integratie — reuse.

Waar hoort wat

Repo Rol
VSA-tooling (deze docs) Package, CLI, specs, fixtures
VSA-demo Voorbeeld-Hugo-site + Pages
bron Zangstukken en org-specs

Minimale keten (tooling)

content-source/*.md  (+ .vsa)
        ↓
  vsa validate
        ↓
  vsa build-markdown  →  content/ + static/vsa/
        ↓
  hugo  →  public/

cd /d C:\Git\orthodox-ronl\VSA-tooling
vsa validate examples\consumer-minimal\content-source
vsa build-markdown examples\consumer-minimal\content-source generated\ci\content generated\ci\static\vsa

Voor een rijkere Markdown + Coria-oefenlink (lokale kopie tropaar toon 3):

vsa build-markdown examples\docs-walkthroughs\coria-oefenlink generated\docs-walkthrough-coria\content generated\docs-walkthrough-coria\static\vsa

Zie MusicXML-export — Coria-walkthrough.

Lokaal (voorbeeldconsumer)

cd /d C:\Git\orthodox-ronl\VSA-demo
test
scripts\serve-hugo.cmd

Documentatie: VSA-demo README.

Zie ook