Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

develop -> v2 #215

Merged
merged 7 commits into from
Sep 16, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/adocs-build-and-publish-develop.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ jobs:
continue-on-error: true

- name: Deploy
uses: peaceiris/actions-gh-pages@v3
uses: peaceiris/actions-gh-pages@v4
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./docs
3 changes: 2 additions & 1 deletion .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
{
"githubPullRequests.ignoredPullRequestBranches": [
"develop"
]
],
"asciidoc.antora.enableAntoraSupport": false
}
14 changes: 7 additions & 7 deletions docs/Del1-eksempler-begrepsbeskrivelser.adoc
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
=== Eksempler på begrepsbeskrivelser [[Del1-eksempler-på-begrepsbeskrivelser]]

|===
a|*Eksempel på en begrepsbeskrivelse med kun obligatoriske opplysninger*, hentet fra Felles datakatalog 2022-11-25, for begrepet https://data.norge.no/concepts/6bd8baed-c9d7-4dbc-b850-78ceeebdc1d5[«mødrekvote»]:
a|*Eksempel på en begrepsbeskrivelse med kun obligatoriske opplysninger*, hentet fra Felles datakatalog, 2022-11-25, for begrepet https://data.norge.no/concepts/6bd8baed-c9d7-4dbc-b850-78ceeebdc1d5[«mødrekvote» ⧉, window="_blank", role="ext-link"]:

* *anbefalt term*: «mødrekvote» (bokmål), «mødrekvote» (nynorsk)
* *definisjon*: «den delen av foreldrepengeperioden som er forbeholdt mor» (bokmål)
* *identifikator*: https://data.norge.no/concepts/6bd8baed-c9d7-4dbc-b850-78ceeebdc1d5
* *identifikator*: \https://data.nav.no/begrep/BEGREP-975
* *kontaktpunkt*: mailto:begrepskatalogen@nav.no[begrepskatalogen@nav.no]
* *publisert av*: NAV
|===

|===
a|*Eksempel på noen anbefalte opplysninger*, hentet fra Termbasen til Standard Norge 2022-08-30, for begrepet https://termbasen.standard.no/term/168204378607009/nb[«innholdsdefinisjon»]:
a|*Eksempel på noen anbefalte opplysninger*, hentet fra Termlex til Standard Norge, 2024-09-16, for begrepet https://termlex.no/term/171137531106903/nb[«innholdsdefinisjon» ⧉, window="_blank", role="ext-link"]:

* *fagområde*: «terminologi» (bokmål)
* *merknad*: «Innholdsdefinisjoner foretrekkes framfor andre typer definisjoner (3.3.1) fordi de tydelig avdekker kjennetegnene (3.2.1) til et begrep (3.2.7) i et begrepssystem (3.2.28): de bør brukes når det er mulig.» (bokmål)
Expand All @@ -32,22 +32,22 @@ a|*Eksempel på noen valgfrie opplysninger*, ved å bruke et fiktivt eksempel, b
|===

|===
a|*Eksempel på en generisk relasjon*, basert på https://data.norge.no/specification/termlosen/#kap1.4.1[figur 4 i Termlosen], for begrepet «tre»:
a|*Eksempel på en generisk relasjon*, basert på https://data.norge.no/specification/termlosen/#kap1.4.1[figur 4 i kap. 1.4.1 i Termlosen ⧉, window="_blank", role="ext-link"], for begrepet «tre»:

* *generaliserer*: «eviggrønt tre» (nynorsk)
* *inndelingskriterium*: «bladfelling» (nynorsk)
|===

|===
a|*Eksempel på en partitiv relasjon*, basert på https://data.norge.no/specification/termlosen/#kap1.4.2[figur 6 i Termlosen], for begrepet «rot»:
a|*Eksempel på en partitiv relasjon*, basert på https://data.norge.no/specification/termlosen/#kap1.4.2[figur 6 i kap. 1.4.2 i Termlosen ⧉, window="_blank", role="ext-link"], for begrepet «rot»:

* *helhetsbegrep*: «tre» (nynorsk)
* *inndelingskriterium*: «anatomi» (nynorsk)
|===

|===
a|*Eksempel på en assosiativ relasjon*, hentet fra Felles datakatalog 2022-11-25, for begrepet https://data.norge.no/concepts/adb06f11-2712-3e18-98ce-6def045418fb[«lovlig opphold»]:
a|*Eksempel på en assosiativ relasjon*, hentet fra Felles datakatalog, 2022-11-25, for begrepet https://data.norge.no/concepts/adb06f11-2712-3e18-98ce-6def045418fb[«lovlig opphold» ⧉, window="_blank", role="ext-link"]:

* *relasjonsrolle*: muliggjør
* *til-begrep*: https://data.norge.no/concepts/68950551-3fec-3fb4-a802-8127bac322c2[«medlem i folketrygden»]
* *til-begrep*: https://data.norge.no/concepts/68950551-3fec-3fb4-a802-8127bac322c2[«medlem i folketrygden» ⧉, window="_blank", role="ext-link"]
|===
22 changes: 11 additions & 11 deletions docs/Del1-krav-begrep.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,13 @@
[cols="25,50,25"]
|===
|*Obligatorisk* |*Regler og anbefalinger for registrering* |*I tillegg, hvis de finnes*
|https://termbasen.standard.no/term/168204538107105/nb[anbefalt term] |
se https://data.norge.no/specification/termlosen#kap3.3[kap. 3.3 i Termlosen, om anbefalt term, tillatt term og frarådd term]; +
| https://termlex.no/term/171137522902468/nb[anbefalt term ⧉, window="_blank", role="ext-link"] |
se https://data.norge.no/specification/termlosen#kap3.3["kap. 3.3 i Termlosen, om anbefalt term, tillatt term og frarådd term ⧉", window="_blank", role="ext-link"]; +
anbefalt term skal finnes på både bokmål og nynorsk; +
det skal være maksimum én anbefalt term per skriftspråk; +
det skal oppgis hvilket skriftspråk termen er skrevet på
|
|https://termbasen.standard.no/term/168204365109319/nb[definisjon] |
| https://termlex.no/term/171137526903743/nb[definisjon ⧉, window="_blank", role="ext-link"] |
det skal være minimum én definisjon, og maksimum én per skriftspråk og målgruppe; +
det skal oppgis hvilket skriftspråk definisjon er skrevet på; +
minst én kombinasjon av anbefalt term og definisjon skal være på samme skriftspråk
Expand All @@ -33,7 +33,7 @@ kontaktpunkt bør ikke vise til en enkeltperson
|ansvarlig virksomhet ||
|dato opprettet ||
|dato sist oppdatert ||
|https://termbasen.standard.no/term/168204370402269/nb[fagområde] |
| https://termlex.no/term/171137528906133/nb[fagområde ⧉, window="_blank", role="ext-link"] |
det bør fortrinnsvis velges fra en kontrollert liste; +
når fagområde oppgis som tekst, skal det oppgis hvilket skriftspråk teksten er skrevet på; +
fagområde kan representere en akademisk disiplin, et bruksområde, et produkt, en tjenestekjede eller lignende
Expand All @@ -44,8 +44,8 @@ oppgis som dato fra og med, og/eller dato til og med |
utfyllende forklaring; +
det skal oppgis hvilket skriftspråk merknaden er skrevet på
|
|https://termbasen.standard.no/term/168204539507523/nb[tillatt term] | se
https://data.norge.no/specification/termlosen#kap3.3[kap. 3.3 i Termlosen, om anbefalt term, tillatt term og frarådd term]; +
| https://termlex.no/term/171137525006547/nb[tillatt term ⧉, window="_blank", role="ext-link"] | se
https://data.norge.no/specification/termlosen#kap3.3["kap. 3.3 i Termlosen, om anbefalt term, tillatt term og frarådd term ⧉", window="_blank", role="ext-link"]; +
det skal oppgis hvilket skriftspråk termen er skrevet på |
|===

Expand All @@ -56,9 +56,9 @@ det skal oppgis hvilket skriftspråk termen er skrevet på |
|*Valgfri* |*Regler og anbefalinger for registrering* |*I tillegg, hvis de finnes*
|datastrukturterm ||
|eksempel | det skal oppgis hvilket skriftspråk eksemplet/eksemplene er skrevet på |
|https://termbasen.standard.no/term/168210663604713/nb[frarådd term] |
| https://termlex.no/term/171137522602191/nb[frarådd term ⧉, window="_blank", role="ext-link"] |
se
https://data.norge.no/specification/termlosen#kap3.3[kap. 3.3 i Termlosen, om anbefalt term, tillatt term og frarådd term]; +
https://data.norge.no/specification/termlosen#kap3.3["kap. 3.3 i Termlosen, om anbefalt term, tillatt term og frarådd term ⧉", window="_blank", role="ext-link"]; +
det skal oppgis hvilket skriftspråk termen er skrevet på |
|status| bør fortrinnsvis velges fra en kontrollert liste; +
når tekst brukes, skal det oppgis hvilket skriftspråk teksten er skrevet på |
Expand All @@ -75,9 +75,9 @@ Et begrep kan ha relasjoner til andre begreper. Når et begreps relasjon til et
[cols="25,50,25"]
|===
|*Type relasjon til det andre begrepet* |*Regler og anbefalinger for registrering* |*I tillegg, hvis de finnes*
|https://termbasen.standard.no/term/168204371002565/nb[generisk begrepsrelasjon] | enten det begrepet som dette begrepet *spesialiserer*, eller det begrepet som dette begrepet *generaliserer* | https://termbasen.standard.no/term/168204529703821/nb[inndelingskriterium]
|https://termbasen.standard.no/term/168204529503414/nb[partitiv begrepsrelasjon] | enten det begrepet som dette begrepet *er del av*, eller det begrepet som dette begrepet *inneholder* | https://termbasen.standard.no/term/168204529703821/nb[inndelingskriterium]
|https://termbasen.standard.no/term/168204375104789/nb[assosiativ begrepsrelasjon] | det begrepet som dette begrepet *er relatert til*, og med *relasjonstype*, eventuelt uttrykt som begrepets *relasjonsrolle* overfor det andre begrepet |
| https://termlex.no/term/171137526403399/nb[generisk begrepsrelasjon ⧉, window="_blank", role="ext-link"] | enten det begrepet som dette begrepet *spesialiserer*, eller det begrepet som dette begrepet *generaliserer* | https://termlex.no/term/171137526103099/nb[inndelingskriterium ⧉, window="_blank", role="ext-link"]
| https://termlex.no/term/171137529308815/nb[partitiv begrepsrelasjon ⧉, window="_blank", role="ext-link"] | enten det begrepet som dette begrepet *er del av*, eller det begrepet som dette begrepet *inneholder* | https://termlex.no/term/171137526103099/nb[inndelingskriterium ⧉, window="_blank", role="ext-link"]
| https://termlex.no/term/171137526104694/nb[assosiativ begrepsrelasjon ⧉, window="_blank", role="ext-link"] | det begrepet som dette begrepet *er relatert til*, og med *relasjonstype*, eventuelt uttrykt som begrepets *relasjonsrolle* overfor det andre begrepet |
|===

Dersom en begrepsrelasjon skal være kjent begge veier, bør den beskrives begge veier.
Expand Down
2 changes: 1 addition & 1 deletion docs/Del1-krav-begrepssamling.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ En begrepssamling bør beskrives med følgende anbefalte opplysninger hvis de fi
* *beskrivelse* (maks. én per skriftspråk), og det skal oppgis hvilket skriftspråk beskrivelsen er skrevet på

|===
a|*Eksempel på en begrepssamling*, https://data.norge.no/concepts[begrepsoversikten i Felles datakatalog]:
a|*Eksempel på en begrepssamling*, https://data.norge.no/concepts[begrepsoversikten i Felles datakatalog ⧉, window="_blank", role="ext-link"]:

* *identifikator*: https://data.norge.no/concepts
* *kontaktpunkt*: fellesdatakatalog@digdir.no
Expand Down
4 changes: 2 additions & 2 deletions docs/Del1-med-normative-referanser.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,6 @@

=== Normative referanser [[Del1-normative-referanser]]

* https://online.standard.no/ns-iso-1087-2019[NS-ISO 1087:2019 _Terminology work and terminology science - Vocabulary_]
* https://online.standard.no/ns-iso-1087-2019[NS-ISO 1087:2019 _Terminology work and terminology science - Vocabulary_ ⧉, window="_blank", role="ext-link"]

* https://online.standard.no/ns-iso-704-2022[NS-ISO 704:2022 _Terminology work - Principles and methods_]
* https://online.standard.no/ns-iso-704-2022[NS-ISO 704:2022 _Terminology work - Principles and methods_ ⧉, window="_blank", role="ext-link"]
4 changes: 2 additions & 2 deletions docs/Del2-med-normative-referanser.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,6 @@

=== Normative referanser [[Del2-normative-referanser]]

* https://www.w3.org/TR/skos-reference/[_SKOS Simple Knowledge Organization System Reference_], W3C Recommendation 18 August 2009
* https://www.w3.org/RDF/[_Resource Desciption Framework (RDF)_]
* https://www.w3.org/TR/skos-reference/[__SKOS Simple Knowledge Organization System Reference__ ⧉, window="_blank", role="ext-link"], W3C Recommendation 18 August 2009
* https://www.w3.org/RDF/[__Resource Desciption Framework (RDF)__ ⧉, window="_blank", role="ext-link"]
* <<Del1>> i denne standarden
12 changes: 6 additions & 6 deletions docs/Endringslogg.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,10 @@ Kun redaksjonelle justeringer, bl.a. at `adms:status` er rettet til `euvoc:statu

Denne standarden skal erstatte følgende to standarder:

* https://data.norge.no/specification/forvaltningsstandard-begrepsbeskrivelser/[_Forvaltningsstandard for begrepsbeskrivelser_] (v.2.0.2)
* https://data.norge.no/specification/skos-ap-no-begrep/v1.1[_SKOS-AP-NO-Begrep – Forvaltningsstandard for tilgjengeliggjøring av begrepsbeskrivelser basert på SKOS_] (v.1.1.1)
* https://data.norge.no/specification/forvaltningsstandard-begrepsbeskrivelser/[__Forvaltningsstandard for begrepsbeskrivelser__ &#x29C9;, window="_blank", role="ext-link"] (v.2.0.2)
* https://data.norge.no/specification/skos-ap-no-begrep/v1.1[__SKOS-AP-NO-Begrep – Forvaltningsstandard for tilgjengeliggjøring av begrepsbeskrivelser basert på SKOS__ &#x29C9;, window="_blank", role="ext-link"] (v.1.1.1)

Endringene fra https://data.norge.no/specification/forvaltningsstandard-begrepsbeskrivelser/[_Forvaltningsstandard for begrepsbeskrivelser_] (v.2.0.2) til denne versjonen:
Endringene fra https://data.norge.no/specification/forvaltningsstandard-begrepsbeskrivelser/[__Forvaltningsstandard for begrepsbeskrivelser__ &#x29C9;, window="_blank", role="ext-link"] (v.2.0.2) til denne versjonen:

* *Kravnivå*: Denne versjonen opererer med kravnivåene «obligatorisk» (opplysninger som skal tas med), «anbefalt» (opplysninger som bør tas med hvis de finnes) og «valgfri» (opplysninger som kan tas med), mens forrige versjon har kun «obligatorisk» (uttrykt ved multiplisitet 1..1 eller 1..n) og ellers (ikke-obligatorisk).
* *UML-diagram*: UML-diagrammene i denne versjonen brukes bare til <<Del2>> og ikke <<Del1>>. De er dessuten deskriptive og ikke normative i denne versjonen, mens de var normative i forrige versjon.
Expand Down Expand Up @@ -91,13 +91,13 @@ Endringene fra https://data.norge.no/specification/forvaltningsstandard-begrepsb
** «Term» utgår. Denne var en abstrakt klasse som ikke var ment å brukes i en konkret implementering. Det er dessuten ikke lenger behov for egenskapene i klassen («(dato) sist oppdatert» og «målgruppe»).
** «AnbefaltTerm», «TillattTerm», «FrarådetTerm» og «Datastrukturterm» utgår. Det er ikke lenger behov for egenskapene i disse klassene («(dato) sist oppdatert» og «målgruppe»).

Endringene fra https://data.norge.no/specification/skos-ap-no-begrep/v1.1[_SKOS-AP-NO-Begrep – Forvaltningsstandard for tilgjengeliggjøring av begrepsbeskrivelser basert på SKOS_] (v.1.1.1) til <<Del2>> i denne versjonen:
Endringene fra https://data.norge.no/specification/skos-ap-no-begrep/v1.1[__SKOS-AP-NO-Begrep – Forvaltningsstandard for tilgjengeliggjøring av begrepsbeskrivelser basert på SKOS__ &#x29C9;, window="_blank", role="ext-link"] (v.1.1.1) til <<Del2>> i denne versjonen:

* *Endringene i krav til innhold* nevnt ovenfor, fra https://data.norge.no/specification/forvaltningsstandard-begrepsbeskrivelser/[_Forvaltningsstandard for begrepsbeskrivelser_] (v.2.0.2) til denne versjonen, gjelder også her.
* *Endringene i krav til innhold* nevnt ovenfor, fra https://data.norge.no/specification/forvaltningsstandard-begrepsbeskrivelser/[__Forvaltningsstandard for begrepsbeskrivelser__ &#x29C9;, window="_blank", role="ext-link"] (v.2.0.2) til denne versjonen, gjelder også her.
* *Måten å spesifisere krav til RDF-representasjon på*, er i denne versjonen samkjørt med de andre RDF-baserte spesifikasjoner for informasjonsforvaltning, og dermed betydelig endret fra forrige versjon.
* *Kravnivå*: Denne versjonen spesifiserer eksplisitt kravnivå («obligatorisk», «anbefalt» og «valgfri») samt multiplisitet, mens forrige versjon henviste til kravene i tidligere _Forvaltningsstandard for begrepsbeskrivelser_.
* *URIer for klasser og egenskaper i RDF-representasjon*: URIer for egendefinerte klasser og egenskaper bruker nå engelske ord og uttrykk istedenfor norske i forrige versjon. Selv om URIene ikke er språkavhengige, men fordi standarden gjenbruker SKOS og andre internasjonale vokabularer som bruker engelske ord og uttrykk i URIene sine, er det hensiktsmessig at alle URIer bruker bare engelske ord og uttrykk. Se ellers <<Tabell-endringene-i-URIer>>.
* *Interoperabilitet med resten av EU*: Så langt det er mulig, gjenbruker denne versjonen EU-spesifikasjonen https://github.com/meaningfy-ws/SKOS-AP-EU[SKOS-AP-EU] som EUs Publications Office også bruker.
* *Interoperabilitet med resten av EU*: Så langt det er mulig, gjenbruker denne versjonen EU-spesifikasjonen https://github.com/meaningfy-ws/SKOS-AP-EU[SKOS-AP-EU &#x29C9;, window="_blank", role="ext-link"] som EUs Publications Office også bruker.
* *Detaljerte endringer*: Som nevnt ovenfor er måten å spesifisere krav til RDF-representasjon på betydelig forskjellig fra forrige versjon, det er derfor uhensiktsmessig å beskrive alle endringer med detaljer.

[[Tabell-endringene-i-URIer]]
Expand Down
8 changes: 4 additions & 4 deletions docs/Generelle-krav-formater.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@

Det anbefales å bruke standardiserte formater til å representere følgende datatyper, i intern lagring og maskinell tilgjengeliggjøring eksternt:

* *Dato*: NS-ISO 8601 brukes for intern lagring og maskinell tilgjengeliggjøring eksternt, som `ÅÅÅÅ-MM-DD`.
* *Dato*: NS-ISO 8601 brukes for intern lagring og maskinell tilgjengeliggjøring eksternt, som `ÅÅÅÅ-MM-DD`.

* *URI*: Se kravene i https://www.digdir.no/1492[bruksområdet «Peikarar til offentlege ressursar på nett» i _Referansekatalogen for IT-standardar_].
* *URI*: Se kravene i https://www.digdir.no/1492[bruksområdet «Peikarar til offentlege ressursar på nett» i __Referansekatalogen for IT-standardar__ &#x29C9;, window="_blank", role="ext-link"].

* *Kontaktpunkt* (vcard): Se spesifikasjon fra W3C, https://www.w3.org/TR/vcard-rdf/[_vCard Ontology - for describing People and Organizations_].
* *Kontaktpunkt* (vcard): Se spesifikasjon fra W3C, https://www.w3.org/TR/vcard-rdf/[__vCard Ontology - for describing People and Organizations__ &#x29C9;, window="_blank", role="ext-link"].

* *Tekst*: Se kravene i https://www.digdir.no/1494[bruksområdet «Publisering av tekstdokumenter» i _Referansekatalogen for IT-standardar_].
* *Tekst*: Se kravene i https://www.digdir.no/1494[bruksområdet «Publisering av tekstdokumenter» i __Referansekatalogen for IT-standardar__ &#x29C9;, window="_blank", role="ext-link"].
6 changes: 3 additions & 3 deletions docs/Hvordan-du-leser-del2.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,12 @@ Alle krav i <<Del1>> i denne standarden uttrykkes her i form av RDF. Hvert krav

Det er dette som skal benyttes i RDF-basert utveksling/tilgjengeliggjøring av beskrivelser som er utformet i henhold til denne standarden.

Eksempel: `skos:Concept` er identifikatoren til klassen Begrep (Concept), slik klassen er spesifisert i `skos` (<<Navnerom-brukt-i-standarden>> viser hva `skos` står for).
Eksempel: `skos:Concept` er identifikatoren til klassen Begrep (Concept), slik klassen er spesifisert i `skos` (<<Navnerom-brukt-i-standarden>> viser hva `skos` står for).
| Verdiområde / _Range_ | Denne brukes bare i spesifikasjon av en egenskap, til å spesifisere lovlige verdier. Disse angis ved henvisning til en klasse eller datatype.

Eksempel: Verdiområde `skos:Concept` betyr at verdien til egenskapen skal være en instans av klassen `skos:Concept`.
Eksempel: Verdiområde `skos:Concept` betyr at verdien til egenskapen skal være en instans av klassen `skos:Concept`.
|Anvendelse / _Usage note_ | Brukes til å forklare hva klassen eller egenskapen er ment å brukes til, i kontekst av denne standarden. Forklaringen er også skrevet på engelsk (_Usage note_, kursivert), primært ment for engelsktalende utviklere av verktøystøtte.
| Multiplisitet / _Multiplicity_ | Denne brukes bare i spesifikasjon av en egenskap, til å spesifisere minimum og maksimum antall verdier egenskapen skal/bør/kan ha.
| Kravnivå / _Requirement level_ | Brukes til å spesifisere om klassen eller egenskapen er obligatorisk, anbefalt eller valgfri. Se også <<Kravnivåene-i-denne-standarden>>.
| Kravnivå / _Requirement level_ | Brukes til å spesifisere om klassen eller egenskapen er obligatorisk, anbefalt eller valgfri. Se også <<Kravnivåene-i-denne-standarden>>.
| Merknad / _Note_ | Brukes til merknader knyttet til bruk av klassen eller egenskapen, f.eks. restriksjoner hvis noen. Merknadene er også skrevet på engelsk (_Note_, kursivert), primært ment for engelsktalende utviklere av verktøystøtte.
|===
Loading