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

html5/spec Overview.html,1.2260,1.2261

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 15 May 2009 00:35:10 +0000
To: public-html-commits@w3.org
Message-Id: <E1M4lOI-000701-5z@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv26849

Modified Files:
	Overview.html 
Log Message:
Add vCard example; remove CR from vEvent example; mention 'article' includes blog entries; remove bogus 'conference' entry type in table; add bibtex examples; add support for citation object in JSON output. (whatwg r3103)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2260
retrieving revision 1.2261
diff -u -d -r1.2260 -r1.2261
--- Overview.html	14 May 2009 23:49:34 -0000	1.2260
+++ Overview.html	15 May 2009 00:35:07 -0000	1.2261
@@ -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 14 May 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 15 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 14 May 2009 Editor's Draft.
+  This specification is the 15 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)
@@ -745,11 +745,15 @@
    <li><a href="#microdata-dom-api"><span class="secno">5.3 </span>Microdata DOM API</a></li>
    <li><a href="#predefined-vocabularies"><span class="secno">5.4 </span>Predefined vocabularies</a>
     <ol>
-     <li><a href="#vcard"><span class="secno">5.4.1 </span>vCard</a></li>
+     <li><a href="#vcard"><span class="secno">5.4.1 </span>vCard</a>
+      <ol>
+       <li><a href="#examples"><span class="secno">5.4.1.1 </span>Examples</a></ol></li>
      <li><a href="#vevent"><span class="secno">5.4.2 </span>vEvent</a>
       <ol>
-       <li><a href="#examples"><span class="secno">5.4.2.1 </span>Examples</a></ol></li>
-     <li><a href="#bibtex"><span class="secno">5.4.3 </span>BibTeX</a></li>
+       <li><a href="#examples-0"><span class="secno">5.4.2.1 </span>Examples</a></ol></li>
+     <li><a href="#bibtex"><span class="secno">5.4.3 </span>BibTeX</a>
+      <ol>
+       <li><a href="#examples-1"><span class="secno">5.4.3.1 </span>Examples</a></ol></li>
      <li><a href="#rdf"><span class="secno">5.4.4 </span>RDF</a></ol></li>
    <li><a href="#converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</a>
     <ol>
@@ -37901,20 +37905,80 @@
 
    <dd>
 
-  </dl><!--XXX
+  </dl><h5 id="examples"><span class="secno">5.4.1.1 </span>Examples</h5><div class="example">
 
-  <h5>Examples</h5>
+   <p>Here is a long example <code title="md-vcard"><a href="#md-vcard">vcard</a></code> for a
+   fictional character called "Jack Bauer":</p>
 
-&lt;address item=vcard>
- &lt;strong title="fn">Alfred Person&lt;/strong> &lt;br>
- &lt;span itemprop="adr" item>
-  &lt;span itemprop="street-address">1600 Amphitheatre Parkway&lt;/span> &lt;br>
-  &lt;span itemprop="street-address">Building 43, Second Floor&lt;/span> &lt;br>
-  &lt;span itemprop="locality">Mountain View&lt;/span>,
-   &lt;span itemprop="region">CA&lt;/span> &lt;span itemprop="postal-code">94043&lt;/span>
- &lt;/span>
-&lt;/address>
---><h4 id="vevent"><span class="secno">5.4.2 </span>vEvent</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-vevent" title="md-vevent"><code>vevent</code></dfn> represents an event.<p>The following are the type's <a href="#predefined-property-name" title="predefined property
+   <pre>&lt;section id="jack" item="vcard"&gt;
+ &lt;h1 itemprop="fn"&gt;Jack Bauer&lt;/h1&gt;
+ &lt;img itemprop="photo" alt="" src="jack-bauer.jpg"&gt;
+ &lt;p itemprop="org" item&gt;
+  &lt;span itemprop="organization-name"&gt;Counter-Terrorist Unit&lt;/span&gt;
+  (&lt;span itemprop="organization-unit"&gt;Los Angeles Division&lt;/span&gt;)
+ &lt;/p&gt;
+ &lt;p&gt;
+  &lt;span class="adr" item&gt;
+   &lt;span itemprop="street-address"&gt;10201 W. Pico Blvd.&lt;/span&gt;&lt;br&gt;
+   &lt;span itemprop="locality"&gt;Los Angeles&lt;/span&gt;,
+   &lt;span itemprop="region"&gt;CA&lt;/span&gt;
+   &lt;span itemprop="postal-code"&gt;90064&lt;/span&gt;&lt;br&gt;
+   &lt;span itemprop="country-name"&gt;United States&lt;/span&gt;&lt;br&gt;
+  &lt;/span&gt;
+  &lt;span itemprop="geo"&gt;34.052339;-118.410623&lt;/span&gt;
+ &lt;/p&gt;
+ &lt;h2&gt;Assorted Contact Methods&lt;/h2&gt;
+ &lt;ul&gt;
+  &lt;li itemprop="tel" item&gt;&lt;span itemprop="value"&gt;+1 (310) 597
+  3781&lt;/span&gt; &lt;span itemprop="type"&gt;work&lt;/span&gt;&lt;/li&gt;
+  &lt;li&gt;&lt;a itemprop="url"
+  href="http://en.wikipedia.org/wiki/Jack_Bauer"&gt;I'm on
+  Wikipedia&lt;/a&gt; so you can leave a message on my user talk
+  page.&lt;/li&gt;
+  &lt;li&gt;&lt;a itemprop="url"
+  href="http://www.jackbauerfacts.com/"&gt;Jack Bauer Facts&lt;/a&gt;&lt;/li&gt;
+  &lt;li itemprop="email"&gt;&lt;a
+  href="mailto:j.bauer@la.ctu.gov.invalid"&gt;j.bauer@la.ctu.gov.invalid&lt;/a&gt;&lt;/li&gt;
+  &lt;li itemprop="tel" item&gt;&lt;span itemprop="value"&gt;+1 (310) 555
+  3781&lt;/span&gt; &lt;span&gt;&lt;meta itemprop="type" content="cell"&gt;mobile
+  phone&lt;/span&gt;&gt;&lt;/li&gt;
+ &lt;/ul&gt;
+ &lt;p itemprop="note"&gt;If I'm out in the field, you may be better
+ off contacting &lt;span itemprop="agent" item="vcard"&gt;&lt;a
+ itemprop="email" href="mailto:c.obrian@la.ctu.gov.invalid"&gt;&lt;span
+ itemprop="fn"&gt;Chloe O'Brian&lt;/span&gt;&lt;/a&gt;&lt;/span&gt; if it's about
+ work, or ask &lt;span itemprop="agent"&gt;Tony Almeida&lt;/span&gt; if
+ you're interested in the CTU five-a-side football team we're
+ trying to get going.&lt;/p&gt;
+ &lt;ins datetime="2008-07-20T21:00:00+0100"&gt;
+  &lt;span itemprop="rev" item&gt;
+   &lt;meta itemprop="type" content="date-time"&gt;
+   &lt;meta itemprop="value" content="2008-07-20T21:00:00+0100"&gt;
+  &lt;/span&gt;
+  &lt;p itemprop="tel" item&gt;&lt;strong&gt;Update!&lt;/strong&gt;
+  My new &lt;span itemprop="type"&gt;home&lt;/span&gt; phone number is
+  &lt;span itemprop="value"&gt;01632 960 123&lt;/span&gt;.
+ &lt;/ins&gt;
+&lt;/section&gt;</pre>
+
+  </div><div class="example">
+
+   <p>This example shows a site's contact details (using the
+   <code><a href="#the-address-element">address</a></code> element) containing an address with two street
+   components:</p>
+
+   <pre>
+&lt;address item=vcard&gt;
+ &lt;strong title="fn"&gt;Alfred Person&lt;/strong&gt; &lt;br&gt;
+ &lt;span itemprop="adr" item&gt;
+  &lt;span itemprop="street-address"&gt;1600 Amphitheatre Parkway&lt;/span&gt; &lt;br&gt;
+  &lt;span itemprop="street-address"&gt;Building 43, Second Floor&lt;/span&gt; &lt;br&gt;
+  &lt;span itemprop="locality"&gt;Mountain View&lt;/span&gt;,
+   &lt;span itemprop="region"&gt;CA&lt;/span&gt; &lt;span itemprop="postal-code"&gt;94043&lt;/span&gt;
+ &lt;/span&gt;
+&lt;/address&gt;</pre>
+
+  </div><h4 id="vevent"><span class="secno">5.4.2 </span>vEvent</h4><p>An item with the <a href="#predefined-type">predefined type</a> <dfn id="md-vevent" title="md-vevent"><code>vevent</code></dfn> represents an event.<p>The following are the type's <a href="#predefined-property-name" title="predefined property
   name">predefined property names</a>. They are based on the
   vocabulary defined in the iCalendar specification, where more
   information on how to interpret the values can be found. <a href="#references">[RFC2445]</a><p class="note">Only the parts of the iCalendar vocabulary relating
@@ -38426,7 +38490,7 @@
 
     </ul></li>
 
-  </ol><h5 id="examples"><span class="secno">5.4.2.1 </span>Examples</h5><!-- get more from http://www.ietf.org/rfc/rfc2445.txt --><div class="example">
+  </ol><h5 id="examples-0"><span class="secno">5.4.2.1 </span>Examples</h5><!-- get more from http://www.ietf.org/rfc/rfc2445.txt --><div class="example">
 
    <p>Here is an example of a page that uses the <code title="md-vevent"><a href="#md-vevent">vevent</a></code> vocabulary to mark up an event:</p>
 
@@ -38476,7 +38540,7 @@
       value = value.replace(/\\/g, '\\n');
       value = value.replace(/;/g, '\\;');
       value = value.replace(/,/g, \\,');
-      value = value.replace(/[\r\n]/g, '\\n');
+      value = value.replace(/\n/g, '\\n');
     }
     for (var nameIndex = 0; nameIndex &lt; prop.itemprop.length; nameIndex += 1) {
       var name = prop.itemprop[nameIndex];
@@ -38518,7 +38582,7 @@
     text with one of the following values:</p>
 
     <dl><dt><dfn id="md-bibtex-entrytype-article" title="md-bibtex-entrytype-article"><code>article</code></dfn></dt>
-     <dd><p>A journal or magazine article.</dd>
+     <dd><p>A journal, magazine, or Web site article.</dd>
 
      <dt><dfn id="md-bibtex-entrytype-book" title="md-bibtex-entrytype-book"><code>book</code></dfn></dt>
      <dd><p>A published book or booklet.</dd>
@@ -38760,8 +38824,8 @@
 
    <dd>
 
-    <p>Gives the name of the journal or magazine in which the work
-    cited by the bibliographic entry was published.</p>
+    <p>Gives the name of the journal, magazine, or Web site in which
+    the work cited by the bibliographic entry was published.</p>
 
     <p>The <a href="#concept-property-value" title="concept-property-value">value</a> must be
     text.</p>
@@ -39050,6 +39114,7 @@
       <code title="md-bibtex-number"><a href="#md-bibtex-number">number</a></code>,
       <code title="md-bibtex-pages"><a href="#md-bibtex-pages">pages</a></code>,
       <strong><code title="md-bibtex-title"><a href="#md-bibtex-title">title</a></code></strong>*,
+      <code title="md-bibtex-url"><a href="#md-bibtex-url">url</a></code>, <!-- this is an "innovation"... -->
       <code title="md-bibtex-volume"><a href="#md-bibtex-volume">volume</a></code>,
       <strong><code title="md-bibtex-year"><a href="#md-bibtex-year">year</a></code></strong>*
     <tr><td>
@@ -39080,21 +39145,6 @@
       <strong><code title="md-bibtex-title"><a href="#md-bibtex-title">title</a></code></strong>*,
       <code title="md-bibtex-year"><a href="#md-bibtex-year">year</a></code>
     <tr><td>
-      <code title="md-bibtex-entrytype-conference">conference</code>
-     <td>
-      <code title="md-bibtex-address"><a href="#md-bibtex-address">address</a></code>,
-      <strong><code title="md-bibtex-author"><a href="#md-bibtex-author">author</a></code></strong>*,
-      <strong><code title="md-bibtex-booktitle"><a href="#md-bibtex-booktitle">booktitle</a></code></strong>*,
-      <code title="md-bibtex-editor"><a href="#md-bibtex-editor">editor</a></code>,
-      <code title="md-bibtex-key"><a href="#md-bibtex-key">key</a></code>,
-      <code title="md-bibtex-month"><a href="#md-bibtex-month">month</a></code>,
-      <code title="md-bibtex-note"><a href="#md-bibtex-note">note</a></code>,
-      <code title="md-bibtex-organization"><a href="#md-bibtex-organization">organization</a></code>,
-      <code title="md-bibtex-pages"><a href="#md-bibtex-pages">pages</a></code>,
-      <code title="md-bibtex-publisher"><a href="#md-bibtex-publisher">publisher</a></code>,
-      <strong><code title="md-bibtex-title"><a href="#md-bibtex-title">title</a></code></strong>*,
-      <strong><code title="md-bibtex-year"><a href="#md-bibtex-year">year</a></code></strong>*
-    <tr><td>
       <code title="md-bibtex-entrytype-inbook"><a href="#md-bibtex-entrytype-inbook">inbook</a></code>
      <td>
       <code title="md-bibtex-address"><a href="#md-bibtex-address">address</a></code>,
@@ -39219,13 +39269,28 @@
       <strong><code title="md-bibtex-note"><a href="#md-bibtex-note">note</a></code></strong>*,
       <strong><code title="md-bibtex-title"><a href="#md-bibtex-title">title</a></code></strong>*,
       <code title="md-bibtex-year"><a href="#md-bibtex-year">year</a></code>
-  </table><!--
+  </table><h5 id="examples-1"><span class="secno">5.4.3.1 </span>Examples</h5><div class="example">
 
-  <h5>Examples</h5>
+   <p>This example shows how an article's footer can give the citation
+   information for the article:</p>
 
-  <p class="XXX">...</p>
+   <pre>&lt;article id="friend"&gt;
+ &lt;h1&gt;Friend in the kingdom&lt;/h1&gt;
+ &lt;p&gt;I got a friend in the kingdom, ain't that good news?&lt;/p&gt;
+ &lt;footer&gt;
+  &lt;p item=bibtex&gt;Cite as:
+   &lt;meta itemprop="entrytype" content="article"&gt;
+   &lt;span itemprop="author"&gt;Nerissa Nields and Katryna Nields&lt;/span&gt;
+   &lt;span itemprop="title"&gt;Friend in the Kingdom&lt;/span&gt;
+   &lt;span itemprop="journal"&gt;Ain't That Good News&lt;/span&gt;
+   &lt;span itemprop="year"&gt;2009&lt;/span&gt;
+   &lt;span itemprop="month"&gt;April&lt;/span&gt;
+   &lt;link itemprop="url" href="#friend"&gt; &lt;!-- relative url to this page --&gt;
+  &lt;/p&gt;
+ &lt;/footer&gt;
+&lt;/article&gt;</pre>
 
---><h4 id="rdf"><span class="secno">5.4.4 </span>RDF</h4><p>The <dfn id="md-about" title="md-about"><code>about</code></dfn> property can
+  </div><h4 id="rdf"><span class="secno">5.4.4 </span>RDF</h4><p>The <dfn id="md-about" title="md-about"><code>about</code></dfn> property can
   be used to name an <a href="#concept-item" title="concept-item">item</a> for the
   purposes of refering to the data defined in that item from RDF.<p>A single property with the name <code title="md-about"><a href="#md-about">about</a></code> may be present within each <a href="#concept-item" title="concept-item">item</a>. Its <a href="#concept-property-value" title="concept-property-value">value</a> must be an
   <a href="#absolute-url">absolute URL</a>.<h3 id="converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</h3><h4 id="json"><span class="secno">5.5.1 </span>JSON</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
@@ -39242,6 +39307,23 @@
 
    <li><p>Add an entry to <var title="">result</var> called "<code title="">items</code>" whose value is the array <var title="">items</var>.</li>
 
+   <li><p>Let <var title="">current node</var> be <var title="">node</var>.</p>
+
+   <li><p>Let <var title="">citation</var> be null.</p>
+
+   <li><p><i>Citation search:</i> If <var title="">current node</var>
+   has a descendant element that is a <a href="#top-level-microdata-items" title="top-level microdata
+   items">top-level microdata item</a> with the type <code title="md-bibtex"><a href="#md-bibtex">bibtex</a></code>, then <a href="#get-the-object">get the object</a>
+   for that element and let <var title="">citation</var> be that
+   object.</li>
+
+   <li><p>If <var title="">citation</var> is null and <var title="">current node</var> has a parent node, let <var title="">current node</var> be its parent node and jump back to the
+   step labeled <i>citation search</i>.</li>
+
+   <li><p>If <var title="">citation</var> is not null, add an entry to
+   <var title="">result</var> called "<code title="">citation</code>"
+   whose value is the <var title="">citation</var> object.</li>
+
    <li><p>Return the result of serializing <var title="">result</var>
    to JSON.</li>
 
@@ -62842,6 +62924,7 @@
   Thomas O'Connor,
   Tim Altman,
   Tim Johansson,
+  Toby Inkster,
   Todd Moody,
   Tom Pike,
   Tommy Thorsen,
Received on Friday, 15 May 2009 00:35:19 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 15 May 2009 00:35:20 GMT