[html5] r3663 - [e] (0) Mention that microdata does not imply a relationship with the document's [...]

whatwg at whatwg.org whatwg at whatwg.org
Sun Aug 23 02:02:20 PDT 2009


Author: ianh
Date: 2009-08-23 02:02:19 -0700 (Sun, 23 Aug 2009)
New Revision: 3663

Modified:
   index
   source
Log:
[e] (0) Mention that microdata does not imply a relationship with the document's contents.

Modified: index
===================================================================
--- index	2009-08-23 08:43:30 UTC (rev 3662)
+++ index	2009-08-23 09:02:19 UTC (rev 3663)
@@ -582,11 +582,12 @@
   <ol>
    <li><a href=#introduction-1><span class=secno>5.1 </span>Introduction</a>
     <ol>
-     <li><a href=#the-basic-syntax><span class=secno>5.1.1 </span>The basic syntax</a></li>
-     <li><a href=#typed-items><span class=secno>5.1.2 </span>Typed items</a></li>
-     <li><a href=#selecting-names-when-defining-vocabularies><span class=secno>5.1.3 </span>Selecting names when defining vocabularies</a></li>
-     <li><a href=#predefined-vocabularies><span class=secno>5.1.4 </span>Predefined vocabularies</a></li>
-     <li><a href=#using-the-microdata-dom-api><span class=secno>5.1.5 </span>Using the microdata DOM API</a></ol></li>
+     <li><a href=#overview><span class=secno>5.1.1 </span>Overview</a></li>
+     <li><a href=#the-basic-syntax><span class=secno>5.1.2 </span>The basic syntax</a></li>
+     <li><a href=#typed-items><span class=secno>5.1.3 </span>Typed items</a></li>
+     <li><a href=#selecting-names-when-defining-vocabularies><span class=secno>5.1.4 </span>Selecting names when defining vocabularies</a></li>
+     <li><a href=#predefined-vocabularies><span class=secno>5.1.5 </span>Predefined vocabularies</a></li>
+     <li><a href=#using-the-microdata-dom-api><span class=secno>5.1.6 </span>Using the microdata DOM API</a></ol></li>
    <li><a href=#encoding-microdata><span class=secno>5.2 </span>Encoding microdata</a>
     <ol>
      <li><a href=#the-microdata-model><span class=secno>5.2.1 </span>The microdata model</a></li>
@@ -41914,10 +41915,9 @@
 
 -->
 
-
   <h3 id=introduction-1><span class=secno>5.1 </span>Introduction</h3>
 
-  <h4 id=the-basic-syntax><span class=secno>5.1.1 </span>The basic syntax</h4>
+  <h4 id=overview><span class=secno>5.1.1 </span>Overview</h4>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -41928,8 +41928,16 @@
   in a consistent manner.</p>
 
   <p>For this purpose, authors can use the microdata features
-  described in this section.</p>
+  described in this section. Microdata allows nested groups of
+  name-value pairs to be added to documents, in parallel with the
+  existing content.</p>
 
+
+
+  <h4 id=the-basic-syntax><span class=secno>5.1.2 </span>The basic syntax</h4>
+
+  <p><i>This section is non-normative.</i></p>
+
   <p>At a high level, microdata consists of a group of name-value
   pairs. The groups are called <a href=#concept-item title=concept-item>items</a>, and each name-value pair is a
   property. Items and properties are represented by regular
@@ -42090,10 +42098,39 @@
 
   </div>
 
+  <p>It's important to note that there is no relationship between the
+  microdata and the content of the document where the microdata is
+  marked up.</p>
 
+  <div class=example>
 
-  <h4 id=typed-items><span class=secno>5.1.2 </span>Typed items</h4>
+   <p>There is no semantic difference, for instance, between the
+   following two examples:</p>
 
+   <pre><figure>
+ <img src="castle.jpeg">
+ <legend><span item><span itemprop="net.example.name">The Castle</span></span> (1986)</legend>
+</figure></pre>
+
+   <pre><span item><meta itemprop="net.example.name" content="The Castle"></span>
+<figure>
+ <img src="castle.jpeg">
+ <legend>The Castle (1986)</legend>
+</figure></pre>
+
+   <p>Both have a figure with a caption, and both, completely
+   unrelated to the figure, have an item with a name-value pair with
+   the name "net.example.name" and the value "The Castle". The only
+   difference is that if the user drags the caption out of the
+   document, in the former case, the item will be included in the
+   drag-and-drop data. In neither case is the image in any way
+   associated with the item.</p>
+
+  </div>
+
+
+  <h4 id=typed-items><span class=secno>5.1.3 </span>Typed items</h4>
+
   <p><i>This section is non-normative.</i></p>
 
   <p>The examples in the previous section show how information could
@@ -42179,7 +42216,7 @@
   
 
 
-  <h4 id=selecting-names-when-defining-vocabularies><span class=secno>5.1.3 </span>Selecting names when defining vocabularies</h4>
+  <h4 id=selecting-names-when-defining-vocabularies><span class=secno>5.1.4 </span>Selecting names when defining vocabularies</h4>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -42207,7 +42244,7 @@
   </div>
 
 
-  <h4 id=predefined-vocabularies><span class=secno>5.1.4 </span>Predefined vocabularies</h4>
+  <h4 id=predefined-vocabularies><span class=secno>5.1.5 </span>Predefined vocabularies</h4>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -42236,7 +42273,7 @@
   </div>
 
 
-  <h4 id=using-the-microdata-dom-api><span class=secno>5.1.5 </span>Using the microdata DOM API</h4>
+  <h4 id=using-the-microdata-dom-api><span class=secno>5.1.6 </span>Using the microdata DOM API</h4>
 
   <p><i>This section is non-normative.</i></p>
 

Modified: source
===================================================================
--- source	2009-08-23 08:43:30 UTC (rev 3662)
+++ source	2009-08-23 09:02:19 UTC (rev 3663)
@@ -46944,12 +46944,9 @@
 
 -->
 
-<!--END html5-->
-<!--START microdata1--><!--START html5-->
-
   <h3>Introduction</h3>
 
-  <h4>The basic syntax</h4>
+  <h4>Overview</h4>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -46960,8 +46957,18 @@
   in a consistent manner.</p>
 
   <p>For this purpose, authors can use the microdata features
-  described in this section.</p>
+  described in this section. Microdata allows nested groups of
+  name-value pairs to be added to documents, in parallel with the
+  existing content.</p>
 
+
+<!--END html5-->
+<!--START microdata1--><!--START html5-->
+
+  <h4>The basic syntax</h4>
+
+  <p><i>This section is non-normative.</i></p>
+
   <p>At a high level, microdata consists of a group of name-value
   pairs. The groups are called <span
   title="concept-item">items</span>, and each name-value pair is a
@@ -47128,8 +47135,37 @@
 
   </div>
 
+  <p>It's important to note that there is no relationship between the
+  microdata and the content of the document where the microdata is
+  marked up.</p>
 
+  <div class="example">
 
+   <p>There is no semantic difference, for instance, between the
+   following two examples:</p>
+
+   <pre><figure>
+ <img src="castle.jpeg">
+ <legend><span item><span itemprop="net.example.name">The Castle</span></span> (1986)</legend>
+</figure></pre>
+
+   <pre><span item><meta itemprop="net.example.name" content="The Castle"></span>
+<figure>
+ <img src="castle.jpeg">
+ <legend>The Castle (1986)</legend>
+</figure></pre>
+
+   <p>Both have a figure with a caption, and both, completely
+   unrelated to the figure, have an item with a name-value pair with
+   the name "net.example.name" and the value "The Castle". The only
+   difference is that if the user drags the caption out of the
+   document, in the former case, the item will be included in the
+   drag-and-drop data. In neither case is the image in any way
+   associated with the item.</p>
+
+  </div>
+
+
   <h4>Typed items</h4>
 
   <p><i>This section is non-normative.</i></p>
@@ -47839,7 +47875,6 @@
 <!--START microdata2-->
 <!--END microdata2-->
 <!--START microdata3-->
-
 <!--END microdata3-->
 <!--START html5-->
 




More information about the Commit-Watchers mailing list