Feedback from gsnedders via #swig and #whatwg
authorGavin Carothers <gavin@carothers.name>
Wed, 16 May 2012 17:09:09 -0700
changeset 398 23778c42cf06
parent 397 650367ef2743
child 399 a7f534408599
Feedback from gsnedders via #swig and #whatwg

Remove Thrid Edition
Add EBNF version to N-Triples
Explain need to escape "]]>" in XHTML
Add N-Triples example to Introduction
Remove commented out section displaying in Opera
ReSpec.js/js/respec.js
rdf-turtle/index.html
--- a/ReSpec.js/js/respec.js	Wed May 16 07:38:02 2012 -0700
+++ b/ReSpec.js/js/respec.js	Wed May 16 17:09:09 2012 -0700
@@ -1142,7 +1142,7 @@
             }
             if (this.appendixMode) secnos[0] = this.alphabet.charAt(current[0] - this.lastNonAppendix);
             var secno = secnos.join(".");
-            if (!/\./.test(secno)) secno = secno + ".";
+            if (!/\./.test(secno)) secno = secno;
             var df = sn.documentFragment();
             sn.element("span", { "class": "secno" }, df, secno + " ");
             // sn.text(" ", df);
--- a/rdf-turtle/index.html	Wed May 16 07:38:02 2012 -0700
+++ b/rdf-turtle/index.html	Wed May 16 17:09:09 2012 -0700
@@ -132,8 +132,6 @@
 			natural text form, with abbreviations for common usage patterns and
 			datatypes.  Turtle provides levels of compatibility with the existing
 			<a href="http://www.w3.org/TR/rdf-testcases/#ntriples">N-Triples</a>
-			<!-- and
-			<a href="http://www.w3.org/DesignIssues/Notation3">Notation 3</a> -->
 			format as well as the triple pattern syntax of the
 			<a href="http://www.w3.org/TR/sparql11-query/">SPARQL</a>
 			W3C Recommendation.
@@ -166,7 +164,7 @@
 			</p>
 
 			<p>
-			  A Turtle or N-Triple document is a textual representations of a RDF graph. The following Turtle document describes the relationship between Green Goblin and Spiderman.
+			  A Turtle or N-Triple document is a textual representations of a RDF graph. The following Turtle document describes the relationship between Green Goblin and Spiderman. The N-Triples document after it describles the same relationship.
 			</p>
 			<pre class="example"><script type="text/turtle">@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
 @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@@ -182,6 +180,14 @@
     rel:enemyOf <http://example.org/#green-goblin> ;
     a foaf:Person ;
     foaf:name "Spiderman", "Spïdermann"@de .</script></pre>
+    <pre class="example n-triples"><script type="application/n-triples"><http://example.org/#green-goblin> <http://www.perceive.net/schemas/relationship/enemyOf> <http://example.org/#spiderman> .
+<http://example.org/#green-goblin> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
+<http://example.org/#green-goblin> <http://xmlns.com/foaf/0.1/name> "Green Goblin" .
+<http://example.org/#spiderman> <http://www.perceive.net/schemas/relationship/enemyOf> <http://example.org/#green-goblin> .
+<http://example.org/#spiderman> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
+<http://example.org/#spiderman> <http://xmlns.com/foaf/0.1/name> "Spiderman" .
+<http://example.org/#spiderman> <http://xmlns.com/foaf/0.1/name> "Spïdermann"@de .</script>
+    </pre>
 
     		<p>
 			  The Turtle grammar for <a href="#grammar-production-triples"><code>triples</code></a> is a subset of the <a href="http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/">SPARQL Query Language for RDF</a> [[RDF-SPARQL-QUERY]] grammar for <a href="http://www.w3.org/TR/sparql11-query/#rTriplesBlock"><code>TriplesBlock</code></a>.
@@ -536,38 +542,6 @@
 
 			</section>
 		</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 <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> directives 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>
-
-			<p>Example (<a href="tests/test-30.ttl">test-30.ttl</a>) with document base IRI 
-			http://www.w3.org/2001/sw/DataAccess/df1/tests/</p>
-
-			<div data-include="tests/test-30.ttl" data-oninclude="updateExample">
-			</div>
-			<p>encodes the following N-Triples
-			(<a href="tests/test-30.out">test-30.out</a>):
-
-			</p>
-			<div data-include="tests/test-30.out" data-oninclude="updateExample">
-			</div>
-
-			<p>The Turtle syntax for literals and blank nodes are defined by <a href="http://www.w3.org/TR/rdf-sparql-query/#QSynLiterals">SPARQL Query section 4.1.2</a> and <a href="http://www.w3.org/TR/rdf-sparql-query/#QSynBlankNodes">SPARQL Query section 4.1.4</a> respectively.</p>
-		</section -->
         <section id="sec-grammar">
           <h2>Turtle Grammar</h2>
 
@@ -748,7 +722,7 @@
           </section>
           <section id="sec-grammar-grammar">
           <h3>Grammar</h3>
-            <p>The <abbr title="Extended Backus–Naur Form">EBNF</abbr> used here is defined in XML 1.0 (Third Edition)
+            <p>The <abbr title="Extended Backus–Naur Form">EBNF</abbr> used here is defined in XML 1.0
             [[!EBNF-NOTATION]]. Production labels consisting of a number and a final 's', e.g. [<a href="http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/#rRDFLiteral"><span class="prodNo">60s</span></a>], reference the production with that number in the <a href="http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/#sparqlGrammar">SPARQL Query Language for RDF grammar</a> [[RDF-SPARQL-QUERY]].
             </p>
             <div data-include="turtle-bnf.html">
@@ -1020,8 +994,7 @@
 <strong># ]]></strong>
 &lt;/script>
         </pre>
-          <p>When embedded in XHTML Turtle data blocks MUST be enclosed in CDATA sections. Those CDATA markers MUST be 
-          in Turtle comments. This will also make Turtle safe in polyglot documents served as both <code>text/html</code>
+          <p>When embedded in XHTML Turtle data blocks MUST be enclosed in CDATA sections. Those CDATA markers MUST be in Turtle comments. If the character sequence "<code>]]></code>" occurs in the document it MUST be escaped using strings escapes (<code>\u005d\u0054\u003e</code>). This will also make Turtle safe in polyglot documents served as both <code>text/html</code>
           and <code>application/xhtml+xml</code>.</p>
         </section>
         <section>
@@ -1224,6 +1197,8 @@
           <h3>Grammar</h3>
           <p>A N-Triples document is a Unicode[[!UNICODE]] character string encoded in UTF-8.
           Unicode codepoints only in the range U+0 to U+10FFFF inclusive are allowed.</p>
+          <p>The <abbr title="Extended Backus–Naur Form">EBNF</abbr> used here is defined in XML 1.0
+            [[!EBNF-NOTATION]].</p>
           <p><a href="#sec-escapes">Escape sequence rules</a> are the same as Turtle. However, as only the <code>STRING_LITERAL2</code> production is allowed new lines in literals MUST be escaped.</p>
           <div data-include="n-prime-bnf.html">
           </div>