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

Commit f0ba832

Browse files
author
Haley Van Dyck
committed
Merge pull request #161 from jpmckinney/dcterms
Normalize the dct namespace to dcterms everywhere
2 parents b5736cd + 8088bf8 commit f0ba832

File tree

7 files changed

+46
-46
lines changed

7 files changed

+46
-46
lines changed

‎catalog.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,11 +37,11 @@ To fulfill the requirements of this memorandum, agencies should begin to describ
3737

3838
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.
3939

40-
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).
40+
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).
4141

4242
### RDFa Lite
4343

44-
[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.
44+
[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.
4545

4646

4747
Generating Machine-Readable Reporting Files

‎examples/catalog-sample-extended.html

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ <h3>Office Locations</h3>
55

66
<li>
77
<strong>Title:</strong>
8-
<span property="dct:title">Office Locations</span>
8+
<span property="dcterms:title">Office Locations</span>
99
</li>
1010

1111
<li>
1212
<strong>Description:</strong>
13-
<span property="dct:description">A list of the agency's office locations and contact information.</span>
13+
<span property="dcterms:description">A list of the agency's office locations and contact information.</span>
1414
</li>
1515

1616
<li>
@@ -85,12 +85,12 @@ <h3>Office Locations</h3>
8585

8686
<li>
8787
<strong>Release Date:</strong>
88-
<span property="dct:issued">7/9/2012</span>
88+
<span property="dcterms:issued">7/9/2012</span>
8989
</li>
9090

9191
<li>
9292
<strong>Frequency:</strong>
93-
<span property="dct:accrualPeriodocity">6 months</span>
93+
<span property="dcterms:accrualPeriodocity">6 months</span>
9494
</li>
9595

9696
<li>
@@ -146,12 +146,12 @@ <h3>Database Export</h3>
146146

147147
<li>
148148
<strong>Title:</strong>
149-
<span property="dct:title">Database Export</span>
149+
<span property="dcterms:title">Database Export</span>
150150
</li>
151151

152152
<li>
153153
<strong>Description:</strong>
154-
<span property="dct:description">A full export of the agency's database.</span>
154+
<span property="dcterms:description">A full export of the agency's database.</span>
155155
</li>
156156

157157
<li>
@@ -226,12 +226,12 @@ <h3>Database Export</h3>
226226

227227
<li>
228228
<strong>Release Date:</strong>
229-
<span property="dct:issued">3/1/2012</span>
229+
<span property="dcterms:issued">3/1/2012</span>
230230
</li>
231231

232232
<li>
233233
<strong>Frequency:</strong>
234-
<span property="dct:accrualPeriodocity">yearly</span>
234+
<span property="dcterms:accrualPeriodocity">yearly</span>
235235
</li>
236236

237237
<li>
@@ -287,12 +287,12 @@ <h3>System Data API</h3>
287287

288288
<li>
289289
<strong>Title:</strong>
290-
<span property="dct:title">System Data API</span>
290+
<span property="dcterms:title">System Data API</span>
291291
</li>
292292

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

298298
<li>
@@ -367,12 +367,12 @@ <h3>System Data API</h3>
367367

368368
<li>
369369
<strong>Release Date:</strong>
370-
<span property="dct:issued">2/15/2013</span>
370+
<span property="dcterms:issued">2/15/2013</span>
371371
</li>
372372

373373
<li>
374374
<strong>Frequency:</strong>
375-
<span property="dct:accrualPeriodocity">weekly</span>
375+
<span property="dcterms:accrualPeriodocity">weekly</span>
376376
</li>
377377

378378
<li>

‎examples/catalog-sample-extended.xml

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<datasets>
22
<dataset id="1">
33

4-
<attribute property="dct:title">Office Locations</attribute>
4+
<attribute property="dcterms:title">Office Locations</attribute>
55

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

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

@@ -33,9 +33,9 @@
3333

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

36-
<attribute property="dct:issued">7/9/2012</attribute>
36+
<attribute property="dcterms:issued">7/9/2012</attribute>
3737

38-
<attribute property="dct:accrualPeriodocity">6 months</attribute>
38+
<attribute property="dcterms:accrualPeriodocity">6 months</attribute>
3939

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

@@ -58,9 +58,9 @@
5858
</dataset>
5959
<dataset id="2">
6060

61-
<attribute property="dct:title">Database Export</attribute>
61+
<attribute property="dcterms:title">Database Export</attribute>
6262

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

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

@@ -90,9 +90,9 @@
9090

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

93-
<attribute property="dct:issued">3/1/2012</attribute>
93+
<attribute property="dcterms:issued">3/1/2012</attribute>
9494

95-
<attribute property="dct:accrualPeriodocity">yearly</attribute>
95+
<attribute property="dcterms:accrualPeriodocity">yearly</attribute>
9696

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

@@ -115,9 +115,9 @@
115115
</dataset>
116116
<dataset id="3">
117117

118-
<attribute property="dct:title">System Data API</attribute>
118+
<attribute property="dcterms:title">System Data API</attribute>
119119

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

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

@@ -147,9 +147,9 @@
147147

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

150-
<attribute property="dct:issued">2/15/2013</attribute>
150+
<attribute property="dcterms:issued">2/15/2013</attribute>
151151

152-
<attribute property="dct:accrualPeriodocity">weekly</attribute>
152+
<attribute property="dcterms:accrualPeriodocity">weekly</attribute>
153153

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

‎examples/catalog-sample.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ <h3>Office Locations</h3>
55

66
<li>
77
<strong>Title:</strong>
8-
<span property="dct:title">Office Locations</span>
8+
<span property="dcterms:title">Office Locations</span>
99
</li>
1010

1111
<li>
1212
<strong>Description:</strong>
13-
<span property="dct:description">A list of the agency's office locations and contact information.</span>
13+
<span property="dcterms:description">A list of the agency's office locations and contact information.</span>
1414
</li>
1515

1616
<li>
@@ -91,12 +91,12 @@ <h3>Database Export</h3>
9191

9292
<li>
9393
<strong>Title:</strong>
94-
<span property="dct:title">Database Export</span>
94+
<span property="dcterms:title">Database Export</span>
9595
</li>
9696

9797
<li>
9898
<strong>Description:</strong>
99-
<span property="dct:description">A full export of the agency's database.</span>
99+
<span property="dcterms:description">A full export of the agency's database.</span>
100100
</li>
101101

102102
<li>
@@ -177,12 +177,12 @@ <h3>System Data API</h3>
177177

178178
<li>
179179
<strong>Title:</strong>
180-
<span property="dct:title">System Data API</span>
180+
<span property="dcterms:title">System Data API</span>
181181
</li>
182182

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

188188
<li>

‎examples/catalog-sample.xml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<datasets>
22
<dataset id="1">
33

4-
<attribute property="dct:title">Office Locations</attribute>
4+
<attribute property="dcterms:title">Office Locations</attribute>
55

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

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

@@ -36,9 +36,9 @@
3636
</dataset>
3737
<dataset id="2">
3838

39-
<attribute property="dct:title">Database Export</attribute>
39+
<attribute property="dcterms:title">Database Export</attribute>
4040

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

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

@@ -71,9 +71,9 @@
7171
</dataset>
7272
<dataset id="3">
7373

74-
<attribute property="dct:title">System Data API</attribute>
74+
<attribute property="dcterms:title">System Data API</attribute>
7575

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

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

‎examples/catalog-template.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ <h3></h3>
55

66
<li>
77
<strong>Title:</strong>
8-
<span property="dct:title"></span>
8+
<span property="dcterms:title"></span>
99
</li>
1010

1111
<li>
1212
<strong>Description:</strong>
13-
<span property="dct:description"></span>
13+
<span property="dcterms:description"></span>
1414
</li>
1515

1616
<li>
@@ -71,12 +71,12 @@ <h3></h3>
7171

7272
<li>
7373
<strong>Title:</strong>
74-
<span property="dct:title"></span>
74+
<span property="dcterms:title"></span>
7575
</li>
7676

7777
<li>
7878
<strong>Description:</strong>
79-
<span property="dct:description"></span>
79+
<span property="dcterms:description"></span>
8080
</li>
8181

8282
<li>

‎examples/catalog-template.xml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<datasets>
22
<dataset id="">
33

4-
<attribute property="dct:title"></attribute>
4+
<attribute property="dcterms:title"></attribute>
55

6-
<attribute property="dct:description"></attribute>
6+
<attribute property="dcterms:description"></attribute>
77

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

@@ -28,9 +28,9 @@
2828
</dataset>
2929
<dataset id="">
3030

31-
<attribute property="dct:title"></attribute>
31+
<attribute property="dcterms:title"></attribute>
3232

33-
<attribute property="dct:description"></attribute>
33+
<attribute property="dcterms:description"></attribute>
3434

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

0 commit comments

Comments
 (0)