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

html5/spec Overview.html,1.2237,1.2238

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 11 May 2009 03:46:13 +0000
To: public-html-commits@w3.org
Message-Id: <E1M3MSz-0008Ie-V1@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv31890

Modified Files:
	Overview.html 
Log Message:
More microdata intro text. (whatwg r3080)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2237
retrieving revision 1.2238
diff -u -d -r1.2237 -r1.2238
--- Overview.html	11 May 2009 00:14:29 -0000	1.2237
+++ Overview.html	11 May 2009 03:46:10 -0000	1.2238
@@ -152,7 +152,7 @@
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
    <!--ZZZ:-->
    <!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
-   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 10 May 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 11 May 2009</h2>
    <!--:ZZZ-->
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -245,7 +245,7 @@
   track.
   <!--ZZZ:-->
   <!--This specification is the 23 April 2009 Working Draft.-->
-  This specification is the 10 May 2009 Editor's Draft.
+  This specification is the 11 May 2009 Editor's Draft.
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -732,7 +732,8 @@
    <li><a href="#introduction-2"><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="#defining-vocabularies"><span class="secno">5.1.2 </span>Defining vocabularies</a></ol></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></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>
@@ -36262,9 +36263,8 @@
 &lt;/div&gt;</pre>
 
   </div><p>Properties can also have values that are dates, times, or dates
-  and times. This is achieved using the <code title="">time</code>
-  element and its <code title="attr-time-datetime"><a href="#attr-time-datetime">datetime</a></code>
-  attribute.<div class="example">
+  and times. This is achieved using the <code><a href="#the-time-element">time</a></code> element and
+  its <code title="attr-time-datetime"><a href="#attr-time-datetime">datetime</a></code> attribute.<div class="example">
 
    <p>In this example, the item has one property, "birthday", whose
    value is a date:</p>
@@ -36282,15 +36282,93 @@
 
    <pre>&lt;div item&gt;
  &lt;p&gt;Name: &lt;span property="name"&gt;Amanda&lt;/span&gt;&lt;/p&gt;
- &lt;p&gt;Band: &lt;span property="band" item&gt; &lt;span property="name"&gt;Jazz Band&lt;/span&gt; (&lt;span property="size"&gt;12&lt;/span&gt; players)&lt;/span&gt;&lt;/span&gt;&lt;/p&gt;
+ &lt;p&gt;Band: &lt;span property="band" item&gt; &lt;span property="name"&gt;Jazz Band&lt;/span&gt; (&lt;span property="size"&gt;12&lt;/span&gt; players)&lt;/span&gt;&lt;/p&gt;
 &lt;/div&gt;</pre>
 
    <p>In this example, the outer item has two properties, "name" and
-   "band". The "name" is "Amanda",and the "band" is an item in its own
+   "band". The "name" is "Amanda", and the "band" is an item in its own
    right, with two properties, "name" and "size". The "name" of the
    band is "Jazz Band", and the "size" is "12".</p>
 
-  </div><h4 id="defining-vocabularies"><span class="secno">5.1.2 </span>Defining vocabularies</h4><p><em>This section is non-normative.</em><p>Using microdata means using a vocabulary. For some purposes, an
+  </div><p>Properties don't have to be given as ancestors of the element
+  with the <code title="attr-item"><a href="#items:-the-item-attribute">item</a></code> attribute. They can be
+  associated with a specific <a href="#concept-item" title="concept-item">item</a>
+  using the <code title="attr-subject"><a href="#attr-subject">subject</a></code> attribute, which
+  takes the ID of the element with the <code title="attr-item"><a href="#items:-the-item-attribute">item</a></code> attribute.<div class="example">
+
+   <p>This example is the same as the previous one, but all the
+   properties are separated from their <a href="#concept-item" title="concept-item">items</a>:</p>
+
+   <pre>&lt;div item id="amanda"&gt;&lt;/div&gt;
+&lt;div subject="amanda" property="band" item id="jazzband"&gt;&lt;/div&gt;
+&lt;p&gt;Name: &lt;span subject="amanda" property="name"&gt;Amanda&lt;/span&gt;&lt;/p&gt;
+&lt;p&gt;Band: &lt;span subject="jazzband" property="name"&gt;Jazz Band&lt;/span&gt;&lt;/p&gt;
+&lt;p&gt;Size: &lt;span subject="jazzband" property="size"&gt;12&lt;/span&gt; players&lt;/p&gt;</pre>
+
+   <p>This gives the same result as the previous example. The first
+   item has two properties, "name", set to "Amanda", and "band", set
+   to another item. That second item has two further properties,
+   "name", set to "Jazz Band", and "size", set to "12".</p>
+
+  </div><p>An <a href="#concept-item" title="concept-item">item</a> can have multiple
+  properties with the same name and different values.<div class="example">
+
+   <p>This example describes an ice cream, with two flavors:</p>
+
+   <pre>&lt;div item&gt;
+ &lt;p&gt;Flavors in my favorite ice cream:&lt;/p&gt;
+ &lt;ul&gt;
+  &lt;li property="flavor"&gt;Lemon sorbet&lt;/li&gt;
+  &lt;li property="flavor"&gt;Apricot sorbet&lt;/li&gt;
+ &lt;/ul&gt;
+&lt;/div&gt;</pre>
+
+   <p>This thus results in an item with two properties, both "flavor",
+   having the values "Lemon sorbet" and "Apricot sorbet".</p>
+
+  </div><p>An element introdicing a property can also introduce multiple
+  properties at once, to avoid duplication when some of the properties
+  have the same value.<div class="example">
+
+   <p>Here we see an item with two properties, "favorite-color" and
+   "favorite-fruit", both set to the value "orange":</p>
+
+   <pre>&lt;div item&gt;
+ &lt;span property="favorite-color favorite-fruit"&gt;orange&lt;/span&gt;
+&lt;/div&gt;</pre>
+
+  </div><h4 id="typed-items"><span class="secno">5.1.2 </span>Typed items</h4><p><em>This section is non-normative.</em><p>The examples in the previous section show how information could
+  be marked up on a page that doesn't expect its microdata to be
+  re-used. Microdata is most useful, though, when it is used in
+  contexts where other authors and readers are able to cooperate to
+  make new uses of the markup.<p>For this purpose, it is necessary to give each <a href="#concept-item" title="concept-item">item</a> a type, such as "person", or "cat",
+  or "band". Types are identified in three ways:<ul class="brief"><li>As <a href="#url" title="URL">URLs</a>
+
+   <li>As <a href="#valid-reversed-dns-identifier" title="valid reversed DNS identifier">reversed DNS
+   labels</a>
+
+<!--
+   <li>Using the names of <span>predefined types</span>
+-->
+
+  </ul><p><a href="#url" title="URL">URLs</a> are self-explanatory. <a href="#valid-reversed-dns-identifier" title="valid reversed DNS identifier">Reversed DNS labels</a> are
+  strings such as "org.example.animals.cat" or "org.example.band".<p>The type for an <a href="#concept-item" title="concept-item">item</a> is given
+  as the value of the <code title="attr-item"><a href="#items:-the-item-attribute">item</a></code>
+  attribute.<div class="example">
+
+   <p>Here, the item is "org.example.animals.cat":</p>
+
+<pre>&lt;section item="org.example.animal.cat"&gt;
+ &lt;h1 property="org.example.name"&gt;Hedral&lt;/h1&gt;
+ &lt;p property="org.example.desc"&gt;Hedral is a male american domestic
+ shorthair, with a fluffy black fur with white paws and belly.&lt;/p&gt;
+ &lt;img property="org.example.img" src="hedral.jpeg" alt="" title="Hedral, age 18 months"&gt;
+&lt;/section&gt;</pre>   
+
+  </div><p>When using custom typed items, the property names are also given
+  in this form.</p><!--
+  <p><span>Predefined types</span> are described below.</p>
+--><h4 id="selecting-names-when-defining-vocabularies"><span class="secno">5.1.3 </span>Selecting names when defining vocabularies</h4><p><em>This section is non-normative.</em><p>Using microdata means using a vocabulary. For some purposes, an
   ad-hoc vocabulary is adequate. For others, a vocabulary will need to
   be designed. Where possible, authors are encouraged to re-use
   existing vocabularies, as this makes content re-use easier.<p>When designing new vocabularies, identifiers can be created
Received on Monday, 11 May 2009 03:46:24 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 11 May 2009 03:46:25 GMT