Skip to content

Commit

Permalink
Merge branch 'gh-pages' into dcat-issue-1513
Browse files Browse the repository at this point in the history
  • Loading branch information
@riccardoAlbertoni
riccardoAlbertoni committed Jun 2, 2022
2 parents 8be4f24 + 5b5d965 commit 77b2c3e
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 36 deletions.
18 changes: 10 additions & 8 deletions README.md
View file
Expand Up @@ -9,15 +9,17 @@ This repository contains the *Dataset Catalogue Vocabulary* (DCAT) work of the *
## DCAT Working Documents

- [Editors' Draft](https://w3c.github.io/dxwg/dcat/)
- [Proposed Recommendation (PR)](https://www.w3.org/TR/2019/PR-vocab-dcat-2-20191119/)
- [Candidate Recommendation (CR)](https://www.w3.org/TR/2019/CR-vocab-dcat-2-20191003/)
- [Third Public Working Draft (TPWD)](https://www.w3.org/TR/2019/WD-vocab-dcat-2-20190528/)
- [Second Public Working Draft (SPWD)](https://www.w3.org/TR/2018/WD-vocab-dcat-2-20181016/)
- [First Public Working Draft (FPWD)](https://www.w3.org/TR/2018/WD-vocab-dcat-2-20180508/)
- [Latest published version](https://www.w3.org/TR/vocab-dcat-3/)
- [Fourth Public Working Draft (4PWD)](https://www.w3.org/TR/2022/WD-vocab-dcat-3-20220510/)
- [Third Public Working Draft (3PWD)](https://www.w3.org/TR/2022/WD-vocab-dcat-3-20220111/)
- [Second Public Working Draft (2PWD)](https://www.w3.org/TR/2021/WD-vocab-dcat-3-20210504/)
- [First Public Working Draft (FPWD)](https://www.w3.org/TR/2020/WD-vocab-dcat-3-20201217/)

## Other DXWG Documents

- [DXWG Use cases and requirements](https://w3c.github.io/dxwg/ucr/)
- [Guidance for Application Profiles](https://w3c.github.io/dxwg/profiles/)
- [DXWG Use cases and requirements (Working Group Note)](https://www.w3.org/TR/dcat-ucr/)
- [Guidance for Application Profiles (Editors' Draft)](https://w3c.github.io/dxwg/profiles/)
- [The Profiles Vocabulary (Editors' Draft)](https://w3c.github.io/dx-prof/)
- [Content Negotiation by Profile (Editors' Draft)](https://w3c.github.io/dx-connegp/)
- Dedicated repository: https://github.com/w3c/dx-prof
- [Content Negotiation by Profile (Editors' Draft)](https://w3c.github.io/dx-connegp/)
- Dedicated repository: https://github.com/w3c/dx-connegp
1 change: 1 addition & 0 deletions dcat/config.js
View file
@@ -1,4 +1,5 @@
var respecConfig = {
doJsonLd: true,
// preProcess: [dfn_index],
// subtitle: "Version 2",
specStatus: "ED",
Expand Down
81 changes: 53 additions & 28 deletions dcat/index.html
View file
Expand Up @@ -262,7 +262,7 @@ <h3>DCAT scope</h3>
DCAT is based around seven main classes (<a href="#fig-dcat-all-attributes"></a>):</p>
<ul>
<li>
<a href="#Class:Catalog"><code>dcat:Catalog</code></a> represents a catalog, which is a dataset in which each individual item is a metadata record describing some resource; the scope of <code>dcat:Catalog</code> is collections of metadata about <b>datasets</b> or <b>data services</b>.
<a href="#Class:Catalog"><code>dcat:Catalog</code></a> represents a catalog, which is a dataset in which each individual item is a metadata record describing some resource; the scope of <code>dcat:Catalog</code> is collections of metadata about <b>datasets</b>, <b>data services</b>, or other resource types.
</li>
<li>
<a href="#Class:Resource"><code>dcat:Resource</code></a> represents a dataset, a data service or any other resource that may be described by a metadata record in a catalog.
Expand Down Expand Up @@ -524,7 +524,7 @@ <h3>Classifying dataset types</h3>
such as the <a data-cite="?DCTERMS#section-7">DCMI Type Vocabulary</a> [[?DCTERMS]],
the <a href="https://id.loc.gov/vocabulary/marcgt.html">MARC Genre/Terms Scheme</a>,
the [[?ISO-19115-1]] <a href="https://standards.iso.org/iso/19115/resources/Codelists/gml/MD_ScopeCode.xml"><code>MD_Scope codes</code></a>,
the <a href="https://schema.datacite.org/meta/kernel-4.1/include/datacite-resourceType-v4.1.xsd">DataCite resource types</a>,
the <a href="https://schema.datacite.org/meta/kernel-4.4/include/datacite-resourceType-v4.xsd">DataCite resource types</a> [[?DataCite]],
or the PARSE.Insight content-types from Re3data [[?RE3DATA-SCHEMA]].
</p>
<p>
Expand Down Expand Up @@ -560,12 +560,12 @@ <h3>Classifying dataset types</h3>

&lt;http://registry.it.csiro.au/def/datacite/resourceType/Dataset&gt;
rdfs:label "Dataset"@en ;
dcterms:source "DataCite resource types"@en ;
dcterms:source [ rdfs:label "DataCite resource types"@en ] ;
.

&lt;http://registry.it.csiro.au/def/re3data/contentType/database&gt;
rdfs:label "Database"@en ;
dcterms:source "Re3data content types"@en ;
dcterms:source [ rdfs:label "Re3data content types"@en ] ;
.</pre>
</aside>

Expand Down Expand Up @@ -719,17 +719,25 @@ <h3>RDF representation</h3>
<p>New RDF serializations will be made available for DCAT 3 as soon as the vocabulary is finalized.</p>
</aside>
<p>The (revised) DCAT vocabulary is <a href="https://www.w3.org/ns/dcat#">available in RDF</a>.
The primary artifact <a href="https://www.w3.org/ns/dcat2.ttl"><code>dcat2.ttl</code></a> is a serialization of the core DCAT vocabulary.
The primary artifact <a href="https://www.w3.org/ns/dcat.ttl"><code>dcat.ttl</code></a> is a serialization of the core DCAT vocabulary.
Alongside it are a set of other RDF files that provide additional information, including:</p>
<ol>
<li>
non-normative alignments to other vocabularies, provided for guidance
<!-- EDNOTE: None of these are listed in https://www.w3.org/ns/dcat#
<li>
Non-normative alignments to other vocabularies, provided for guidance.
</li>
<li>
additional axioms, which can be useful in some contexts
Additional axioms, which can be useful in some contexts.
</li>
-->
<li>
<p>The files <a href="https://www.w3.org/ns/dcat-external.ttl">dcat-external.ttl</a>, <a href="https://www.w3.org/ns/dcat-external.rdf">dcat-external.rdf</a>, and <a href="https://www.w3.org/ns/dcat-external.jsonld">dcat-external.jsonld</a> includes externally defined terms where DCAT has provided additional documentation or usage notes.</p>
</li>
<li>
<p>The files <a href="https://www.w3.org/ns/dcat2.ttl">dcat2.ttl</a>, <a href="https://www.w3.org/ns/dcat2.rdf">dcat2.rdf</a>, and <a href="https://www.w3.org/ns/dcat2.jsonld">dcat2.jsonld</a> that correspond to version 2 of DCAT [[?VOCAB-DCAT-2]].</p>
</li>
<li>
the files <a href="https://www.w3.org/ns/dcat2014.ttl">dcat2014.ttl</a> and <a href="https://www.w3.org/ns/dcat2014.rdf">dcat2014.rdf</a> that correspond to the 2014 version of DCAT [[?VOCAB-DCAT-1]]
The files <a href="https://www.w3.org/ns/dcat2014.ttl">dcat2014.ttl</a> and <a href="https://www.w3.org/ns/dcat2014.rdf">dcat2014.rdf</a> that correspond to the 2014 version of DCAT [[?VOCAB-DCAT-1]].
</li>
</ol>

Expand Down Expand Up @@ -4148,7 +4156,7 @@ <h2>Indicating common identifier types</h2>
skos:notation "info:doi/10.1109/5.771073"^^xsd:anyURI .</pre>
</aside>

<p>Otherwise, examples of common types for identifier scheme (<a href="https://arxiv.org/help/arxiv_identifier">arXiv</a>, etc.) are defined in <a href="https://schema.datacite.org/meta/kernel-4.1/include/datacite-relatedIdentifierType-v4.xsd">DataCite schema</a> and <a href="https://fairsharing.org/standards/?q=&selected_facets=type_exact:identifier%20schema">FAIRsharing Registry</a>.</p>
<p>Otherwise, examples of common types for identifier scheme (<a href="https://arxiv.org/help/arxiv_identifier">arXiv</a>, etc.) are defined in <a href="https://schema.datacite.org/meta/kernel-4.4/include/datacite-relatedIdentifierType-v4.xsd">DataCite schema</a> [[?DataCite]] and <a href="https://fairsharing.org/standards/?q=&selected_facets=type_exact:identifier%20schema">FAIRsharing Registry</a>.</p>
</section>
</section>

Expand Down Expand Up @@ -4972,17 +4980,18 @@ <h2>Complementary approaches to versioning</h2>

<p>The following example shows how DCAT and OWL can be used complementarily to versioning [[?VOCAB-DCAT-2]].</p>

<aside class="example" id="ex-versioning-with-dcat-and-owl" title="Use of DCAT and OWL for versioning DCAT 2">
<aside class="example" id="ex-versioning-with-dcat-and-owl" title="Use of DCAT and OWL for versioning DCAT 3">
<pre>
&lt;http://www.w3.org/ns/dcat#&gt; a owl:Ontology , dcat:Dataset ;
owl:versionInfo "Version 2" ;
dcat:version "Version 2" ;
owl:versionIRI &lt;http://www.w3.org/ns/dcat2#&gt; ;
dcat:hasCurrentVersion &lt;http://www.w3.org/ns/dcat2#&gt; ;
owl:priorVersion &lt;http://www.w3.org/ns/dcat2014#&gt; ;
dcat:previousVersion &lt;http://www.w3.org/ns/dcat2014#&gt; ;
dcat:hasVersion &lt;http://www.w3.org/ns/dcat2014#&gt; ,
&lt;http://www.w3.org/ns/dcat2#&gt; ,
&lt;http://www.w3.org/ns/dcat&gt; a owl:Ontology , dcat:Dataset ;
owl:versionInfo "3" ;
dcat:version "3" ;
owl:versionIRI &lt;http://www.w3.org/ns/dcat3&gt; ;
dcat:hasCurrentVersion &lt;http://www.w3.org/ns/dcat3&gt; ;
owl:priorVersion &lt;http://www.w3.org/ns/dcat2&gt; ;
dcat:previousVersion &lt;http://www.w3.org/ns/dcat2&gt; ;
dcat:hasVersion &lt;http://www.w3.org/ns/dcat2014&gt; ,
&lt;http://www.w3.org/ns/dcat2&gt; ,
&lt;http://www.w3.org/ns/dcat3&gt; ;
.
</pre>
</aside>
Expand Down Expand Up @@ -5488,7 +5497,6 @@ <h3>Conformance to a standard</h3>
<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 explicitly state conformance of a <code>dcat:CatalogRecord</code> with DCAT 2, use both <code>https://www.w3.org/TR/vocab-dcat/</code> and <code>https://www.w3.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>

Expand Down Expand Up @@ -6759,8 +6767,25 @@ <h3>Compressed and packaged distributions</h3>
<h2>Change history</h2>

<p>A full change-log is available on <a href="https://github.com/w3c/dxwg/commits/gh-pages/dcat">GitHub</a></p>


<section id="changes-since-20220510">

<h2>Changes since the fourth public working draft of 10 May 2022</h2>

<p>The document has undergone the following changes since the DCAT 3 fourth public working draft of 10 May 2022 [[?VOCAB-DCAT-3-20220510]]:</p>

<ul>
<li>
<p>Updated <a href="#ex-versioning-with-dcat-and-owl"></a> (<a href="#versioning-complementary-approaches"></a>) to illustrate how to use OWL and DCAT to version DCAT 3.</p>
</li>
<li>
<p>Editorial and bug fixes throughout the document.</p>
</li>
</ul>

</section>

<section id="changes-since-20220111">

<h2>Changes since the third public working draft of 11 January 2022</h2>
Expand All @@ -6770,13 +6795,13 @@ <h2>Changes since the third public working draft of 11 January 2022</h2>
<ul>
<li>
<p>Editorial fix to the inconsistent use of "item" and "resource" throughout the document, by replacing "item" with "resource" when referring to an instance of <code>dcat:Resource</code> - see Issue <a href="https://github.com/w3c/dxwg/issues/1490">#1490</a>. This revision has affected the definitions and/or the usage notes of the following terms in section <a href="#Class:Resource"></a>:
<a href="#Property:resource_description"></a>
<a href="#Property:resource_title"></a>
<a href="#Property:resource_release_date"></a>
<a href="#Property:resource_update_date"></a>
<a href="#Property:resource_language"></a>
<a href="#Property:resource_publisher"></a>
<a href="#Property:resource_identifier"></a>
<a href="#Property:resource_description"></a>,
<a href="#Property:resource_title"></a>,
<a href="#Property:resource_release_date"></a>,
<a href="#Property:resource_update_date"></a>,
<a href="#Property:resource_language"></a>,
<a href="#Property:resource_publisher"></a>,
<a href="#Property:resource_identifier"></a>,
<a href="#Property:resource_relation"></a>.
</p>
</li>
Expand Down

0 comments on commit 77b2c3e

Please sign in to comment.