add documentation on distribution

opendata-swiss · Dec 12, 2023 · 825db0c · 825db0c
1 parent 388f08c
commit 825db0c
Show file tree

Hide file tree

Showing 5 changed files with 59 additions and 3 deletions.
diff --git a/source/content/glossar/bibliothek/dcat-ap-ch.rst b/source/content/glossar/bibliothek/dcat-ap-ch.rst
@@ -277,7 +277,7 @@ Translatable elements are marked as such under usage notes.
       - dcat:qualifiedRelation
       - optional :fa:`exclamation` replaces the property rdfs:seeAlso
     * - :fa:`exclamation` :ref:`documentation <dcat-dataset-documentation>`
-      - dct:documentation
+      - foaf:page
       - optional, :fa:`exclamation` new property
     * - :fa:`exclamation` :ref:`conforms to <dcat-dataset-conforms-to>`
       - dct:conformsTo
@@ -334,6 +334,9 @@ Translatable elements are marked as such under usage notes.
     * - :ref:`coverage <dcat-distribution-coverage>`
       - dct:coverage
       - optional
+    * - :fa:`exclamation` :ref:`documentation <dcat-distribution-documentation>`
+      - foaf:page
+      - optional, :fa:`exclamation` new property
 
 .. _dcat-ap-ch-catalog:
 
@@ -1123,3 +1126,22 @@ dct:license (DCAT)
     :header: Property ``dct:license`` of ``dcat:Distribution`` in Rdf/xml
 
     .. include:: dcat-examples/distribution-license-rdf.rst
+
+.. _dcat-distribution-documentation:
+
+foaf:page (DCAT)
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. container:: Mapping
+
+    .. include:: dcat-definitions/distribution-documentation.rst
+
+.. toggle-header::
+    :header: Property ``foaf:page`` of ``dcat:Distribution`` in Turtle
+
+    .. include:: dcat-examples/distribution-documentation-ttl.rst
+
+.. toggle-header::
+    :header: Property ``foaf:page`` of ``dcat:Distribution`` in Rdf/xml
+
+    .. include:: dcat-examples/distribution-documentation-rdf.rst
diff --git a/source/content/glossar/bibliothek/dcat-definitions/dataset-documentation.rst b/source/content/glossar/bibliothek/dcat-definitions/dataset-documentation.rst
@@ -1,6 +1,6 @@
-:DCAT URI: dct:documentation
+:DCAT URI: foaf:page
 :Domain: dcat:Dataset
-:Value: ``foaf:page``
+:Value: ``foaf:Document``
 :Requirement Level: Optional
 :Cardinality: 0..n
 :Description: documentation

diff --git a/source/content/glossar/bibliothek/dcat-definitions/distribution-documentation.rst b/source/content/glossar/bibliothek/dcat-definitions/distribution-documentation.rst
@@ -0,0 +1,7 @@
+:DCAT URI: foaf:page
+:Domain: dcat:Distribution
+:Value: ``foaf:Document``
+:Requirement Level: Optional
+:Cardinality: 0..n
+:Description: documentation
+:Usage Notes: This property refers to a page or document about this Distribution.
diff --git a/source/content/glossar/bibliothek/dcat-examples/distribution-documentation-rdf.rst b/source/content/glossar/bibliothek/dcat-examples/distribution-documentation-rdf.rst
@@ -0,0 +1,14 @@
+.. code-block:: xml
+    :emphasize-lines: 8,9
+
+    <?xml version="1.0" encoding="utf-8" ?>
+    <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+             xmlns:dcat="http://www.w3.org/ns/dcat#"
+             xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
+             xmlns:foaf="http://xmlns.com/foaf/0.1/">
+
+      <dcat:Distribution rdf:about="https://bag/covid-19">
+        <foaf:Document rdf:about="https://www.covid19.admin.ch/api/data/documentation#data-context-api"/>    
+      </dcat:Distribution>
+
+    </rdf:RDF>
diff --git a/source/content/glossar/bibliothek/dcat-examples/distribution-documentation-ttl.rst b/source/content/glossar/bibliothek/dcat-examples/distribution-documentation-ttl.rst
@@ -0,0 +1,13 @@
+.. code-block:: Turtle
+    :emphasize-lines: 6,7,8,9,10
+
+    @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+    @prefix dcat: <http://www.w3.org/ns/dcat#> .
+    @prefix foaf: <http://xmlns.com/foaf/0.1/> .
+    
+    <https://bag/covid-19> a dcat:Distribution ;
+	      foaf:Document [
+		        rdf:about "https://www.covid19.admin.ch/api/data/documentation#data-context-api" 
+	      ] .
+
+