Skip to content

Commit 688b1f9

Browse files
committed
update RDF documentation with schema namespace, image namespace, and rdf canonical url information
1 parent e32504a commit 688b1f9

File tree

1 file changed

+79
-5
lines changed

1 file changed

+79
-5
lines changed

docs/rdf.md

+79-5
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,44 @@
55

66
## Namespaces
77

8+
9+
### ccREL Schema
10+
11+
`schema.rdf` excerpt:
12+
```xml
13+
<rdf:RDF
14+
xmlns:cc="http://creativecommons.org/ns#"
15+
xmlns:owl="http://www.w3.org/2002/07/owl#"
16+
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
17+
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
18+
>
19+
```
20+
| Prefix | Name | URL |
21+
| ------ | ------------------- | ------------------------------------------- |
22+
| `cc` | ccREL | http://creativecommons.org/ns# |
23+
| `owl` | OWL 2 | http://www.w3.org/2002/07/owl# |
24+
| `rdf` | RDF XML Syntax | http://www.w3.org/1999/02/22-rdf-syntax-ns# |
25+
| `rdfs` | RDF Schema | http://www.w3.org/2000/01/rdf-schema# |
26+
27+
28+
### Images
29+
30+
`images.rdf` excerpt:
31+
```xml
32+
<rdf:RDF
33+
xmlns:exif="http://www.w3.org/2003/12/exif/ns#"
34+
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
35+
>
36+
```
37+
| Prefix | Name | URL |
38+
| ------ | ------------------- | ------------------------------------------- |
39+
| `exif` | Exif RDF Schem | http://www.w3.org/2003/12/exif/ns# |
40+
| `rdf` | RDF XML Syntax | http://www.w3.org/1999/02/22-rdf-syntax-ns# |
41+
42+
43+
### Legal code
44+
45+
`**/rdf` excerpt:
846
```xml
947
<rdf:RDF
1048
xmlns:cc='http://creativecommons.org/ns#'
@@ -24,7 +62,7 @@
2462
| `rdf` | RDF XML Syntax | http://www.w3.org/1999/02/22-rdf-syntax-ns# |
2563

2664

27-
### ccREL
65+
### ccREL ( `cc` prefix)
2866

2967
- [Describing Copyright in RDF - Creative Commons Rights Expression
3068
Language][ccrelns]
@@ -36,7 +74,7 @@
3674
[ccrelguide]: https://opensource.creativecommons.org/ccrel-guide/
3775

3876

39-
### DCMI Metadata Terms
77+
### DCMI Metadata Terms (`dcterms` prefix)
4078

4179
- [DCMI: Dublin Core™][dublincore]
4280
- [DCMI: DCMI Metadata Terms][dcmiterms]
@@ -45,7 +83,17 @@
4583
[dcmiterms]: https://www.dublincore.org/specifications/dublin-core/dcmi-terms/
4684

4785

48-
### FOAF Vocabulary
86+
### Exif RDF Schema (`exif` prefix)
87+
88+
[Exif RDF Schema][exifrdf] (retrieved 2024-07-03):
89+
> Vocabulary to describe an Exif format picture data. All Exif 2.2 tags are defined as RDF properties, as well as several terms to help this schema
90+
91+
- [Exif RDF Schema][exifrdf]
92+
93+
[exifrdf]: https://www.w3.org/2003/12/exif/
94+
95+
96+
### FOAF Vocabulary (`foaf`)
4997

5098
[FOAF - Wikipedia](https://en.wikipedia.org/wiki/FOAF) (retrieved 2023-07-20):
5199
> FOAF (an acronym of friend of a friend) is a machine-readable ontology
@@ -57,7 +105,7 @@
57105
[foafvocab]: http://xmlns.com/foaf/0.1/
58106

59107

60-
### OWL 2
108+
### OWL 2 (`owl` prefix)
61109

62110
[OWL 2 Web Ontology Language Document Overview (Second Edition)][owl2overiew]
63111
(retrieved 2023-07-20):
@@ -78,13 +126,39 @@
78126
[wikipediasameas]: https://en.wikipedia.org/wiki/SameAs
79127

80128

81-
### RDF XML Syntax
129+
### RDF XML Syntax (`rdf` prefix)
82130

83131
- [RDF 1.1 XML Syntax](https://www.w3.org/TR/rdf-syntax-grammar/)
84132

85133

134+
### RDF Schema (`rdfs` prefix)
135+
136+
- [RDF Schema 1.1](https://www.w3.org/TR/rdf11-schema/)
137+
138+
139+
## RDF canonical URL
140+
141+
Due to historical reasons, the canonical URL for the legal tools in RDF uses
142+
the HTTP (unencrypted) protocol.
143+
144+
Although the legal tools are not available via HTTP, the URLs still function
145+
correctly due to redirects. Additionally, the RDF now includes an `owl:sameAs`
146+
element with the HTTPS URL for further compatibility.
147+
148+
For example:
149+
150+
| Context | Protocol | Canonical URL | Example |
151+
| ------- | -------- | ------------: | ------- |
152+
| RDF | HTTP | `http://creativecommons.org/licenses/by/4.0/` | [licenses/by/4.0/rdf#L3][ex1]
153+
| all other uses | HTTPS | `https://creativecommons.org/licenses/by/4.0/` | [licenses/by/4.0/legalcode.en.html#L390-L397][ex2]
154+
155+
[ex1]: https://github.com/creativecommons/cc-legal-tools-data/blob/ba0781024c735f5cd4eb59f8a1716eb9a12df212/docs/licenses/by/4.0/rdf#L3
156+
[ex2]: https://github.com/creativecommons/cc-legal-tools-data/blob/ba0781024c735f5cd4eb59f8a1716eb9a12df212/docs/licenses/by/4.0/legalcode.en.html#L390-L397
157+
158+
86159
## Changes
87160

161+
88162
### Overview
89163

90164
The changes between the old legacy ccEngine RDF/XML and the new CC Legal Tools

0 commit comments

Comments
 (0)