Skip to content

Commit

Permalink
Add example on the use of dct:conformsTo with dcat:CatalogRecord
Browse files Browse the repository at this point in the history
  • Loading branch information
andrea-perego committed Mar 23, 2022
1 parent e0c9a48 commit c2c511d
Showing 1 changed file with 26 additions and 7 deletions.
33 changes: 26 additions & 7 deletions dcat/index.html
Expand Up @@ -581,13 +581,14 @@ <h3>Describing catalog records metadata</h3>

<aside id="ex-catalog-record" class="example">
<pre class="nohighlight turtle">
:catalog dcat:record&nbsp;:record-001&nbsp; .
:catalog dcat:record :record-001 .

:record-001
a dcat:CatalogRecord&nbsp;;
foaf:primaryTopic&nbsp;:dataset-001&nbsp; ;
dcterms:issued "2011-12-11"^^xsd:date&nbsp; ;
.</pre>
a dcat:CatalogRecord ;
foaf:primaryTopic :dataset-001 ;
dcterms:issued "2011-12-11"^^xsd:date ;
.
</pre>
</aside>

</section>
Expand Down Expand Up @@ -5472,11 +5473,29 @@ <h3>Conformance to a standard</h3>

<ul>
<li>Use IRIs from reference registries, when available. Examples include the <a href="https://www.w3.org/TR/">W3C TR registry</a>, the <a href="https://www.ogc.org/def-server">OGC Definitions Server</a>, the <a href="https://www.iso.org/obp/ui">ISO OBP</a>.</li>
<li>Use the IRI of the standard / specification, and not the namespace IRI. E.g., to express conformance with DCAT, the IRI to be used is <code>https://www.w3.org.org/TR/vocab-dcat/</code>, and not <code>http://www.w3.org/ns/dcat#</code>.</li>
<li>Use the IRI of the standard / specification, and not the namespace IRI. E.g., to express conformance of a <code>dcat:CatalogRecord</code> with DCAT, the IRI to be used is <code>https://www.w3.org.org/TR/vocab-dcat/</code>, and not <code>http://www.w3.org/ns/dcat#</code>.</li>
<li>Use the canonical, persistent IRI. This is usually specified in the document itself. If you are in doubt, use the one included in the bibliographic citations for that standard / specification.</li>
<li>Use the non-versioned IRI. If you need to express conformance with a specific version of the standard / specification, use both the un-versioned and the versioned IRI. E.g., in case you need to explictly state conformance with DCAT 2, use both <code>https://www.w3.org.org/TR/vocab-dcat/</code> and <code>https://www.w3.org.org/TR/vocab-dcat-2/</code>.</li>
<li>Use the non-versioned IRI. If you need to express conformance with a specific version of the standard / specification, use both the un-versioned and the versioned IRI. E.g., in case you need to explictly state conformance of a <code>dcat:CatalogRecord</code> with DCAT 2, use both <code>https://www.w3.org.org/TR/vocab-dcat/</code> and <code>https://www.w3.org.org/TR/vocab-dcat-2/</code>.</li>
</ul>

<!-- @andrea-perego: added example on how to specify the metadata schema of a catalog record -->

<p><a href="#ex-catalog-record-schema"></a> extends <a href="#ex-catalog-record"></a> to show how to specify that a given catalog record is conformant with DCAT, by following the above rules.</p>

<aside class="example" id="ex-catalog-record-schema">
<pre class="nohighlight turtle">
:catalog dcat:record :record-001 .

:record-001
a dcat:CatalogRecord ;
foaf:primaryTopic :dataset-001 ;
dcterms:issued "2011-12-11"^^xsd:date ;
dcterms:conformsTo &lt;https://www.w3.org.org/TR/vocab-dcat/&gt; ;
.
</pre>
</aside>


<!--
<p><a href="#ex-standards-uris"></a> shows the IRIs of some of the standards used in this document.</p>
-->
Expand Down

0 comments on commit c2c511d

Please sign in to comment.