Comments language fix, link to RFC3986, example fix, language example now with unicode
authorGavin Carothers <gavin@carothers.name>
Mon, 18 Jul 2011 09:37:44 -0700
changeset 87 c0a2cc504881
parent 86 19ed68f6bfef
child 88 d74c1b87d47f
Comments language fix, link to RFC3986, example fix, language example now with unicode
rdf-turtle/index.html
--- a/rdf-turtle/index.html	Fri Jul 15 12:03:02 2011 -0400
+++ b/rdf-turtle/index.html	Mon Jul 18 09:37:44 2011 -0700
@@ -157,7 +157,7 @@
 
 			<p>A Turtle document allows writing down an RDF graph in a compact
 			textual form.  It consists of a sequence of directives, triple-generating
-			statements or blank lines.  Comments may be given after a <code>#</code>
+			statements or blank lines.  Comments may be given after a <code>#</code> that is not part of another lexical token
 			and continue to the end of the line.</p>
 
 			<p>Simple triples are a sequence of (subject, predicate, object)
@@ -206,8 +206,8 @@
 				the IRI <code>http://example.org/ns#bar</code>.</p>
 
 				<pre class="example"><script type="text/turtle"># this is a complete turtle document
[email protected] foo: <http://example.org/ns> .
[email protected] : <http://other.example.org/ns> .
[email protected] foo: <http://example.org/ns#> .
[email protected] : <http://other.example.org/ns#> .
 foo:bar foo: : .
 :bar : foo:bar .
 </script></pre>
@@ -235,15 +235,16 @@
 				</p>
 
 				<pre class="example"><script type="text/turtle"># this is not a complete turtle document
-"chat"
-"chat"@en
-"chat"@fr
-"foo"^^<http://example.org/my/datatype>
+"That Seventies Show"
+"That Seventies Show"@en
+"Cette Série des Années Soixante-dix"@fr
+"Cette Série des Années Septante"@fr-be
+"mylexicaldata"^^<http://example.org/my/datatype>
 """10"""^^xsd:decimal
 </script></pre>
 
 				<p>
-				  The <code>"chat"</code> above is equivalent to <code>"chat"^^xsd:string</code>.
+				  The <code>"That Seventies Show"</code> above is equivalent to <code>"That Seventies Show"^^xsd:string</code>.
 				</p>
 
 				<p class="issue">
@@ -439,8 +440,8 @@
 				<pre class="example"><script type="text/turtle">
 # this is a complete turtle document
 @prefix : <http://example.org/foo> .
-# the value of this triple is the RDF collection blank node
-:subject :predicate ( :a : b : c ) .
+# the object of this triple is the RDF collection blank node
+:subject :predicate ( :a :b :c ) .
 
 # an empty collection value - rdf:nil
 :subject :predicate2 () .
@@ -453,8 +454,19 @@
 		</section>
 		<section id="sec-syntax">
 			<h3>Syntax for IRIs, Literals and Blank Nodes</h3>
-			<p>Turtle is a language for an <a href="../rdf-concepts/index.html#dfn-rdf-graph">RDF graph</a>, a set of <a href="../rdf-concepts/index.html#dfn-rdf-triple">RDF triple</a>s. An RDF graph is composed of <a href="../rdf-concepts/index.html#dfn-iri">URI reference</a>s (now interpreted as IRIs), <a href="../rdf-concepts/index.html#dfn-literal">literal</a>s and <a href="../rdf-concepts/index.html#dfn-blank-node">blank node</a>s.</p>
-			<p>The Turtle syntax for IRIs is identical to that of SPARQL Query, including the use of <code>prefix</code> and <code>base</code> directives, though these are spelled <code>@prefix</code> and <code>@base</code> respectively in Turtle. Per RFC3986 section 5.1.1, the parsing begins with a context-defined In-Scope Base URI. Each <code>@base</code> directive sets a new In-Scope Base URI, relative to the previous one. <code>@prefix</code> directives map a local name to an IRI, also resolved against the current In-Scope Base URI. Subsequent <code>@prefix</code> may re-map the same local name.</p>
+			<p>Turtle is a language for an <a href="../rdf-concepts/index.html#dfn-rdf-graph">RDF graph</a>,
+			a set of <a href="../rdf-concepts/index.html#dfn-rdf-triple">RDF triple</a>s. An RDF graph is 
+			composed of <a href="../rdf-concepts/index.html#dfn-iri">URI reference</a>s (now interpreted as IRIs),
+			<a href="../rdf-concepts/index.html#dfn-literal">literal</a>s and 
+			<a href="../rdf-concepts/index.html#dfn-blank-node">blank node</a>s.</p>
+			<p>The Turtle syntax for IRIs is identical to that of SPARQL Query, including the use of 
+			<code>prefix</code> and <code>base</code> directives, though these are spelled 
+			<code>@prefix</code> and <code>@base</code> respectively in Turtle. 
+			Per <a href="http://tools.ietf.org/html/rfc3986#section-5.1.1">RFC3986 section 5.1.1</a> [[!RFC3986]], 
+			the parsing begins with a context-defined In-Scope Base URI. Each <code>@base</code> directive 
+			sets a new In-Scope Base URI, relative to the previous one. <code>@prefix</code> directives 
+			map a local name to an IRI, also resolved against the current In-Scope Base URI. 
+			Subsequent <code>@prefix</code> may re-map the same local name.</p>
 
 			<p>Turtle IRI syntax, including relative IRI resolution, is defined by <a href="http://www.w3.org/TR/rdf-sparql-query/#QSynIRI">SPARQL Query section 4.1.1</a> (noting the different spellings of the <code>PREFIX</code> and <code>BASE</code> keywords).</p>