--- a/rdf-primer/Overview.html Mon Dec 16 13:40:14 2013 +0100
+++ b/rdf-primer/Overview.html Mon Dec 16 13:42:09 2013 +0100
@@ -368,7 +368,7 @@
-</section><section id="toc"><h2 class="introductory" aria-level="1" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#section-Introduction" class="tocxref"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a href="#section-use-cases" class="tocxref"><span class="secno">2. </span>Why use RDF?</a></li><li class="tocline"><a href="#section-data-model" class="tocxref"><span class="secno">3. </span>RDF Data Model</a><ul class="toc"><li class="tocline"><a href="#subsection-triple" class="tocxref"><span class="secno">3.1 </span>Triples</a></li><li class="tocline"><a href="#subsection-IRI" class="tocxref"><span class="secno">3.2 </span>IRIs</a></li><li class="tocline"><a href="#subsection-literal" class="tocxref"><span class="secno">3.3 </span>Literals</a></li><li class="tocline"><a href="#subsection-blank-node" class="tocxref"><span class="secno">3.4 </span>Blank nodes</a></li><li class="tocline"><a href="#subsection-multiple-graphs" class="tocxref"><span class="secno">3.5 </span>Multiple graphs</a></li></ul></li><li class="tocline"><a href="#section-vocabulary" class="tocxref"><span class="secno">4. </span>RDF Vocabularies</a></li><li class="tocline"><a href="#section-graph-syntax" class="tocxref"><span class="secno">5. </span>Writing RDF graphs</a><ul class="toc"><li class="tocline"><a href="#subsection-turtle" class="tocxref"><span class="secno">5.1 </span>Turtle</a></li><li class="tocline"><a href="#subsection-trig" class="tocxref"><span class="secno">5.2 </span>TriG</a></li><li class="tocline"><a href="#subsection-other-syntaxes" class="tocxref"><span class="secno">5.3 </span>Other concrete syntaxes for RDF</a></li></ul></li><li class="tocline"><a href="#section-semantics" class="tocxref"><span class="secno">6. </span>Semantics of RDF Graphs</a></li><li class="tocline"><a href="#section-data" class="tocxref"><span class="secno">7. </span>RDF Data</a></li><li class="tocline"><a href="#section-conclusion" class="tocxref"><span class="secno">8. </span>More Information</a></li><li class="tocline"><a href="#section-Acknowledgments" class="tocxref"><span class="secno">A. </span>Acknowledgments</a></li><li class="tocline"><a href="#changes" class="tocxref"><span class="secno">B. </span>Changes</a></li><li class="tocline"><a href="#section-other-syntaxes" class="tocxref"><span class="secno">C. </span>Examples of RDF syntaxes</a><ul class="toc"><li class="tocline"><a href="#subsection-rdfa" class="tocxref"><span class="secno">C.1 </span>RDFa</a></li><li class="tocline"><a href="#subsection-ntriples" class="tocxref"><span class="secno">C.2 </span>N-Triples</a></li><li class="tocline"><a href="#subsection-nquads" class="tocxref"><span class="secno">C.3 </span>N-Quads</a></li><li class="tocline"><a href="#subsection-rdf-xml" class="tocxref"><span class="secno">C.4 </span>RDF/XML</a></li></ul></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">D. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">D.1 </span>Normative references</a></li><li class="tocline"><a href="#informative-references" class="tocxref"><span class="secno">D.2 </span>Informative references</a></li></ul></li></ul></section>
+</section><section id="toc"><h2 class="introductory" aria-level="1" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#section-Introduction" class="tocxref"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a href="#section-use-cases" class="tocxref"><span class="secno">2. </span>Why use RDF?</a></li><li class="tocline"><a href="#section-data-model" class="tocxref"><span class="secno">3. </span>RDF Data Model</a><ul class="toc"><li class="tocline"><a href="#subsection-triple" class="tocxref"><span class="secno">3.1 </span>Triples</a></li><li class="tocline"><a href="#subsection-IRI" class="tocxref"><span class="secno">3.2 </span>IRIs</a></li><li class="tocline"><a href="#subsection-literal" class="tocxref"><span class="secno">3.3 </span>Literals</a></li><li class="tocline"><a href="#subsection-blank-node" class="tocxref"><span class="secno">3.4 </span>Blank nodes</a></li><li class="tocline"><a href="#subsection-multiple-graphs" class="tocxref"><span class="secno">3.5 </span>Multiple graphs</a></li></ul></li><li class="tocline"><a href="#section-vocabulary" class="tocxref"><span class="secno">4. </span>RDF Vocabularies</a></li><li class="tocline"><a href="#section-graph-syntax" class="tocxref"><span class="secno">5. </span>Writing RDF graphs</a><ul class="toc"><li class="tocline"><a href="#subsection-turtle" class="tocxref"><span class="secno">5.1 </span>Turtle</a></li><li class="tocline"><a href="#subsection-trig" class="tocxref"><span class="secno">5.2 </span>TriG</a></li><li class="tocline"><a href="#subsection-other-syntaxes" class="tocxref"><span class="secno">5.3 </span>Other concrete syntaxes for RDF</a></li></ul></li><li class="tocline"><a href="#section-semantics" class="tocxref"><span class="secno">6. </span>Semantics of RDF Graphs</a></li><li class="tocline"><a href="#section-data" class="tocxref"><span class="secno">7. </span>RDF Data</a></li><li class="tocline"><a href="#section-conclusion" class="tocxref"><span class="secno">8. </span>More Information</a></li><li class="tocline"><a href="#section-Acknowledgments" class="tocxref"><span class="secno">A. </span>Acknowledgments</a></li><li class="tocline"><a href="#changes" class="tocxref"><span class="secno">B. </span>Changes</a></li><li class="tocline"><a href="#section-other-syntaxes" class="tocxref"><span class="secno">C. </span>Examples of RDF syntaxes</a><ul class="toc"><li class="tocline"><a href="#subsection-rdfa" class="tocxref"><span class="secno">C.1 </span>RDFa</a></li><li class="tocline"><a href="#subsection-jsonld" class="tocxref"><span class="secno">C.2 </span>JSON-LD</a></li><li class="tocline"><a href="#subsection-ntriples" class="tocxref"><span class="secno">C.3 </span>N-Triples</a></li><li class="tocline"><a href="#subsection-nquads" class="tocxref"><span class="secno">C.4 </span>N-Quads</a></li><li class="tocline"><a href="#subsection-rdf-xml" class="tocxref"><span class="secno">C.5 </span>RDF/XML</a></li></ul></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">D. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">D.1 </span>Normative references</a></li><li class="tocline"><a href="#informative-references" class="tocxref"><span class="secno">D.2 </span>Informative references</a></li></ul></li></ul></section>
@@ -868,6 +868,9 @@
<!--OddPage-->
<h2 aria-level="1" role="heading" id="h2_section-graph-syntax"><span class="secno">5. </span>Writing RDF graphs</h2>
+<div class="issue"><div class="issue-title" aria-level="2" role="heading" id="h_issue_1"><span>Issue 1</span></div><p class="">We plan to include also one annotated JSON-LD example in this
+section.</p></div>
+
<p>Many different concrete syntaxes exist for writing down RDF
graphs. However, different encodings of the same graph lead
to exactly the same triples. </p>
@@ -896,12 +899,12 @@
extended form) can be
represented in Turtle as follows:</p>
- <div class="example"><div class="example-title"><span>Example 3</span></div><pre id="turtle-example" class="example">01 @base <http://example.org/> .
-02 @prefix foaf: <http://xmlns.com/foaf/0.1/> .
-03 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
-04 @prefix schema: <http://schema.org/> .
-05 @prefix dcterms: <http://purl.org/dc/terms/> .
-06 @prefix wd: <http://www.wikidata.org/entity/> .
+ <div class="example"><div class="example-title"><span>Example 3</span></div><pre id="turtle-example" class="example">01 BASE <http://example.org/>
+02 PREFIX foaf: <http://xmlns.com/foaf/0.1/>
+03 PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
+04 PREFIX schema: <http://schema.org/>
+05 PREFIX dcterms: <http://purl.org/dc/terms/>
+06 PREFIX wd: <http://www.wikidata.org/entity/>
07
08 <bob#me>
09 a foaf:Person ;
@@ -924,18 +927,16 @@
be use for prefixed names (such as <code>foaf:Person</code>) instead of full IRIs.
The corresponding IRI is constructed by replacing the prefix with its
corresponding IRI (in this example <code>foaf:Person</code> stands for
-<code><http://xmlns.com/foaf/0.1/Person></code>). A period is used to
-signal the end of a Turtle statement. </p>
-
-<div class="issue"><div class="issue-title" aria-level="3" role="heading" id="h_issue_1"><span>Issue 1</span></div><p class="">
-Use SPARQL-style prefix?
-</p></div>
+<code><http://xmlns.com/foaf/0.1/Person></code>).</p>
<p>Lines 8-12 show how Turtle provides a shorthand for a set of
triples with the same subject. Lines 9-12 specify the predicate-object
part of triples with <code><http://example.org/bob#me></code> as
subject. The semicolons at the end of lines 9-11 indicate that the
-set is not yet complete. The triple represented by line 10 looks in
+set is not yet complete. A period is used to
+signal the end of a Turtle statement.</p>
+
+<p>The triple represented by line 10 looks in
its expanded form like this (see the <a href="#subsection-ntriples">N-Triples example</a>
for the expanded form of the full example):</p>
<pre><code><http://example.org/bob#me> <http://xmlns.com/foaf/0.1/knows> <http://example.org/alice#me> .</code>
@@ -946,10 +947,10 @@
<code>a</code> predicate
is a shorthand for the property <code>rdf:type</code> which models the
instance relation (see Table <a href="#table-rdf-schema">"RDF Schema
-constructs"</a>). The <code> a</code> shorthand is intended to match the human
-intuition about <code>rdf:type</code>. </p><p>
+constructs"</a>). The <code>a</code> shorthand is intended to match the human
+intuition about <code>rdf:type</code>. </p>
-</p><p>In line 11 we see an example of a literal, in this case a date. The
+<p>In line 11 we see an example of a literal, in this case a date. The
datatype is appended to the literal through a <code>^^</code> delimiter. The date
representation follows the conventions of the XML Schema datatype
<a href="http://www.w3.org/TR/xmlschema11-2/#date">date</a>.</p>
@@ -980,7 +981,7 @@
<p>Below is sample Turtle syntax for blank nodes, using the
earlier cypress-tree example:</p>
-<div class="example"><div class="example-title"><span>Example 4</span></div><pre class="example">@prefix lio: <http://purl.org/net/lio#> .
+<div class="example"><div class="example-title"><span>Example 4</span></div><pre class="example">PREFIX lio: <http://purl.org/net/lio#>
<http://dbpedia.org/resource/Mona_Lisa> lio:shows _:x .
_:x a <http://dbpedia.org/resource/Cypress> .</pre></div>
@@ -1011,14 +1012,14 @@
<p>The <a href="#subsection-multiple-graphs">multiple-graphs version of our example</a>
can be specified in TriG as follows:</p>
- <div class="example"><div class="example-title"><span>Example 5</span></div><pre id="trig-example" class="example">01 @base <http://example.org/> .
-02 @prefix foaf: <http://xmlns.com/foaf/0.1/> .
-03 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
-04 @prefix schema: <http://schema.org/> .
-05 @prefix dcterms: <http://purl.org/dc/terms/> .
-06 @prefix wd: <http://www.wikidata.org/entity/> .
+ <div class="example"><div class="example-title"><span>Example 5</span></div><pre id="trig-example" class="example">01 BASE <http://example.org/>
+02 PREFIX foaf: <http://xmlns.com/foaf/0.1/>
+03 PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
+04 PREFIX schema: <http://schema.org/>
+05 PREFIX dcterms: <http://purl.org/dc/terms/>
+06 PREFIX wd: <http://www.wikidata.org/entity/>
07
-08 <http://example.org/bob>
+08 GRAPH <http://example.org/bob>
09 {
10 <bob#me>
11 a foaf:Person ;
@@ -1027,7 +1028,7 @@
14 foaf:topic_interest wd:Q12418 .
15 }
16
-17 <https://www.wikidata.org/wiki/Special:EntityData/Q12418>
+17 GRAPH <https://www.wikidata.org/wiki/Special:EntityData/Q12418>
18 {
19 wd:Q12418
20 dcterms:title "Mona Lisa" ;
@@ -1287,6 +1288,9 @@
example</a>; the mutiple-graphs examples encode the same graph as the <a href="#trig-example">Trig
example</a>. </p>
+ <div class="issue"><div class="issue-title" aria-level="2" role="heading" id="h_issue_2"><span>Issue 2</span></div><p class="">
+ We should consider annotating the examples in this
+ appendix, thus providing a mini-primer for each syntax. </p></div>
<section id="subsection-rdfa" typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter">
@@ -1319,12 +1323,7 @@
<section id="subsection-jsonld" typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter">
- <div class="issue"><div class="issue-title" aria-level="3" role="heading" id="h_issue_2"><span>Issue 2</span></div><p class="">
- We should consider annotating the JSON-LD examples in this
- subsection, thus making it a mini JSON-LD primer, and/or including
- one of the JSON-LD example in Sec. 5. </p></div>
-
- <h3 id="json-ld" aria-level="2" role="heading">JSON-LD</h3>
+ <h3 aria-level="2" role="heading" id="h3_subsection-jsonld"><span class="secno">C.2 </span>JSON-LD</h3>
Single-graph example:
@@ -1416,8 +1415,6 @@
JSON data, at the cost of a more elaborate definition of
<code>@context</code>. </p>
-<div class="issue"><div class="issue-title" aria-level="3" role="heading" id="h_issue_3"><span>Issue 3</span></div><p class="">Should we include this alternative example?</p></div>
-
<div class="example"><div class="example-title"><span>Example 10</span></div><pre class="example">01 {
02 "@context": {
03 "foaf": "http://xmlns.com/foaf/0.1/",
@@ -1489,7 +1486,7 @@
<section id="subsection-ntriples" typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter">
- <h3 aria-level="2" role="heading" id="h3_subsection-ntriples"><span class="secno">C.2 </span>N-Triples</h3>
+ <h3 aria-level="2" role="heading" id="h3_subsection-ntriples"><span class="secno">C.3 </span>N-Triples</h3>
<p>Single-graph example: </p>
@@ -1505,7 +1502,7 @@
<section id="subsection-nquads" typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter">
- <h3 aria-level="2" role="heading" id="h3_subsection-nquads"><span class="secno">C.3 </span>N-Quads</h3>
+ <h3 aria-level="2" role="heading" id="h3_subsection-nquads"><span class="secno">C.4 </span>N-Quads</h3>
<p>Multiple-graph example:</p>
@@ -1523,7 +1520,7 @@
<section id="subsection-rdf-xml" typeof="bibo:Chapter" resource="#ref" rel="bibo:Chapter">
- <h3 aria-level="2" role="heading" id="h3_subsection-rdf-xml"><span class="secno">C.4 </span>RDF/XML</h3>
+ <h3 aria-level="2" role="heading" id="h3_subsection-rdf-xml"><span class="secno">C.5 </span>RDF/XML</h3>
<p>Single-graph example:</p>