Modellmanifest (manifest.yaml)

Kva er `manifest.yaml`?

Kvar modell under src/linkml/<domain>/<modell>/ har ei manifest.yaml som styrer kva artefaktar som vert genererte, kva flagg som vert brukte, og om modellen skal publiserast til ein ekstern katalog. make new-model oppretter fila automatisk med standardkonfigen.

To typar manifest

Skjema-manifest (har `generators:`-seksjon)

Ligg ved sida av skjemafila:

src/linkml/<domain>/<modell>/manifest.yaml

publish_external: false   # true for å utløyse publisering til ekstern katalog
data_policy: silver        # bronze / silver / gold / felles-datakatalog / felles-begrepskatalog

generators:
  jsonld_context: true
  shacl: true
  shacl_flags: ""
  python: true
  json_schema: true
  owl: true
  owl_flags: ""
  rdf: true
  protobuf: true
  erdiagram: true
  docs: true
  plantuml: true
  example_rdf: true

Datafil-manifest (manglar `generators:`-seksjon)

Ligg inne i data/<datafil-katalog>/:

src/linkml/<domain>/<modell>/data/<datafil-katalog>/manifest.yaml

publish_external: true
data_policy: felles-begrepskatalog

concepts:                   # valfri — utelat for å publisere heile datafila
  - https://begrep.brreg.no/foretaksnavn
  - https://begrep.brreg.no/nestleder

CI skil dei to typane på om generators:-seksjonen er til stades.

Felta i skjema-manifest

`publish_external`

true utløyser publisering til ekstern katalog (Felles Datakatalog eller Felles Begrepskatalog) i CI. Standard: false.

`data_policy`

Peikar til valideringspolicyen som make domain-validate-data nyttar for datafiler under data/. Gyldige verdiar:

Verdi	Brukstilfelle
`bronze`	Minimumskrav — strukturelt korrekt LinkML
`silver`	Tilrådde felt er fylt ut
`gold`	Alle felt utfylt, med kvalitetskontrollar
`felles-datakatalog`	ModelDCAT-AP-NO — publisering til Felles Datakatalog
`felles-begrepskatalog`	SKOS-AP-NO-Begrep — publisering til Felles Begrepskatalog

Generatorflag

Dei boolske felta svarar 1:1 til manifest.yaml flag-kolonnen i tabellen over genererte artefakter i README. Alle har standardverdi true.

I tillegg kjem to flagg-felt for generatorar som treng ekstra parametrar:

Felt	Type	Standard	Skildring
`shacl_flags`	streng	`""`	Ekstra flagg til `gen-shacl`, t.d. `"--exclude-imports"`
`owl_flags`	streng	`""`	Ekstra flagg til `gen-owl`, t.d. `"--log_level ERROR"`

Eksempel

Standardkonfig (NGR, OREG — alle generatorar på, ingen flagg):

publish_external: false
data_policy: silver

generators:
  jsonld_context: true
  shacl: true
  shacl_flags: ""
  python: true
  json_schema: true
  owl: true
  owl_flags: ""
  rdf: true
  protobuf: true
  erdiagram: true
  docs: true
  plantuml: true
  example_rdf: true

FINT (rdf: false pga. HTTP-feil ved JSON-LD-kontekstoppslag; SHACL- og OWL-flagg for å handtere kryss-skjema klassearv; example_rdf: false der eksempelfila nyttar FINT-stile CURIEs som ikkje er gyldige URI-ar):

publish_external: false
data_policy: silver

generators:
  jsonld_context: true
  shacl: true
  shacl_flags: "--exclude-imports"
  python: true
  json_schema: true
  owl: true
  owl_flags: "--log_level ERROR"
  rdf: false
  protobuf: true
  erdiagram: true
  docs: true
  plantuml: true
  example_rdf: false

AP-NO / FAIR (example_rdf: false — desse skjemaa har ingen tree_root og kan ikkje konverterast til RDF av linkml-convert):

publish_external: false
data_policy: bronze

generators:
  jsonld_context: true
  shacl: true
  shacl_flags: ""
  python: true
  json_schema: true
  owl: true
  owl_flags: ""
  rdf: true
  protobuf: true
  erdiagram: true
  docs: true
  plantuml: true
  example_rdf: false

Korleis det fungerer

gen-config.sh les alle skjema-manifest.yaml-filer og skriv config.mk — eit Makefile-fragment med per-modell-variablar som Makefile-en inkluderer automatisk. config.mk vert automatisk regenerert når ei manifest.yaml-fil endrar seg. Du kan òg regenerere manuelt:

make config.mk

config.mk er generert og skal ikkje redigerast for hand.

Nye modellar

make new-model NAME=... DOMAIN=... oppretter ei standard manifest.yaml saman med skjemafila. Juster henne etterpå viss domenet krev det — til dømes for FINT-modellar der rdf og example_rdf skal vera false.