Cleaning up normative references
authorYves Raimond <yves.raimond@bbc.co.uk>
Wed, 14 Aug 2013 16:20:04 +0100
changeset 999 75658de5ed83
parent 998 6e35a86a1cd8
child 1000 88fb508a2db3
Cleaning up normative references
rdf-primer/index.html
--- a/rdf-primer/index.html	Wed Aug 14 13:39:36 2013 +0100
+++ b/rdf-primer/index.html	Wed Aug 14 16:20:04 2013 +0100
@@ -169,7 +169,7 @@
     knows Alice, as identified by her IRI.
     Retrieving Alice's IRI could then provide more data about her, including links
     to other datasets for her friends, interests, etc. A person or
-    an automated process can then follow such links and aggregate data about those
+    an automated process can then follow such links and aggregate data about these
     various things. Such uses of RDF are often
     qualified as <a href="http://linkeddata.org">Linked Data</a>. </p>
 
@@ -178,8 +178,9 @@
     <ul>
       <li>A document describing the basic concepts underlying RDF, as
       well as abstract syntax ("RDF Concepts and Abstract Syntax" [[!RDF-CONCEPTS]])
-      <li>Specifiations of alternative concrete syntaxes for RDF: Turtle [[TURTLE-TR]], RDFa
-      [[RDFA-PRIMER]], RDF/XML [[RDF-SYNTAX-GRAMMAR]]</li> 
+      <li>Specifiations of alternative concrete syntaxes for RDF: N-Triples [[N-TRIPLES]], 
+      N-Quads [[N-QUADS]], Turtle [[TURTLE-TR]], TriG [[TRIG]], RDFa
+      [[RDFA-PRIMER]], JSON-LD [[JSON-LD]], RDF/XML [[RDF-SYNTAX-GRAMMAR]]</li> 
       <li>The RDF Vocabulary Description Language ([[RDF-SCHEMA]]),</li>
       <li>A document describing the formal model-theoretic semantics
       of RDF ("RDF Semantics" [[!RDF-MT]])</li>
@@ -356,7 +357,7 @@
 
       <h3>N-Triples</h3>
 
-      <p><a href="http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-turtle/n-triples.html">N-Triples</a>
+      <p>N-Triples [[N-TRIPLES]]
       provides a simple line-based, plain text way for serializing RDF graphs. Each line represents
       an RDF triple. Its subject, predicate and object are separated by white space. Our example
       can be represented in N-Triples as follows.</p>
@@ -381,7 +382,7 @@
 
       <h3>Turtle</h3>
 
-      <p><a href="http://www.w3.org/TR/turtle/">Turtle</a> provides a convenient syntax for RDF graphs, introducing numerous
+      <p>Turtle [[TURTLE-TR]] provides a convenient syntax for RDF graphs, introducing numerous
       syntax shortcuts when compared with N-Triples, such as the support for namespaces, lists and shorthands for data-typed
       literals. Turtle provides a good trade-off between ease of writing, ease of parsing and readability. Our example can be represented in
       Turtle as follows.</p>
@@ -415,7 +416,7 @@
 
       <h3>JSON-LD</h3>
 
-      <p><a href="http://www.w3.org/TR/json-ld-syntax/">JSON-LD</a> provides a JSON syntax for RDF graphs and datasets.
+      <p>JSON-LD [[JSON-LD]] provides a JSON syntax for RDF graphs and datasets.
       JSON-LD can be used to transform JSON documents to RDF with minimal changes, therefore bringing the benefits of RDF to the JSON
       world. These benefits include universal identifiers for JSON objects, a mechanism in which a JSON document can refer to
       an object described in another JSON document elsewhere on the Web, as well as datatype and language handling. Our example
@@ -458,11 +459,19 @@
 
     </section>
 
+    <section id="subsection-rdfa">
+
+      <h3>RDFa</h3>
+
+      <p>RDFa [[RDFA-PRIMER]] can be used to embed RDF data within HTML documents. </p>
+
+    </section>
+
     <section id="subsection-rdfxml">
 
       <h3>RDF/XML</h3>
 
-      <p><a href="http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-xml/index.html">RDF/XML</a> provides an XML syntax for RDF
+      <p>RDF/XML [[RDF-SYNTAX-GRAMMAR]] provides an XML syntax for RDF
       graphs. RDF/XML was the only normative syntax for RDF before the RDF 1.1 set of recommendations, introducing multiple
       syntaxes for RDF graphs. Our example can be represented in RDF/XML as follows.</p>
 
@@ -504,7 +513,7 @@
 
       <h3>N-Quads</h3>
 
-      <p><a href="https://dvcs.w3.org/hg/rdf/raw-file/default/nquads/index.html">N-Quads</a> is
+      <p>N-Quads [[N-QUADS]] is
       a simple extension to N-Triples enabling the exchange of RDF datasets. N-Quads adds a fourth
       element to each line, capturing the graph IRI of the triple described on that line. For example
       we could split our "Mona Lisa" example in two graphs <a href="#subsection-graphs">as we did above</a>
@@ -527,7 +536,7 @@
 
       <h3>TriG</h3>
 
-      <p><a href="https://dvcs.w3.org/hg/rdf/raw-file/default/trig/index.html">TriG</a>
+      <p>TriG [[TRIG]]
       is an extension to the Turtle syntax enabling the exchange of RDF datasets. For example we could write
       our example in TriG as follows.</p>
 
@@ -566,7 +575,12 @@
 
       <h3>JSON-LD</h3>
 
-      <p><a href="http://www.w3.org/TR/json-ld-syntax/">JSON-LD</a> also provides a way to serialize RDF datasets, through the use of the <code>@graph</code> keyword.</p>
+      <p>JSON-LD [[JSON-LD]] also provides a way to serialize RDF datasets
+      through the use of the <code>@graph</code> keyword.
+      We could write our dataset example in JSON-LD as follows.</p>
+
+      <pre>
+      </pre>
 
     </section>
 
@@ -576,7 +590,7 @@
 
     <h2>RDF Data and Vocabularies</h2>
 
-    <p>
+    <p></p>
 
 </section>
 
@@ -584,10 +598,10 @@
 
     <h2>RDF Graphs and what you can do with them</h2>
 
-    <p>
+    <p></p>
 
 </section>
-    
+
 <section id="section=multiple-graphs">
 
     <h2>Multiple graphs</h2>