Skip to content
This repository was archived by the owner on Jun 18, 2024. It is now read-only.

Normalize the dct namespace to dcterms everywhere #161

Merged
merged 1 commit into from
Oct 22, 2013
Merged

Normalize the dct namespace to dcterms everywhere #161

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 2 additions & 2 deletions catalog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,11 +37,11 @@ To fulfill the requirements of this memorandum, agencies should begin to describ

JSON is a lightweight and simple way to represent machine-readable data. It is quickly becoming the *de facto* standard for shuttling data across the internet, fueled primarily by the rise of mobile and APIs. Modern programming languages can interpret and produce JSON out of the box.

The JSON representation of the catalog should track directly to the RDFa version, with the exception that JSON keys should not contain the domain prefix (e.g., `dct:title` becomes `title` and `dct:description` becomes simply `description`). Catalogs should be composed of an array of JSON objects, and all fields other than keywords should be a string (where keywords is an array of strings).
The JSON representation of the catalog should track directly to the RDFa version, with the exception that JSON keys should not contain the domain prefix (e.g., `dcterms:title` becomes `title` and `dcterms:description` becomes simply `description`). Catalogs should be composed of an array of JSON objects, and all fields other than keywords should be a string (where keywords is an array of strings).

### RDFa Lite

[RDFa Lite](http://www.w3.org/TR/rdfa-lite/) is a subset of RDFa (Resource Description Framework in Attribute) that provides a common syntax for expressing metadata on websites in a way that computers can understand and begin to formulate knowledge about those data about your organization. RDFa Lite embeds itself in existing, standard HTML pages. For example, if previously a dataset was described as `<h2>Name of Dataset</h2>`, RDFa would extend that markup as `<h2 property="dct:title">Name of Dataset</h2>` (notice the additional of the property field). This additional metadata is not visible when the page is rendered, and does not affect the page layout or content. It simply provides an additional level of description for search engines, crawlers, and other programmatic consumers of your site's content. It is acceptable for the RDFa Lite file to contain only the machine-readable metadata, but agencies may wish to add human readable content to display the metadata to the public if they so desire.
[RDFa Lite](http://www.w3.org/TR/rdfa-lite/) is a subset of RDFa (Resource Description Framework in Attribute) that provides a common syntax for expressing metadata on websites in a way that computers can understand and begin to formulate knowledge about those data about your organization. RDFa Lite embeds itself in existing, standard HTML pages. For example, if previously a dataset was described as `<h2>Name of Dataset</h2>`, RDFa would extend that markup as `<h2 property="dcterms:title">Name of Dataset</h2>` (notice the additional of the property field). This additional metadata is not visible when the page is rendered, and does not affect the page layout or content. It simply provides an additional level of description for search engines, crawlers, and other programmatic consumers of your site's content. It is acceptable for the RDFa Lite file to contain only the machine-readable metadata, but agencies may wish to add human readable content to display the metadata to the public if they so desire.


Generating Machine-Readable Reporting Files
Expand Down
24 changes: 12 additions & 12 deletions examples/catalog-sample-extended.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ <h3>Office Locations</h3>

<li>
<strong>Title:</strong>
<span property="dct:title">Office Locations</span>
<span property="dcterms:title">Office Locations</span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description">A list of the agency's office locations and contact information.</span>
<span property="dcterms:description">A list of the agency's office locations and contact information.</span>
</li>

<li>
Expand Down Expand Up @@ -85,12 +85,12 @@ <h3>Office Locations</h3>

<li>
<strong>Release Date:</strong>
<span property="dct:issued">7/9/2012</span>
<span property="dcterms:issued">7/9/2012</span>
</li>

<li>
<strong>Frequency:</strong>
<span property="dct:accrualPeriodocity">6 months</span>
<span property="dcterms:accrualPeriodocity">6 months</span>
</li>

<li>
Expand Down Expand Up @@ -146,12 +146,12 @@ <h3>Database Export</h3>

<li>
<strong>Title:</strong>
<span property="dct:title">Database Export</span>
<span property="dcterms:title">Database Export</span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description">A full export of the agency's database.</span>
<span property="dcterms:description">A full export of the agency's database.</span>
</li>

<li>
Expand Down Expand Up @@ -226,12 +226,12 @@ <h3>Database Export</h3>

<li>
<strong>Release Date:</strong>
<span property="dct:issued">3/1/2012</span>
<span property="dcterms:issued">3/1/2012</span>
</li>

<li>
<strong>Frequency:</strong>
<span property="dct:accrualPeriodocity">yearly</span>
<span property="dcterms:accrualPeriodocity">yearly</span>
</li>

<li>
Expand Down Expand Up @@ -287,12 +287,12 @@ <h3>System Data API</h3>

<li>
<strong>Title:</strong>
<span property="dct:title">System Data API</span>
<span property="dcterms:title">System Data API</span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description">A restful web service for a system's data set from 2012.</span>
<span property="dcterms:description">A restful web service for a system's data set from 2012.</span>
</li>

<li>
Expand Down Expand Up @@ -367,12 +367,12 @@ <h3>System Data API</h3>

<li>
<strong>Release Date:</strong>
<span property="dct:issued">2/15/2013</span>
<span property="dcterms:issued">2/15/2013</span>
</li>

<li>
<strong>Frequency:</strong>
<span property="dct:accrualPeriodocity">weekly</span>
<span property="dcterms:accrualPeriodocity">weekly</span>
</li>

<li>
Expand Down
24 changes: 12 additions & 12 deletions examples/catalog-sample-extended.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<datasets>
<dataset id="1">

<attribute property="dct:title">Office Locations</attribute>
<attribute property="dcterms:title">Office Locations</attribute>

<attribute property="dct:description">A list of the agency's office locations and contact information.</attribute>
<attribute property="dcterms:description">A list of the agency's office locations and contact information.</attribute>

<attribute property="dcat:dataDictionary">http://www.agency.gov/data/information/locations</attribute>

Expand Down Expand Up @@ -33,9 +33,9 @@

<attribute property="dcterms:temporal">today</attribute>

<attribute property="dct:issued">7/9/2012</attribute>
<attribute property="dcterms:issued">7/9/2012</attribute>

<attribute property="dct:accrualPeriodocity">6 months</attribute>
<attribute property="dcterms:accrualPeriodocity">6 months</attribute>

<attribute property="dcat:language">English</attribute>

Expand All @@ -58,9 +58,9 @@
</dataset>
<dataset id="2">

<attribute property="dct:title">Database Export</attribute>
<attribute property="dcterms:title">Database Export</attribute>

<attribute property="dct:description">A full export of the agency's database.</attribute>
<attribute property="dcterms:description">A full export of the agency's database.</attribute>

<attribute property="dcat:dataDictionary">http://www.agency.gov/data/information/database</attribute>

Expand Down Expand Up @@ -90,9 +90,9 @@

<attribute property="dcterms:temporal">2001-current</attribute>

<attribute property="dct:issued">3/1/2012</attribute>
<attribute property="dcterms:issued">3/1/2012</attribute>

<attribute property="dct:accrualPeriodocity">yearly</attribute>
<attribute property="dcterms:accrualPeriodocity">yearly</attribute>

<attribute property="dcat:language">English</attribute>

Expand All @@ -115,9 +115,9 @@
</dataset>
<dataset id="3">

<attribute property="dct:title">System Data API</attribute>
<attribute property="dcterms:title">System Data API</attribute>

<attribute property="dct:description">A restful web service for a system's data set from 2012.</attribute>
<attribute property="dcterms:description">A restful web service for a system's data set from 2012.</attribute>

<attribute property="dcat:dataDictionary">http://www.agency.gov/data/information/system_api</attribute>

Expand Down Expand Up @@ -147,9 +147,9 @@

<attribute property="dcterms:temporal">2012</attribute>

<attribute property="dct:issued">2/15/2013</attribute>
<attribute property="dcterms:issued">2/15/2013</attribute>

<attribute property="dct:accrualPeriodocity">weekly</attribute>
<attribute property="dcterms:accrualPeriodocity">weekly</attribute>

<attribute property="dcat:language">English</attribute>

Expand Down
12 changes: 6 additions & 6 deletions examples/catalog-sample.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ <h3>Office Locations</h3>

<li>
<strong>Title:</strong>
<span property="dct:title">Office Locations</span>
<span property="dcterms:title">Office Locations</span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description">A list of the agency's office locations and contact information.</span>
<span property="dcterms:description">A list of the agency's office locations and contact information.</span>
</li>

<li>
Expand Down Expand Up @@ -91,12 +91,12 @@ <h3>Database Export</h3>

<li>
<strong>Title:</strong>
<span property="dct:title">Database Export</span>
<span property="dcterms:title">Database Export</span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description">A full export of the agency's database.</span>
<span property="dcterms:description">A full export of the agency's database.</span>
</li>

<li>
Expand Down Expand Up @@ -177,12 +177,12 @@ <h3>System Data API</h3>

<li>
<strong>Title:</strong>
<span property="dct:title">System Data API</span>
<span property="dcterms:title">System Data API</span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description">A restful web service for a system's data set from 2012.</span>
<span property="dcterms:description">A restful web service for a system's data set from 2012.</span>
</li>

<li>
Expand Down
12 changes: 6 additions & 6 deletions examples/catalog-sample.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<datasets>
<dataset id="1">

<attribute property="dct:title">Office Locations</attribute>
<attribute property="dcterms:title">Office Locations</attribute>

<attribute property="dct:description">A list of the agency's office locations and contact information.</attribute>
<attribute property="dcterms:description">A list of the agency's office locations and contact information.</attribute>

<attribute property="dcat:dataDictionary">http://www.agency.gov/data/information/locations</attribute>

Expand Down Expand Up @@ -36,9 +36,9 @@
</dataset>
<dataset id="2">

<attribute property="dct:title">Database Export</attribute>
<attribute property="dcterms:title">Database Export</attribute>

<attribute property="dct:description">A full export of the agency's database.</attribute>
<attribute property="dcterms:description">A full export of the agency's database.</attribute>

<attribute property="dcat:dataDictionary">http://www.agency.gov/data/information/database</attribute>

Expand Down Expand Up @@ -71,9 +71,9 @@
</dataset>
<dataset id="3">

<attribute property="dct:title">System Data API</attribute>
<attribute property="dcterms:title">System Data API</attribute>

<attribute property="dct:description">A restful web service for a system's data set from 2012.</attribute>
<attribute property="dcterms:description">A restful web service for a system's data set from 2012.</attribute>

<attribute property="dcat:dataDictionary">http://www.agency.gov/data/information/system_api</attribute>

Expand Down
8 changes: 4 additions & 4 deletions examples/catalog-template.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ <h3></h3>

<li>
<strong>Title:</strong>
<span property="dct:title"></span>
<span property="dcterms:title"></span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description"></span>
<span property="dcterms:description"></span>
</li>

<li>
Expand Down Expand Up @@ -71,12 +71,12 @@ <h3></h3>

<li>
<strong>Title:</strong>
<span property="dct:title"></span>
<span property="dcterms:title"></span>
</li>

<li>
<strong>Description:</strong>
<span property="dct:description"></span>
<span property="dcterms:description"></span>
</li>

<li>
Expand Down
8 changes: 4 additions & 4 deletions examples/catalog-template.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<datasets>
<dataset id="">

<attribute property="dct:title"></attribute>
<attribute property="dcterms:title"></attribute>

<attribute property="dct:description"></attribute>
<attribute property="dcterms:description"></attribute>

<attribute property="dcat:dataDictionary"></attribute>

Expand All @@ -28,9 +28,9 @@
</dataset>
<dataset id="">

<attribute property="dct:title"></attribute>
<attribute property="dcterms:title"></attribute>

<attribute property="dct:description"></attribute>
<attribute property="dcterms:description"></attribute>

<attribute property="dcat:dataDictionary"></attribute>

Expand Down