Talk about IRIs not URIs, point to ED of RDF Concepts
authorGavin Carothers <gavin@carothers.name>
Fri, 08 Jul 2011 11:01:50 -0700
changeset 73 ba887d3f4cad
parent 72 1a7f77a25239
child 74 1be5f415036d
Talk about IRIs not URIs, point to ED of RDF Concepts
rdf-turtle/index.html
--- a/rdf-turtle/index.html	Wed Jul 06 10:06:26 2011 -0700
+++ b/rdf-turtle/index.html	Fri Jul 08 11:01:50 2011 -0700
@@ -157,15 +157,15 @@
 			</p>
 
 			<p>There are three types of <em>RDF Term</em>:
-			<a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-URI-reference">RDF URI References</a> (URIs for short),
-			<a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-literal">literals</a> and
-			<a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-blank-node">blank nodes</a>.</p>
+			<a href="http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#dfn-iri">Internationalized Resource Identifiers</a> (IRIs for short),
+			<a href="http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#dfn-literal">literals</a> and
+			<a href="http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#dfn-blank-node">blank nodes</a>.</p>
 
 			<section id="terms">
 				<h3>RDF Terms</h3>
 
-				<p>URIs are written enclosed in '&lt;' and '&gt;' and may be
-				absolute RDF URI References or relative to the current base URI
+				<p>IRIs are written enclosed in '&lt;' and '&gt;' and may be
+				absolute RDF IRI References or relative to the current base IRI
 				(described below).
 				</p>
 
@@ -178,18 +178,18 @@
 <>
 </script></pre>
 
-				<p>URIs may also be abbreviated by using Turtle's <code>@prefix</code>
+				<p>IRIs may also be abbreviated by using Turtle's <code>@prefix</code>
 				directive that allows declaring a short prefix name for a long prefix
-				of repeated URIs. This is useful for many RDF vocabularies that are
-				all defined in nearby namespace URIs, possibly using XML's namespace
+				of repeated IRIs. This is useful for many RDF vocabularies that are
+				all defined in nearby namespace IRIs, possibly using XML's namespace
 				mechanism that works in a similar fashion.</p>
 
 				<p>Once a prefix such as <code>@prefix foo:
 				&lt;http://example.org/ns#&gt;</code> is defined, any mention of a
 				URI later in the document may use a <em>qualified name</em> that
-				starts <code>foo:</code> to stand for the longer URI.  So for
+				starts <code>foo:</code> to stand for the longer IRI.  So for
 				example, the qualified name <code>foo:bar</code> is a shorthand for
-				the URI <code>http://example.org/ns#bar</code>.</p>
+				the IRI <code>http://example.org/ns#bar</code>.</p>
 
 				<pre class="example"><script type="text/turtle"># this is a complete turtle document
 @prefix foo: <http://example.org/ns> .
@@ -213,11 +213,11 @@
 
 				<p>Literals have either a language suffix or a datatype URI
 				but not both.  Languages are indicated by appending the simple
-				literal with <code>@</code> and the language tag.  Datatype URIs
-				similarly append <code>^^</code> followed by any legal URI form (full
-				or qualified) as described above to give the datatype URI. <span class="non-issue">Literals
+				literal with <code>@</code> and the language tag.  Datatype IRIs
+				similarly append <code>^^</code> followed by any legal IRI form (full
+				or qualified) as described above to give the datatype IRI. <span class="non-issue">Literals
 				may be written without either a language tag or a datatype URI as a
-				shortcut for a literal with the type xsd:string.</span>
+				shortcut for a literal with the type <code>xsd:string</code>.</span>
 				</p>
 
 				<pre class="example"><script type="text/turtle"># this is not a complete turtle document
@@ -251,7 +251,7 @@
 </script></pre>
 
 
-				<p>Literals <span class="non-issue">, prefixed names</span>and URIs may also contain escapes to encode surrounding
+				<p>Literals <span class="non-issue">, prefixed names</span>and IRIs may also contain escapes to encode surrounding
 				syntax, non-printable characters and to encode Unicode characters by
 				codepoint number (although they may also be given directly, encoded
 				as UTF-8).  The character escapes are:</p>
@@ -280,16 +280,16 @@
 				</p>
 
 			</section>
-			<section id="uris">
-				<h3>Abbreviating URIs</h3>
+			<section id="iris">
+				<h3>Abbreviating IRIs</h3>
 
-				<p>The current base URI may be altered in a Turtle document using the
+				<p>The current base IRI may be altered in a Turtle document using the
 				<code>@base</code> directive.  It allows further abbreviation of
 				URIs but is usually for simplifying the URIs in the data, where
 				the prefix directives are for vocabularies that describe the data.</p>
 
-				<p>Whenever this directive appears, it defines the base URI for which
-				all relative URIs are resolved against.  That includes URIs,
+				<p>Whenever this directive appears, it defines the base IRI for which
+				all relative IRIs are resolved against.  That includes IRIs,
 				qualified names, prefix directives as well as later base directives.
 				</p>
 
@@ -309,7 +309,7 @@
 :a5 :b5 :c5 .</script></pre>
 
 
-				<p>The token <code>a</code> is equivalent to the URI
+				<p>The token <code>a</code> is equivalent to the IRI
 				<code>&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;</code>
 				</p>
 
@@ -325,7 +325,7 @@
 				<p>Decimal integers may be written directly and correspond to
 				the XML Schema Datatype
 				<a href="http://www.w3.org/TR/xmlschema-2/#integer">xsd:integer</a>.
-				in both syntax and datatype URI.</p>
+				in both syntax and datatype IRI.</p>
 
 				<pre class="example"><script type="text/turtle">
 # this is not a complete turtle document
@@ -342,7 +342,7 @@
 				<p>Decimal floating point double/fixed precision numbers may be written
 				directly and correspond to the XML Schema Datatype
 				<a href="http://www.w3.org/TR/xmlschema-2/#integer">xsd:double</a>
-				in both syntax and datatype URI.
+				in both syntax and datatype IRI.
 				</p>
 
 				<pre class="example"><script type="text/turtle">
@@ -358,7 +358,7 @@
 				<p>Decimal floating point arbitrary precision numbers may be written
 				directly and correspond to the XML Schema Datatype
 				<a href="http://www.w3.org/TR/xmlschema-2/#integer">xsd:decimal</a>.
-				in both syntax and datatype URI.
+				in both syntax and datatype IRI.
 				</p>
 
 				<pre class="example"><script type="text/turtle">
@@ -377,7 +377,7 @@
 				<code>false</code> and correspond to the
 				the XML Schema Datatype
 				<a href="http://www.w3.org/TR/xmlschema-2/#boolean">xsd:boolean</a>
-				in both syntax and datatype URI.
+				in both syntax and datatype IRI.
 				</p>
 
 				<pre class="example"><script type="text/turtle">
@@ -446,7 +446,7 @@
 
 			<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 URI 
+			<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">
@@ -495,7 +495,7 @@
           <section  id="sec-strings">
             <h3>String Escapes</h3>
 
-            <p>Turtle strings and URIs can use <code>\</code>-escape sequences to
+            <p>Turtle strings and IRIs can use <code>\</code>-escape sequences to
             represent Unicode code points.</p>
 
 
@@ -631,7 +631,7 @@
               <tr id="handle-STRING_LITERAL_LONG1" ><td><a class="type lexicalForm" href="#prod-turtle2-STRING_LITERAL_LONG1" >STRING_LITERAL_LONG1 </a></td><td><a href="http://www.w3.org/TR/rdf-concepts/#dfn-lexical-form">                         lexical form</a></td><td>The characters between the outermost "'''"s are <a href="#unescape">unescaped¹</a> to form the unicode string of a lexical form.</td></tr>
               <tr id="handle-STRING_LITERAL_LONG2" ><td><a class="type lexicalForm" href="#prod-turtle2-STRING_LITERAL_LONG2" >STRING_LITERAL_LONG2 </a></td><td><a href="http://www.w3.org/TR/rdf-concepts/#dfn-lexical-form">                         lexical form</a></td><td>The characters between the outermost '"""'s are <a href="#unescape">unescaped¹</a> to form the unicode string of a lexical form.</td></tr>
               <tr id="handle-LANGTAG"              ><td><a class="type langTag"     href="#prod-turtle2-LANGTAG"              >LANGTAG              </a></td><td><a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-language-identifier">language tag</a></td><td>The characters following the "@" form the unicode string of the language tag.</td></tr>
-              <tr id="handle-RDFLiteral"           ><td><a class="type literal"     href="#prod-turtle2-RDFLiteral"           >RDFLiteral           </a></td><td><a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-literal">            literal     </a></td><td>The literal has a lexical form of the first rule argument (<code>String</code>) and either a language tag of <code>LANGTAG</code> or a datatype URI of <code>URIref</code>, depending on which rule matched the input.</td></tr>
+              <tr id="handle-RDFLiteral"           ><td><a class="type literal"     href="#prod-turtle2-RDFLiteral"           >RDFLiteral           </a></td><td><a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-literal">            literal     </a></td><td>The literal has a lexical form of the first rule argument (<code>String</code>) and either a language tag of <code>LANGTAG</code> or a datatype IRI of <code>IRIref</code>, depending on which rule matched the input.</td></tr>
               <tr id="handle-INTEGER"              ><td><a class="type integer"     href="#prod-turtle2-INTEGER"              >INTEGER              </a></td><td><a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-literal">            literal     </a></td><td>The literal has a lexical form of the input string, and a datatype of xsd:integer.</td></tr>
               <tr id="handle-DECIMAL"              ><td><a class="type decimal"     href="#prod-turtle2-DECIMAL"              >DECIMAL              </a></td><td><a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-literal">            literal     </a></td><td>The literal has a lexical form of the input string, and a datatype of xsd:decimal.</td></tr>
               <tr id="handle-DOUBLE"               ><td><a class="type double"      href="#prod-turtle2-DOUBLE"               >DOUBLE               </a></td><td><a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/#dfn-literal">            literal     </a></td><td>The literal has a lexical form of the input string, and a datatype of xsd:double.</td></tr>
@@ -765,7 +765,7 @@
         </section>
         <section id="sec-identifiers">
           <h2>Identifiers for the Turtle Language</h2>
-          <p>The URI that identifies the Turtle language is:<br />
+          <p>The IRI that identifies the Turtle language is:<br />
           <code>http://www.w3.org/2008/turtle#turtle</code>
           </p>