W3C home > Mailing lists > Public > public-html-commits@w3.org > May 2010

html5/rdfa/drafts/ED-rdfa-in-html-20100503 Overview.html,1.3,1.4 diff-20100304.html,1.3,1.4

From: Manu Sporny via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 04 May 2010 03:51:35 +0000
To: public-html-commits@w3.org
Message-Id: <E1O99AV-0004DX-PO@lionel-hutz.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">&lt;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>&gt;
+ This is how you markup a user in FBML:
+ &lt;span property="ex:markup" datatype="rdf:XMLLiteral"&gt;
+→&lt;p&gt;&lt;fb:user uid="12345"&gt;The User&lt;/fb:user&gt;&lt;/p&gt;
+→&lt;/span&gt;
+<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">&lt;&gt;
+   &lt;http://example.org/vocab#markup&gt;
+      "&lt;p <span class="hilite">xmlns:fb="http://www.facebook.com/2008/fbml"</span>&gt;
+→&lt;fb:user uid="12345"&gt;
+→&lt;/p&gt;"^^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">&lt;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>&gt;<ins class="diff-chg">
+ This is how you markup a user in FBML:
+ &lt;span property="ex:markup" datatype="rdf:XMLLiteral"&gt;
+→&lt;p&gt;&lt;fb:user uid="12345"&gt;The User&lt;/fb:user&gt;&lt;/p&gt;
+→&lt;/span&gt;
+</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">&lt;&gt;<ins class="diff-chg">
+   &lt;http://example.org/vocab#markup&gt;
+      "&lt;p <span class="hilite">xmlns:fb="http://www.facebook.com/2008/fbml"</span>&gt;
+→&lt;fb:user uid="12345"&gt;
+→&lt;/p&gt;"^^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">&lt;!--<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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 4 May 2010 03:51:38 GMT