Skip to content

Commit

Permalink
fix(docs): resources lists formatting
Browse files Browse the repository at this point in the history
  • Loading branch information
Lillebo committed Oct 4, 2024
1 parent c99df2b commit 7d5e9d4
Show file tree
Hide file tree
Showing 3 changed files with 110 additions and 56 deletions.
53 changes: 35 additions & 18 deletions apps/docs/public/content/docs/resources/resources.en.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,33 +9,50 @@ description: Here you will find more resources that can help you create descript

Data.norge.no relies on several standards and specifications. Which standard/specification you should use depends on the type of resource (dataset, concept, service, etc.) you are describing.

- Standard for describing datasets, data services og datacatalogs ([DCAT-AP-NO](https://data.norge.no/specification/dcat-ap-no))
- Governance standard for concept descriptions ([SKOS-AP-NO-Begrep](https://data.norge.no/specification/skos-ap-no-begrep))
- Specification for describing information models ([ModelDCAT-AP-NO](https://data.norge.no/specification/modelldcat-ap-no))
- Specification for describing services and events ([CPSV-AP-NO](https://data.norge.no/specification/cpsv-ap-no))
- [DCAT-AP-NO](https://data.norge.no/specification/dcat-ap-no)
Standard for describing datasets, data services, and data catalogs.
- [SKOS-AP-NO-Begrep](https://data.norge.no/specification/skos-ap-no-begrep)
Governance standard for concept descriptions.
- [ModelDCAT-AP-NO](https://data.norge.no/specification/modelldcat-ap-no)
Specification for describing information models.
- [CPSV-AP-NO](https://data.norge.no/specification/cpsv-ap-no)
Specification for describing services and events.

## Resources

- [Showroom on data.norge.no](https://data.norge.no/showroom/overview) with examples of descriptions and their interconnections.
- [Template for a dataset description in Turtle format (Data.norge.no on Github)](https://github.com/fellesdatakatalog/sikt-workshop/blob/main/example-template.ttl).
- [Showroom on data.norge.no](https://data.norge.no/showroom/overview)
Examples of descriptions and their interconnections.
- [Template for a dataset description in Turtle format (Data.norge.no on Github)](https://github.com/fellesdatakatalog/sikt-workshop/blob/main/example-template.ttl)
- [Example of a dataset description in Turtle (Data.norge.no on Github)](https://github.com/Informasjonsforvaltning/dcat-ap-no/blob/4d09617568f0f353b336ddd966b2228dc35f084e/examples/test.ttl)
- [Guide for Order in Your Own House](https://www.digdir.no/informasjonsforvaltning/veileder-orden-i-eget-hus/2716)
- [DCAT-AP 3](https://semiceu.github.io/DCAT-AP/releases/3.0.0/#DataService) from the EU that DCAT-AP-NO is based on.
- [DCAT 3](https://www.w3.org/TR/vocab-dcat-3/) from W3C that DCAT-AP is based on.
- [Online trainings (SEMIC Support Centre)](https://joinup.ec.europa.eu/collection/semic-support-centre/online-trainings), courses in the vocabularies and specifications from the EU.
- [DCAT-AP 3](https://semiceu.github.io/DCAT-AP/releases/3.0.0/#DataService)
DCAT-AP 3 from the EU that DCAT-AP-NO is based on.
- [DCAT 3](https://www.w3.org/TR/vocab-dcat-3/)
DCAT 3 from W3C that DCAT-AP is based on.
- [Online trainings (SEMIC Support Centre)](https://joinup.ec.europa.eu/collection/semic-support-centre/online-trainings)
Courses in the vocabularies and specifications from the EU.

## Tools Offered by Data.norge.no

Data.norge.no provides several open libraries and tools that can assist in creating descriptions.

- [datacatalogtordf](https://github.com/Informasjonsforvaltning/datacatalogtordf): Python library that maps data catalogs to an RDF graph according to DCAT-AP-NO.
- [concepttordf](https://github.com/Informasjonsforvaltning/concepttordf): Python library that maps concept catalogs to an RDF graph according to SKOS-AP-NO.
- [modelldcatnotordf](https://github.com/Informasjonsforvaltning/modelldcatnotordf): Python library that maps information model catalogs to RDF graph according to ModelDCAT-AP-NO.
- [servicecatalogtordf](https://github.com/Informasjonsforvaltning/servicecatalogtordf): Python library that maps service and/or event catalogs to an RDF graph according to CPSV-AP-NO.
- [oastodcat](https://github.com/Informasjonsforvaltning/oastodcat): Python library that transforms an OpenAPI specification into instances of dcat:DataService (DCAT-AP-NO).
- [atlasdcat](https://github.com/Informasjonsforvaltning/atlasdcat): Python library that maps from Apache Atlas Glossary terms to DCAT metadata and vice versa.
- [jsonschematordf](https://github.com/Informasjonsforvaltning/jsonschematordf): Python library that maps from JSON Schema to an RDF graph according to ModelDCAT-AP-NO.
- [Validation tool](https://data.norge.no/validator): Validates dataset descriptions (DCAT-AP-NO), concept descriptions (SKOS-AP-NO), and service and event descriptions (CPSV-AP-NO) in RDF format.
- [SPARQL user interface](https://data.norge.no/sparql): Tool that allows you
- [datacatalogtordf](https://github.com/Informasjonsforvaltning/datacatalogtordf)
Python library that maps data catalogs to an RDF graph according to DCAT-AP-NO.
- [concepttordf](https://github.com/Informasjonsforvaltning/concepttordf)
Python library that maps concept catalogs to an RDF graph according to SKOS-AP-NO.
- [modelldcatnotordf](https://github.com/Informasjonsforvaltning/modelldcatnotordf)
Python library that maps information model catalogs to an RDF graph according to ModelDCAT-AP-NO.
- [servicecatalogtordf](https://github.com/Informasjonsforvaltning/servicecatalogtordf)
Python library that maps service and/or event catalogs to an RDF graph according to CPSV-AP-NO.
- [oastodcat](https://github.com/Informasjonsforvaltning/oastodcat)
Python library that transforms an OpenAPI specification into instances of `dcat:DataService` (DCAT-AP-NO).
- [atlasdcat](https://github.com/Informasjonsforvaltning/atlasdcat)
Python library that maps from Apache Atlas Glossary terms to DCAT metadata and vice versa.
- [jsonschematordf](https://github.com/Informasjonsforvaltning/jsonschematordf)
Python library that maps from JSON Schema to an RDF graph according to ModelDCAT-AP-NO.
- [Validation tool](https://data.norge.no/validator)
Validates dataset descriptions (DCAT-AP-NO), concept descriptions (SKOS-AP-NO), and service and event descriptions (CPSV-AP-NO) in RDF format.
- [SPARQL user interface](https://data.norge.no/sparql)
Tool that allows you to perform SPARQL queries on the content of Data.norge.no.

If you discover errors or omissions in these, please create an issue in the repository or [contact us](/contact).
60 changes: 40 additions & 20 deletions apps/docs/public/content/docs/resources/resources.nb.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,33 +9,53 @@ description: Her finner du flere ressurser som kan hjelpe deg med å lage beskri

Data.norge.no baserer seg på flere standardar og spesifikasjonar. Hvilken standard/spesifikasjon du skal bruke kommer an på hvilken type ressurs (datasett, begrep, tjeneste, osv.) du skal beskrive.

- Standard for beskrivelse av datasett, datatjenester og datakataloger ([DCAT-AP-NO](https://data.norge.no/specification/dcat-ap-no))
- Forvaltningsstandard for begrepsbeskrivelser ([SKOS-AP-NO-Begrep](https://data.norge.no/specification/skos-ap-no-begrep))
- Spesifikasjon for beskrivelse av informasjonsmodeller ([ModellDCAT-AP-NO](https://data.norge.no/specification/modelldcat-ap-no))
- Spesifikasjon for tjeneste- og hendelsesbeskrivelser ([CPSV-AP-NO](https://data.norge.no/specification/cpsv-ap-no))
- [DCAT-AP-NO](https://data.norge.no/specification/dcat-ap-no)
Standard for beskrivelse av datasett, datatjenester og datakataloger.
- [SKOS-AP-NO-Begrep](https://data.norge.no/specification/skos-ap-no-begrep)
Forvaltningsstandard for begrepsbeskrivelser.
- [ModellDCAT-AP-NO](https://data.norge.no/specification/modelldcat-ap-no)
Spesifikasjon for beskrivelse av informasjonsmodeller.
- [CPSV-AP-NO](https://data.norge.no/specification/cpsv-ap-no)
Spesifikasjon for tjeneste- og hendelsesbeskrivelser.

## Ressurser

- [Showroom på data.norge.no](https://data.norge.no/showroom/overview) med eksempler på beskrivelser og sammenhengene mellom dem.
- [Mal for en datasettbeskrivelse i Turtle-format (Data.norge.no på Github)](https://github.com/fellesdatakatalog/sikt-workshop/blob/main/example-template.ttl).
- [Eksempel på datasettbeskrivelse i Turtle (Data.norge.no på Github)](https://github.com/Informasjonsforvaltning/dcat-ap-no/blob/4d09617568f0f353b336ddd966b2228dc35f084e/examples/test.ttl)
- [Veileder for Orden i eget hus](https://www.digdir.no/informasjonsforvaltning/veileder-orden-i-eget-hus/2716)
- [DCAT-AP 3](https://semiceu.github.io/DCAT-AP/releases/3.0.0/#DataService) fra EU som DCAT-AP-NO er basert på.
- [DCAT 3](https://www.w3.org/TR/vocab-dcat-3/) fra W3C som DCAT-AP er basert på.
- [Online trainings (SEMIC Support Centre)](https://joinup.ec.europa.eu/collection/semic-support-centre/online-trainings), kurs i vokabularene og spesifikasjonene fra EU.
- [Showroom på data.norge.no](https://data.norge.no/showroom/overview)
Eksempler på beskrivelser og sammenhengene mellom dem.
- [Mal for en datasettbeskrivelse i Turtle-format (Data.norge.no på Github)](https://github.com/fellesdatakatalog/sikt-workshop/blob/main/example-template.ttl)
Mal for en datasettbeskrivelse som kan brukes som utgangspunkt.
- [Eksempel på datasettbeskrivelse i Turtle (Data.norge.no på Github)](https://github.com/Informasjonsforvaltning/dcat-ap-no/blob/4d09617568f0f353b336ddd966b2228dc35f084e/examples/test.ttl)
Eksempel på hvordan en datasettbeskrivelse kan se ut i Turtle-format.
- [Veileder for Orden i eget hus](https://www.digdir.no/informasjonsforvaltning/veileder-orden-i-eget-hus/2716)
En veileder for hvordan å organisere og beskrive informasjon.
- [DCAT-AP 3](https://semiceu.github.io/DCAT-AP/releases/3.0.0/#DataService)
DCAT-AP 3 fra EU som DCAT-AP-NO er basert på.
- [DCAT 3](https://www.w3.org/TR/vocab-dcat-3/)
DCAT 3 fra W3C som DCAT-AP er basert på.
- [Online trainings (SEMIC Support Centre)](https://joinup.ec.europa.eu/collection/semic-support-centre/online-trainings)
Kurs i vokabularene og spesifikasjonene fra EU.

## Verktøy Data.norge.no tilbyr

Data.norge.no har flere åpne biblioteker og verktøy som kan hjelpe i arbeidet med å lage beskrivelser.

- [datacatalogtordf](https://github.com/Informasjonsforvaltning/datacatalogtordf): Python-bibliotek som mapper datakataloger til en RDF-graf i henhold til DCAT-AP-NO.
- [concepttordf](https://github.com/Informasjonsforvaltning/concepttordf): Python-bibliotek som mapper begrepskataloger til en RDF-graf i henhold til SKOS-AP-NO.
- [modelldcatnotordf](https://github.com/Informasjonsforvaltning/modelldcatnotordf): Python-bibliotek som mapper informasjonsmodellkataloger til RDF-graf i henhold til ModellDCAT-AP-NO.
- [servicecatalogtordf](https://github.com/Informasjonsforvaltning/servicecatalogtordf): Python-bibliotek som mapper tjeneste- og/eller hendelseskataloger til en RDF-graf i henhold til CPSV-AP-NO.
- [oastodcat](https://github.com/Informasjonsforvaltning/oastodcat): Python-bibliotek som transformerer en OpenAPI-spesifikasjon til instans(er) av dcat:DataService (DCAT-AP-NO).
- [atlasdcat](https://github.com/Informasjonsforvaltning/atlasdcat): Python-bibliotek som mapper Apache Atlas Glossary terms til DCAT metadata og omvendt.
- [jsonschematordf](https://github.com/Informasjonsforvaltning/jsonschematordf): Python-bibliotek som mapper fra JSON Schema til en RDF-graf i henhold til ModellDCAT-AP-NO.
- [Valideringsverktøy](https://data.norge.no/validator): Validerer datasettbeskrivelser (DCAT-AP-NO), begrepsbeskrivelser (SKOS-AP-NO) og tjeneste- og hendelsesbeskrivelser (CPSV-AP-NO) i RDF-format.
- [SPARQL-brukergrensesnitt](https://data.norge.no/sparql): Verktøy som lar deg gjøre SPARQL-spørringer på innholdet i Data.norge.no.
- [datacatalogtordf](https://github.com/Informasjonsforvaltning/datacatalogtordf)
Python-bibliotek som mapper datakataloger til en RDF-graf i henhold til DCAT-AP-NO.
- [concepttordf](https://github.com/Informasjonsforvaltning/concepttordf)
Python-bibliotek som mapper begrepskataloger til en RDF-graf i henhold til SKOS-AP-NO.
- [modelldcatnotordf](https://github.com/Informasjonsforvaltning/modelldcatnotordf)
Python-bibliotek som mapper informasjonsmodellkataloger til RDF-graf i henhold til ModellDCAT-AP-NO.
- [servicecatalogtordf](https://github.com/Informasjonsforvaltning/servicecatalogtordf)
Python-bibliotek som mapper tjeneste- og/eller hendelseskataloger til en RDF-graf i henhold til CPSV-AP-NO.
- [oastodcat](https://github.com/Informasjonsforvaltning/oastodcat)
Python-bibliotek som transformerer en OpenAPI-spesifikasjon til instans(er) av dcat:DataService (DCAT-AP-NO).
- [atlasdcat](https://github.com/Informasjonsforvaltning/atlasdcat)
Python-bibliotek som mapper Apache Atlas Glossary terms til DCAT metadata og omvendt.
- [jsonschematordf](https://github.com/Informasjonsforvaltning/jsonschematordf)
Python-bibliotek som mapper fra JSON Schema til en RDF-graf i henhold til ModellDCAT-AP-NO.
- [Valideringsverktøy](https://data.norge.no/validator)
Validerer datasettbeskrivelser (DCAT-AP-NO), begrepsbeskrivelser (SKOS-AP-NO) og tjeneste- og hendelsesbeskrivelser (CPSV-AP-NO) i RDF-format.
- [SPARQL-brukergrensesnitt](https://data.norge.no/sparql)
Verktøy som lar deg gjøre SPARQL-spørringer på innholdet i Data.norge.no.

Kommer du over feil eller mangler i disse, opprett gjerne et issue i repoet eller [kontakt oss](/contact).
53 changes: 35 additions & 18 deletions apps/docs/public/content/docs/resources/resources.nn.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,33 +9,50 @@ description: Her finn du fleire ressursar som kan hjelpe deg med å lage beskriv

Data.norge.no baserer seg på flere standarder og spesifikasjoner. Kva standard/spesifikasjon du skal bruke avhenger av typen ressurs (datasett, omgrep, teneste, osv.) du skal beskrive.

- Standard for beskriving av datasett, datatenester og datakatalogar ([DCAT-AP-NO](https://data.norge.no/specification/dcat-ap-no))
- Forvaltningsstandard for beskriving av omgrep ([SKOS-AP-NO-Begrep](https://data.norge.no/specification/skos-ap-no-begrep))
- Spesifikasjon for beskriving av informasjonsmodellar ([ModellDCAT-AP-NO](https://data.norge.no/specification/modelldcat-ap-no))
- Spesifikasjon for beskriving av tenester og hendingar ([CPSV-AP-NO](https://data.norge.no/specification/cpsv-ap-no))
- [DCAT-AP-NO](https://data.norge.no/specification/dcat-ap-no)
Standard for beskriving av datasett, datatenester og datakatalogar.
- [SKOS-AP-NO-Begrep](https://data.norge.no/specification/skos-ap-no-begrep)
Forvaltningsstandard for beskriving av omgrep.
- [ModellDCAT-AP-NO](https://data.norge.no/specification/modelldcat-ap-no)
Spesifikasjon for beskriving av informasjonsmodellar.
- [CPSV-AP-NO](https://data.norge.no/specification/cpsv-ap-no)
Spesifikasjon for beskriving av tenester og hendingar.

## Ressursar

- [Showroom på data.norge.no](https://data.norge.no/showroom/overview) med døme på beskrivingar og samanhengane mellom dei.
- [Mal for ein datasettbeskriving i Turtle-format (Data.norge.no på Github)](https://github.com/fellesdatakatalog/sikt-workshop/blob/main/example-template.ttl).
- [Showroom på data.norge.no](https://data.norge.no/showroom/overview)
Døme på beskrivingar og samanhengane mellom dei.
- [Mal for ein datasettbeskriving i Turtle-format (Data.norge.no på Github)](https://github.com/fellesdatakatalog/sikt-workshop/blob/main/example-template.ttl)
- [Døme på datasettbeskriving i Turtle (Data.norge.no på Github)](https://github.com/Informasjonsforvaltning/dcat-ap-no/blob/4d09617568f0f353b336ddd966b2228dc35f084e/examples/test.ttl)
- [Veileder for Orden i eige hus](https://www.digdir.no/informasjonsforvaltning/veileder-orden-i-eget-hus/2716)
- [DCAT-AP 3](https://semiceu.github.io/DCAT-AP/releases/3.0.0/#DataService) frå EU som DCAT-AP-NO er basert på.
- [DCAT 3](https://www.w3.org/TR/vocab-dcat-3/) frå W3C som DCAT-AP er basert på.
- [Online training (SEMIC Support Centre)](https://joinup.ec.europa.eu/collection/semic-support-centre/online-trainings), kurs i vokabulara og spesifikasjonane frå EU.
- [DCAT-AP 3](https://semiceu.github.io/DCAT-AP/releases/3.0.0/#DataService)
Frå EU som DCAT-AP-NO er basert på.
- [DCAT 3](https://www.w3.org/TR/vocab-dcat-3/)
Frå W3C som DCAT-AP er basert på.
- [Online training (SEMIC Support Centre)](https://joinup.ec.europa.eu/collection/semic-support-centre/online-trainings)
Kurs i vokabulara og spesifikasjonane frå EU.

## Verktøy Data.norge.no tilbyr

Data.norge.no har fleire opne bibliotek og verktøy som kan hjelpe i arbeidet med å lage beskrivingar.

- [datacatalogtordf](https://github.com/Informasjonsforvaltning/datacatalogtordf): Python-bibliotek som mapper datakatalogar til ein RDF-graf i samsvar med DCAT-AP-NO.
- [concepttordf](https://github.com/Informasjonsforvaltning/concepttordf): Python-bibliotek som mapper omgrepskatalogar til ein RDF-graf i samsvar med SKOS-AP-NO.
- [modelldcatnotordf](https://github.com/Informasjonsforvaltning/modelldcatnotordf): Python-bibliotek som mapper informasjonsmodellkatalogar til RDF-graf i samsvar med ModellDCAT-AP-NO.
- [servicecatalogtordf](https://github.com/Informasjonsforvaltning/servicecatalogtordf): Python-bibliotek som mapper teneste- og/eller hendingeskatalogar til ein RDF-graf i samsvar med CPSV-AP-NO.
- [oastodcat](https://github.com/Informasjonsforvaltning/oastodcat): Python-bibliotek som transformerer ein OpenAPI-spesifikasjon til instans(ar) av dcat:DataService (DCAT-AP-NO).
- [atlasdcat](https://github.com/Informasjonsforvaltning/atlasdcat): Python-bibliotek som mapper Apache Atlas Glossary terms til DCAT metadata og omvendt.
- [jsonschematordf](https://github.com/Informasjonsforvaltning/jsonschematordf): Python-bibliotek som mapper frå JSON Schema til ein RDF-graf i samsvar med ModellDCAT-AP-NO.
- [Valideringsverktøy](https://data.norge.no/validator): Validerer datasettbeskrivingar (DCAT-AP-NO), omgrepsbeskrivingar (SKOS-AP-NO) og teneste- og hendingesbeskrivingar (CPSV-AP-NO) i RDF-format.
- [SPARQL-brukargrensesnitt](https://data.norge.no/sparql): Verktøy som lar deg gjere SPARQL-spørjingar på innhaldet i Data.norge.no.
- [datacatalogtordf](https://github.com/Informasjonsforvaltning/datacatalogtordf)
Python-bibliotek som mapper datakatalogar til ein RDF-graf i samsvar med DCAT-AP-NO.
- [concepttordf](https://github.com/Informasjonsforvaltning/concepttordf)
Python-bibliotek som mapper omgrepskatalogar til ein RDF-graf i samsvar med SKOS-AP-NO.
- [modelldcatnotordf](https://github.com/Informasjonsforvaltning/modelldcatnotordf)
Python-bibliotek som mapper informasjonsmodellkatalogar til RDF-graf i samsvar med ModellDCAT-AP-NO.
- [servicecatalogtordf](https://github.com/Informasjonsforvaltning/servicecatalogtordf)
Python-bibliotek som mapper teneste- og/eller hendingeskatalogar til ein RDF-graf i samsvar med CPSV-AP-NO.
- [oastodcat](https://github.com/Informasjonsforvaltning/oastodcat)
Python-bibliotek som transformerer ein OpenAPI-spesifikasjon til instans(ar) av `dcat:DataService` (DCAT-AP-NO).
- [atlasdcat](https://github.com/Informasjonsforvaltning/atlasdcat)
Python-bibliotek som mapper Apache Atlas Glossary terms til DCAT metadata og omvendt.
- [jsonschematordf](https://github.com/Informasjonsforvaltning/jsonschematordf)
Python-bibliotek som mapper frå JSON Schema til ein RDF-graf i samsvar med ModellDCAT-AP-NO.
- [Valideringsverktøy](https://data.norge.no/validator)
Validerer datasettbeskrivingar (DCAT-AP-NO), omgrepsbeskrivingar (SKOS-AP-NO) og teneste- og hendingesbeskrivingar (CPSV-AP-NO) i RDF-format.
- [SPARQL-brukargrensesnitt](https://data.norge.no/sparql)
Verktøy som lar deg gjere SPARQL-spørjingar på innhaldet i Data.norge.no.

Om du oppdagar feil eller manglar i desse, opprett gjerne eit issue i repoet eller [kontakt oss](/contact).

0 comments on commit 7d5e9d4

Please sign in to comment.