--- a/rdf-primer/index.html Sun Nov 10 21:55:45 2013 +0000
+++ b/rdf-primer/index.html Mon Nov 11 16:38:03 2013 +0100
@@ -108,50 +108,30 @@
representing information about resources in the World Wide
Web. This primer is designed to provide the reader with the basic
knowledge required to effectively use RDF. It introduces the basic
- concepts of RDF and describes its syntax. It describes how to
- define RDF vocabularies using the RDF Vocabulary Description
- Language, and gives an overview of some deployed RDF
- applications. It also describes the content and purpose of other
- RDF 1.1 specification documents.</p>
+ concepts of RDF and shows concrete examples of the use of RDF. It also describes how to
+ define RDF vocabularies using RDF Schema.</p>
+</section>
+
+<section id="sotd">
+
</section>
<section id="section-Introduction">
<h2>Introduction</h2>
- <p class="issue">This document reflects current progress of the RDF Working
+ <div class="issue">This document reflects current progress of the RDF Working
Group towards updating the
<a href="http://www.w3.org/TR/2004/REC-rdf-primer-20040210/">2004
version of the <em>RDF Primer</em></a>. The
editors expect to work on a number of issues, some of which are
- listed in boxes like this throughout the document.</p>
+ listed in boxes like this throughout the document.</div>
<p>The Resource Description Framework (RDF) is a framework for
describing information about <strong>resources</strong> in the World Wide Web,
such as author and modification time of a
Web page or copyright and licensing information of a Web video.</p>
- <p class="note">A Web resource is anything we can point to with a
- Web identifier. Technically, a Web identifier is called an IRI,
- short for "International Resource Identifier". A URL (Uniform
- Resource Locator) which we put in our Web browser is a typical
- example of an IRI: we can <em>retrieve</em> the resource through
- the URL. There are also IRIs that are used to identify things we
- cannot "retrieve", such as people or products. For example, if
- Bob's home page is <code>http://www.example.com/bob</code> a
- popular convention is to use the IRI
- <code>http://www.example.com/bob#me</code> as a Web identifier for
- Bob himself. </p>
-
-<!--
- <p class="issue">Should we get into httpRange-14 here? If not,
- remove the following paragraph below</p>
-
- <p>If you insert this IRI in your browser it may or may not
- retrieve something, but it definitely will not retrieve Bob in
- person (well, at least not with the current state of the art). </p>
--->
-
<p>RDF is intended for situations in which information on the Web needs to
be processed by applications, rather than being only displayed to
people. RDF provides a common framework for expressing this
@@ -173,18 +153,25 @@
various things. Such uses of RDF are often
qualified as Linked Data [[LINKED-DATA]]. </p>
- <p>The primer is not a normative document. Normative documentation
- of RDF can be found in the following documents: </p>
+ <div class="note">
+ An IRI is an "International Resource Identifier". See Sec. <a
+ href="#subsection-IRI">"IRI"</a> for details.
+ </div>
+
+ <p>The primer is not a normative document. Normative
+ specifications of RDF can be found in the following documents: </p>
<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: 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>
+ well as abstract syntax ("RDF Concepts and Abstract Syntax"
+ [[!RDF11-CONCEPTS]])
<li>A document describing the formal model-theoretic semantics
- of RDF ("RDF Semantics") [[!RDF-MT]]</li>
+ of RDF ("RDF Semantics") [[!RDF11-MT]]</li>
+ <li>Specifiations of concrete syntaxes for RDF, such as Turtle
+ [[!TURTLE]] and TriG [[TRIG]]. </li>
+ <li>The RDF Vocabulary Description Language RDF Schema
+ [[RDF-SCHEMA]],</li>
</ul>
+
<p>This primer provides a roadmap for people who want to study the
normative RDF documents (see Sec. <a href="#section-roadmap">"Roadmap"</a>). </p>
@@ -196,7 +183,7 @@
<p>The following illustrates various different uses of RDF, aimed at different communities
of practice.</p>
- <p class="issue">Should we add pointers to specific applications or use-case documents?</p>
+ <div class="issue">Should we add pointers to specific applications or use-case documents?</div>
<ul>
<li>Adding machine-readable information to web pages using for example
@@ -204,9 +191,11 @@
in an enhanced format on search engines or to be processed automatically
by third-party applications.</li>
<li>Enriching a dataset by linking it to third-party datasets. For example a dataset about
- paintings could be enriched by linking them to the corresponding artists in <a href="http://www.wikidata.org">Wikidata</a>,
+ paintings could be enriched by linking them to the corresponding
+ artists in <a href="http://www.wikidata.org">Wikidata</a>,
therefore giving access to a wide range of information about them and related resources.</li>
- <li>Interlinking API feeds, making sure that clients can easily discover how to access more information.</li>
+ <li>Interlinking API feeds, making sure that clients can easily
+ discover how to access more information.</li>
<li>Using the datasets currently published as Linked Data [[LINKED-DATA]], for example
building aggregations of data around specific topics.</li>
<li>Building distributed social networks by interlinking RDF descriptions of people
@@ -258,20 +247,20 @@
<figure>
<img src="images/todo.png" width="50%"
alt="Informal graphs of the four sample triples">
- <figcaption>Informal graphs of the four sample triples</figcaption>
+ <figcaption>Informal graph of the sample triples</figcaption>
</figure>
- <p class="issue">The following is just one way of representing RDF in relational terms, not sure it is needed</p>
+ <div class="issue">The following is just one way of representing RDF in relational terms, not sure it is needed</div>
- <p class="note">Readers familiar with databases could view the RDF
+ <div class="note">Readers familiar with databases could view the RDF
data model as a binary database model, where every distinct
predicate forms a two-column table with subjects in the first
- column and objects in the second column. </p>
+ column and objects in the second column. </div>
<p>In the following sections we discuss the three basic constructs
that appear in RDF statements, namely IRIs, literals and blank nodes, in more detail. </p>
- <p class="issue">Should the text below mention the 'generalized data model' in RDF semantics?</p>
+ <div class="issue">Should the text below mention the 'generalized data model' in RDF semantics?</div>
</section>
@@ -279,6 +268,19 @@
<h3>IRI</h3>
+ <p class="note">A Web resource is anything we can point to with a
+ Web identifier. Technically, a Web identifier is called an IRI,
+ short for "International Resource Identifier". A URL (Uniform
+ Resource Locator) which we put in our Web browser is a typical
+ example of an IRI: we can <em>retrieve</em> the resource through
+ the URL. There are also IRIs that are used to identify things we
+ cannot "retrieve", such as people or products. For example, if
+ Bob's home page is <code>http://www.example.com/bob</code> a
+ popular convention is to use the IRI
+ <code>http://www.example.com/bob#me</code> as a Web identifier for
+ Bob himself. </p>
+
+
<p>IRIs can appear in all three positions of an RDF statement and are specified
in RFC 3987 [[!RFC3987]]. They can be used to identify both documents
(e.g. a Web page) and things (e.g. a person). </p>