- From: Manu Sporny via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 04 May 2010 03:51:35 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/rdfa/drafts/ED-rdfa-in-html-20100503
In directory hutz:/tmp/cvs-serv16081
Modified Files:
Overview.html diff-20100304.html
Log Message:
Addressed HTML+RDFa bug #8984 by rewording Invalid XMLLiteral values
section as well as adding an extra example.
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/rdfa/drafts/ED-rdfa-in-html-20100503/Overview.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- Overview.html 4 May 2010 00:24:10 -0000 1.3
+++ Overview.html 4 May 2010 03:51:33 -0000 1.4
@@ -281,15 +281,15 @@
<h3><span class="secno">3.3 </span>Specifying the language for a literal</h3>
<p>RDFa Core 1.1 allows for the
- <a class="tref" title="current_language" href="http://www.w3.org/TR/2010/WD-rdfa-core-20100422/#dfn-current_language">current language</a>
+ <a class="tref" title="current_language" href="http://www.w3.org/TR/rdfa-core#dfn-current_language">current language</a>
to be specified by the Host Language. In order for RDFa Processors to conform
to this specification, they <em class="rfc2119" title="must">must</em> use the mechanism described in
<em>The lang and xml:lang attributes</em> section of the [<a class="bibref" rel="biblioentry" href="#bib-HTML5">HTML5</a>]
specification to determine the
<a class="tref" title="language" href="http://www.w3.org/TR/html5/Overview.html#language">language</a>
- of a node.
+ of a node.</p>
- </p><p>If an author is editing an HTML fragment and is unsure of the final
+ <p>If an author is editing an HTML fragment and is unsure of the final
encapsulating MIME type for their markup, it is suggested that the author
specify both <code>lang</code> and <code>xml:lang</code> where the value in
both attributes is exactly the same.</p>
@@ -308,17 +308,26 @@
well-formed XML document is specified in <a href="http://www.w3.org/TR/REC-xml/#sec-well-formed">Section 2.1 "Well-Formed
XML Documents"</a> of the XML specification.</li>
- <li>A case-insensitive match for the currently active <code>xmlns</code>
- attribute as well as all currently active attributes starting with
- <code>xmlns:</code> <em class="rfc2119" title="must">must</em> be preserved in the generated XMLLiteral. This
- preservation <em class="rfc2119" title="must">must</em> be accomplished by placing all active namespaces in
- each top-level element in the generated XMLLiteral, taking care to not
- over-write pre-existing namespace values.</li>
- </ul>If the input is not a namespace well-formed XML fragment, the
+ <li>The XML fragment, when placed inside of a single root element, <em class="rfc2119" title="must">must</em>
+ retain all active namespace information. The currently active attributes
+ declared using <code>xmlns</code> and <code>xmlns:</code> stored in the
+ RDFa Processor's current
+ <a class="tref" title="evaluation_context" href="http://www.w3.org/TR/rdfa-core#dfn-evaluation_context">evaluation context</a>
+ in the
+ <a class="tref" title="list_of_URI_mappings" href="http://www.w3.org/TR/rdfa-core#dfn-list_of_uri_mappings">list of URI mappings</a>
+ <em class="rfc2119" title="must">must</em> be preserved in the generated XMLLiteral. The <em>PREFIX</em> value for
+ <code>xmlns:PREFIX</code> <em class="rfc2119" title="must">must</em> be transformed to all lower-case characters
+ when preserving the value in the XMLLiteral. All active namespaces declared
+ via <code>xmlns</code> and <code>xmlns:</code> <em class="rfc2119" title="must">must</em> be placed in each
+ top-level element in the generated XMLLiteral, taking care to not overwrite
+ pre-existing namespace values.</li>
+ </ul>
+
+ <p>If the input is not a namespace well-formed XML fragment, the
processor <em class="rfc2119" title="must">must</em> transform the input text in a way that ensures the
well-formedness rules described in this section. If a sequence of
characters cannot be transformed into a namespace well-formed XML fragment,
- the triple containing the XMLLiteral <em class="rfc2119" title="must">must</em> not be generated.
+ the triple containing the XMLLiteral <em class="rfc2119" title="must not">must not</em> be generated.</p>
<p>An RDFa Processor that transforms the XML fragment <em class="rfc2119" title="must">must</em> use the <a href="http://www.w3.org/TR/html5/Overview.html#coercing-an-html-dom-into-an-infoset">
Coercing an HTML DOM into an Infoset</a> rules, as specified in the HTML5
@@ -362,6 +371,28 @@
namespaces are not used in either <code>rect</code> element, they are not
preserved in the XMLLiteral.
</p>
+
+<p>Similarly, compound document elements that reside in different
+namespaces must have their namespaces declarations preserved:</p>
+<pre class="example" title="Namespace preservation for compound document elements"><p xmlns:ex="http://example.org/vocab#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ <span class="hilite">xmlns:fb="http://www.facebook.com/2008/fbml"</span>>
+ This is how you markup a user in FBML:
+ <span property="ex:markup" datatype="rdf:XMLLiteral">
+→<p><fb:user uid="12345">The User</fb:user></p>
+→</span>
+<p></p></pre>
+<p>The markup above <em class="rfc2119" title="should">should</em> produce the following triple, which preserves the
+<code>fb</code> namespace in the corresponding triple:</p>
+
+<pre class="example" title="Namespace element preservation triple"><>
+ <http://example.org/vocab#markup>
+ "<p <span class="hilite">xmlns:fb="http://www.facebook.com/2008/fbml"</span>>
+→<fb:user uid="12345">
+→</p>"^^http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral .</pre>
+
+<p></p>
+
</div>
<div id="xmlns--prefixed-attributes" class="section">
Index: diff-20100304.html
===================================================================
RCS file: /sources/public/html5/rdfa/drafts/ED-rdfa-in-html-20100503/diff-20100304.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- diff-20100304.html 4 May 2010 00:24:10 -0000 1.3
+++ diff-20100304.html 4 May 2010 03:51:33 -0000 1.4
@@ -253,20 +253,15 @@
</ins><a href="http://"><ins class="diff-chg">
Creative
Commons
-</ins></a></dd><dd><ins class="diff-chg">
-Mark
-Birbeck,
-</ins><a href="http://"><ins class="diff-chg">
-Web
-Backplane
-Ltd.
</ins></a>
</dd>
<dd>
-<ins class="diff-new">Steven
-Pemberton,
+<ins class="diff-new">Mark
+Birbeck,
</ins><a href="http://"><ins class="diff-new">
-CWI
+Web
+Backplane
+Ltd.
</ins></a>
<del class="diff-old">Manu
Sporny
@@ -283,6 +278,12 @@
Inc.)
</del>
</dd>
+<dd>
+<ins class="diff-new">Steven
+Pemberton,
+</ins><a href="http://"><ins class="diff-new">
+CWI
+</ins></a></dd>
</dl>
<p>
<ins class="diff-new">This
@@ -3338,47 +3339,47 @@
the
following
extensions:
-</ins></p><ul><li><ins class="diff-new">
+</ins></p><ul><li>
The
-</ins><a class="tref" title="default_vocabulary_URI"><ins class="diff-new">
-default
+<a class="tref" title="default_vocabulary_URI">
+<ins class="diff-new">default
vocabulary
URI
</ins></a><ins class="diff-new">
is
-</ins><code><ins class="diff-new">
-http://www.w3.org/1999/xhtml/vocab#
-</ins></code>.</li><li>
+</ins>
+<code>
+<del class="diff-old">lang
+</del>
+<ins class="diff-chg">http://www.w3.org/1999/xhtml/vocab#
+</ins></code>.</li><li><ins class="diff-chg">
The
-<a class="tref" title="default_collection_of_terms">
-<ins class="diff-new">default
+</ins><a class="tref" title="default_collection_of_terms"><ins class="diff-chg">
+default
collection
of
terms
-</ins></a><ins class="diff-new">
+</ins></a><ins class="diff-chg">
is
defined
in
-</ins><a href="#html-default-vocabulary-terms"><ins class="diff-new">
+</ins><a href="#html-default-vocabulary-terms"><ins class="diff-chg">
HTML
Default
Vocabulary
Terms
-</ins></a>.</li><li><ins class="diff-new">
+</ins></a>.</li><li><ins class="diff-chg">
The
-</ins><a class="tref" title="base"><ins class="diff-new">
+</ins><a class="tref" title="base"><ins class="diff-chg">
base
-</ins></a><ins class="diff-new">
+</ins></a><ins class="diff-chg">
can
be
set
using
the
-</ins>
-<code>
-<del class="diff-old">lang
-</del>
-<ins class="diff-chg">base
+</ins><code><ins class="diff-chg">
+base
</ins>
</code>
<del class="diff-old">attribute
@@ -3709,7 +3710,7 @@
allows
for
the
-</ins><a class="tref" title="current_language" href="http://www.w3.org/TR/2010/WD-rdfa-core-20100422/#dfn-current_language"><ins class="diff-chg">
+</ins><a class="tref" title="current_language" href="http://www.w3.org/TR/rdfa-core#dfn-current_language"><ins class="diff-chg">
current
language
</ins></a><ins class="diff-chg">
@@ -3915,17 +3916,43 @@
specification.
</li>
<li>
-A
+<del class="diff-old">A
case-insensitive
match
for
the
+</del>
+<ins class="diff-chg">The
+XML
+fragment,
+when
+placed
+inside
+of
+a
+single
+root
+element,
+</ins><em class="rfc2119" title="must"><ins class="diff-chg">
+must
+</ins></em><ins class="diff-chg">
+retain
+all
+active
+namespace
+information.
+The
+</ins>
currently
active
+<ins class="diff-new">attributes
+declared
+using
+</ins>
<code>
xmlns
</code>
-attribute
+<del class="diff-old">attribute
as
well
as
@@ -3935,10 +3962,30 @@
attributes
starting
with
+</del>
+<ins class="diff-chg">and
+</ins>
<code>
xmlns:
</code>
-<em class="rfc2119" title="must">
+<ins class="diff-new">stored
+in
+the
+RDFa
+Processor's
+current
+</ins><a class="tref" title="evaluation_context" href="http://www.w3.org/TR/rdfa-core#dfn-evaluation_context"><ins class="diff-new">
+evaluation
+context
+</ins></a><ins class="diff-new">
+in
+the
+</ins><a class="tref" title="list_of_URI_mappings" href="http://www.w3.org/TR/rdfa-core#dfn-list_of_uri_mappings"><ins class="diff-new">
+list
+of
+URI
+mappings
+</ins></a><em class="rfc2119" title="must">
must
</em>
be
@@ -3947,18 +3994,56 @@
the
generated
XMLLiteral.
-This
+<del class="diff-old">This
preservation
-<em class="rfc2119" title="must">
+</del>
+<ins class="diff-chg">The
+</ins><em><ins class="diff-chg">
+PREFIX
+</ins></em><ins class="diff-chg">
+value
+for
+</ins><code><ins class="diff-chg">
+xmlns:PREFIX
+</ins></code><em class="rfc2119" title="must">
must
</em>
be
-accomplished
+<del class="diff-old">accomplished
by
placing
+</del>
+<ins class="diff-chg">transformed
+to
+</ins>
all
+<ins class="diff-new">lower-case
+characters
+when
+preserving
+the
+value
+in
+the
+XMLLiteral.
+All
+</ins>
active
namespaces
+<ins class="diff-new">declared
+via
+</ins><code><ins class="diff-new">
+xmlns
+</ins></code><ins class="diff-new">
+and
+</ins><code><ins class="diff-new">
+xmlns:
+</ins></code><em class="rfc2119" title="must"><ins class="diff-new">
+must
+</ins></em><ins class="diff-new">
+be
+placed
+</ins>
in
each
top-level
@@ -3971,12 +4056,16 @@
care
to
not
-over-write
+<del class="diff-old">over-write
+</del>
+<ins class="diff-chg">overwrite
+</ins>
pre-existing
namespace
values.
</li>
</ul>
+<p>
If
the
input
@@ -4027,12 +4116,13 @@
containing
the
XMLLiteral
-<em class="rfc2119" title="must">
+<em class="rfc2119" title="must not">
must
-</em>
not
+</em>
be
generated.
+</p>
<p>
An
RDFa
@@ -4329,9 +4419,58 @@
the
XMLLiteral.
</p>
-</div>
-<div id="xmlns--prefixed-attributes" class="section">
-<h3>
+<p>
+<ins class="diff-chg">Similarly,
+compound
+document
+elements
+that
+reside
+in
+different
+namespaces
+must
+have
+their
+namespaces
+declarations
+preserved:
+</ins></p><pre class="example" title="Namespace preservation for compound document elements"><p xmlns:ex="http://example.org/vocab#"<ins class="diff-chg">
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+</ins> <span class="hilite">xmlns:fb="http://www.facebook.com/2008/fbml"</span>><ins class="diff-chg">
+ This is how you markup a user in FBML:
+ <span property="ex:markup" datatype="rdf:XMLLiteral">
+→<p><fb:user uid="12345">The User</fb:user></p>
+→</span>
+</ins><p></p></pre><p><ins class="diff-chg">
+The
+markup
+above
+</ins><em class="rfc2119" title="should"><ins class="diff-chg">
+should
+</ins></em><ins class="diff-chg">
+produce
+the
+following
+triple,
+which
+preserves
+the
+</ins><code><ins class="diff-chg">
+fb
+</ins></code><ins class="diff-chg">
+namespace
+in
+the
+corresponding
+triple:
+</ins></p><pre class="example" title="Namespace element preservation triple"><><ins class="diff-chg">
+ <http://example.org/vocab#markup>
+ "<p <span class="hilite">xmlns:fb="http://www.facebook.com/2008/fbml"</span>>
+→<fb:user uid="12345">
+→</p>"^^http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral
+.
+</ins></pre><p></p></div><div id="xmlns--prefixed-attributes" class="section"><h3>
<span class="secno">
<del class="diff-old">4.3
</del>
@@ -6265,8 +6404,10 @@
<ins class="diff-chg">resource.
</ins></dd><dt><ins class="diff-chg">
appendix
-</ins></dt><dd><ins class="diff-chg">
-Refers
+</ins>
+</dt>
+<dd>
+<ins class="diff-new">Refers
to
a
resource
@@ -6277,12 +6418,10 @@
in
a
collection.
-</ins></dd><dt><ins class="diff-chg">
+</ins></dd><dt><ins class="diff-new">
bookmark
-</ins>
-</dt>
-<dd>
-<ins class="diff-new">Refers
+</ins></dt><dd><ins class="diff-new">
+Refers
to
a
bookmark.
@@ -6709,10 +6848,8 @@
collection.
</ins></dd><dt><ins class="diff-chg">
start
-</ins>
-</dt>
-<dd>
-<ins class="diff-new">Refers
+</ins></dt><dd><ins class="diff-chg">
+Refers
to
the
first
@@ -6735,16 +6872,18 @@
in
a
book.
-</ins></dd><dt><ins class="diff-new">
+</ins></dd><dt><ins class="diff-chg">
top
-</ins></dt><dd><ins class="diff-new">
+</ins></dt><dd><ins class="diff-chg">
Synonym
for
start.
-</ins></dd><dt><ins class="diff-new">
+</ins></dd><dt><ins class="diff-chg">
up
-</ins></dt><dd><ins class="diff-new">
-Refers
+</ins>
+</dt>
+<dd>
+<ins class="diff-new">Refers
to
the
resource
@@ -6813,8 +6952,9 @@
HTML
4.01
+
+</ins>
RDFa
-1.1
+<ins class="diff-new">1.1
DTD
</ins></h3><div><p>You can download this version of this file from <a href="DTD/html401-rdfa11-1.dtd">DTD/html401-rdfa11-1.dtd</a>. The latest version is available at <a href="http://www.w3.org/MarkUp/DTD/html401-rdfa11-1.dtd">http://www.w3.org/MarkUp/DTD/html401-rdfa11-1.dtd</a>.</p><pre class="dtd"><!--<ins class="diff-new">
This is the HTML 4.01 + RDFa 1.1 DTD, which includes
@@ -7824,9 +7964,8 @@
(title,
paragraphs,
links),
-</ins>
RDFa
-<ins class="diff-new">provides
+provides
a
mechanism
to
@@ -8592,17 +8731,15 @@
http://www.w3.org/TR/2008/REC-rdfa-syntax-20081014
</ins></a></dd><dt id="bib-XHTML-RDFA"><ins class="diff-chg">
[XHTML-RDFA]
-</ins>
-</dt>
-<dd>
-<ins class="diff-new">Shane
+</ins></dt><dd><ins class="diff-chg">
+Shane
McCarron;
et.
al.
-</ins><a href="http://www.w3.org/TR/2010/WD-xhtml-rdfa-20100422"><cite><ins class="diff-new">
+</ins><a href="http://www.w3.org/TR/2010/WD-xhtml-rdfa-20100422"><cite><ins class="diff-chg">
XHTML+RDFa
1.1.
-</ins></cite></a><ins class="diff-new">
+</ins></cite></a><ins class="diff-chg">
22
April
2010.
@@ -8610,11 +8747,12 @@
Working
Draft.
URL:
-</ins><a href="http://www.w3.org/TR/2010/WD-xhtml-rdfa-20100422"><ins class="diff-new">
+</ins><a href="http://www.w3.org/TR/2010/WD-xhtml-rdfa-20100422"><ins class="diff-chg">
http://www.w3.org/TR/WD-xhtml-rdfa-20100422
-</ins></a></dd><dt id="bib-XHTML-VOCAB"><ins class="diff-new">
+</ins></a></dd><dt id="bib-XHTML-VOCAB"><ins class="diff-chg">
[XHTML-VOCAB]
-</ins></dt>
+</ins>
+</dt>
<dd>
XHTML
<del class="diff-old">and
Received on Tuesday, 4 May 2010 03:51:37 UTC