hixie: idioms: main content (whatwg r5237)

hixie: idioms: main content (whatwg r5237)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4170&r2=1.4171&f=h
http://html5.org/tools/web-apps-tracker?from=5236&to=5237

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4170
retrieving revision 1.4171
diff -u -d -r1.4170 -r1.4171
--- Overview.html 4 Aug 2010 20:56:15 -0000 1.4170
+++ Overview.html 4 Aug 2010 22:27:40 -0000 1.4171
@@ -885,9 +885,10 @@
        <li><a href="#other-link-types"><span class="secno">4.12.3.19 </span>Other link types</a></ol></ol></li>
    <li><a href="#common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</a>
     <ol>
-     <li><a href="#tag-clouds"><span class="secno">4.13.1 </span>Tag clouds</a></li>
-     <li><a href="#conversations"><span class="secno">4.13.2 </span>Conversations</a></li>
-     <li><a href="#footnotes"><span class="secno">4.13.3 </span>Footnotes</a></ol></li>
+     <li><a href="#the-main-part-of-the-content"><span class="secno">4.13.1 </span>The main part of the content</a></li>
+     <li><a href="#tag-clouds"><span class="secno">4.13.2 </span>Tag clouds</a></li>
+     <li><a href="#conversations"><span class="secno">4.13.3 </span>Conversations</a></li>
+     <li><a href="#footnotes"><span class="secno">4.13.4 </span>Footnotes</a></ol></li>
    <li><a href="#matching-html-elements-using-selectors"><span class="secno">4.14 </span>Matching HTML elements using selectors</a>
     <ol>
      <li><a href="#selectors"><span class="secno">4.14.1 </span>Case-sensitivity</a></li>
@@ -39852,7 +39853,151 @@
   RelExtensions page</a> with the status "proposed" or "ratified" may
   be used with the <code title="">rel</code> attribute on
   <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, and <code><a href="#the-area-element">area</a></code> elements in
-  accordance to the "Effect on..." field. <a href="#refsWHATWGWIKI">[WHATWGWIKI]</a><h3 id="common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/89">ISSUE-89</a> (idioms) blocks progress to Last Call</span><h4 id="tag-clouds"><span class="secno">4.13.1 </span>Tag clouds</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p id="tag-cloud">This specification does not define any markup
+  accordance to the "Effect on..." field. <a href="#refsWHATWGWIKI">[WHATWGWIKI]</a><h3 id="common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/89">ISSUE-89</a> (idioms) blocks progress to Last Call</span><h4 id="the-main-part-of-the-content"><span class="secno">4.13.1 </span>The main part of the content</h4><p>The main content of a page &mdash; not including headers and
+  footers, navigation links, sidebars, advertisements, and so forth
+  &mdash; can be marked up in a variety of ways, depending on the
+  needs of the author.<p>The simplest solution is to not mark up the main content at all,
+  and just leave it as implicit. Another way to think of this is that
+  the <code><a href="#the-body-element-0">body</a></code> elements marks up the main content of the
+  page, and the bits that aren't main content are excluded through the
+  use of more appropriate elements like <code><a href="#the-aside-element">aside</a></code> and
+  <code><a href="#the-nav-element">nav</a></code>.<div class="example">
+
+   <p>Here is a short Web page marked up along this minimalistic
+   school of thought. The main content is highlighted. Notice how all
+   the <em>other</em> content in the <code><a href="#the-body-element-0">body</a></code> is marked up
+   with elements to indicate that it's not part of the main content,
+   in this case <code><a href="#the-header-element">header</a></code>, <code><a href="#the-nav-element">nav</a></code>, and
+   <code><a href="#the-footer-element">footer</a></code>.</p>
+
+   <pre>&lt;!DOCTYPE HTML&gt;
+&lt;html&gt;
+ &lt;head&gt;
+  &lt;title&gt; My Toys &lt;/title&gt;
+ &lt;/head&gt;
+ &lt;body&gt;
+  &lt;header&gt;
+   &lt;h1&gt;My toys&lt;/h1&gt;
+  &lt;/header&gt;
+  &lt;nav&gt;
+   &lt;p&gt;&lt;a href="/"&gt;Home&lt;/a&gt;&lt;/p&gt;
+   &lt;p&gt;&lt;a href="/contact"&gt;Contact&lt;/a&gt;&lt;/p&gt;
+  &lt;/nav&gt;
+<strong>  &lt;p&gt;I really like my chained book and my telephone. I'm not such a
+  fan of my big ball.&lt;/p&gt;
+  &lt;p&gt;Another toy I like is my mirror.&lt;/p&gt;</strong>
+  &lt;footer&gt;
+   &lt;p&gt;&copy; copyright 2010 by the boy&lt;/p&gt;
+  &lt;/footer&gt;
+ &lt;/body&gt;
+&lt;/html&gt;</pre>
+
+  </div><p>If the main content is an independent unit of content that one
+  could imagine syndicating independently, then the
+  <code><a href="#the-article-element">article</a></code> element would be appropriate to mark up the
+  main content of the document.<div class="example">
+
+   <p>The document in the previous example is here recast as a blog
+   post:</p>
+
+   <pre>&lt;!DOCTYPE HTML&gt;
+&lt;html&gt;
+ &lt;head&gt;
+  &lt;title&gt; The Boy Blog: My Toys &lt;/title&gt;
+ &lt;/head&gt;
+ &lt;body&gt;
+  &lt;header&gt;
+   &lt;h1&gt;The Boy Blog&lt;/h1&gt;
+  &lt;/header&gt;
+  &lt;nav&gt;
+   &lt;p&gt;&lt;a href="/"&gt;Home&lt;/a&gt;&lt;/p&gt;
+   &lt;p&gt;&lt;a href="/contact"&gt;Contact&lt;/a&gt;&lt;/p&gt;
+  &lt;/nav&gt;
+<strong>  &lt;article&gt;
+   &lt;header&gt;
+    &lt;h1&gt;My toys&lt;/h1&gt;
+    &lt;p&gt;Published &lt;time pubdate datetime="2010-08-04"&gt;August 4th&lt;/time&gt;&lt;/p&gt;
+   &lt;/header&gt;
+   &lt;p&gt;I really like my chained book and my telephone. I'm not such a
+   fan of my big ball.&lt;/p&gt;
+   &lt;p&gt;Another toy I like is my mirror.&lt;/p&gt;
+  &lt;/article&gt;</strong>
+  &lt;footer&gt;
+   &lt;p&gt;&copy; copyright 2010 by the boy&lt;/p&gt;
+  &lt;/footer&gt;
+ &lt;/body&gt;
+&lt;/html&gt;</pre>
+
+  </div><p>If the main content is not an independent unit of content so much
+  as a section of a larger work, for instance a chapter, then the
+  <code><a href="#the-section-element">section</a></code> element would be appropriate to mark up the
+  main content of the document.<div class="example">
+
+   <p>Here is the same document, case as a chapter in an online
+   book:</p>
+
+   <pre>&lt;!DOCTYPE HTML&gt;
+&lt;html&gt;
+ &lt;head&gt;
+  &lt;title&gt; Chapter 2: My Toys &mdash; The Book of the Boy &lt;/title&gt;
+ &lt;/head&gt;
+ &lt;body&gt;
+  &lt;header&gt;
+   &lt;h1&gt;Chapter 2: My Toys&lt;/h1&gt;
+  &lt;/header&gt;
+  &lt;nav&gt;
+   &lt;p&gt;&lt;a href="/"&gt;Front Page&lt;/a&gt;&lt;/p&gt;
+   &lt;p&gt;&lt;a href="/toc"&gt;Table of Contents&lt;/a&gt;&lt;/p&gt;
+   &lt;p&gt;&lt;a href="/c1"&gt;Chapter 1&lt;/a&gt; &mdash; &lt;a href="/c3"&gt;Chapter 3&lt;/a&gt;&lt;/p&gt;
+  &lt;/nav&gt;
+<strong>  &lt;section&gt;
+   &lt;p&gt;I really like my chained book and my telephone. I'm not such a
+   fan of my big ball.&lt;/p&gt;
+   &lt;p&gt;Another toy I like is my mirror.&lt;/p&gt;
+  &lt;/section&gt;</strong>
+  &lt;footer&gt;
+   &lt;p&gt;&copy; copyright 2010 by the boy&lt;/p&gt;
+  &lt;/footer&gt;
+ &lt;/body&gt;
+&lt;/html&gt;</pre>
+
+  </div><p>If neither <code><a href="#the-article-element">article</a></code> nor <code><a href="#the-section-element">section</a></code> would be
+  appropriate, but the main content still needs an explicit element,
+  for example for styling purposes, then the <code><a href="#the-div-element">div</a></code> element
+  can be used.<div class="example">
+
+   <p>This is the same as the original example, but using
+   <code><a href="#the-div-element">div</a></code> for the main content instead of leaving it
+   implied:</p>
+
+   <pre>&lt;!DOCTYPE HTML&gt;
+&lt;html&gt;
+ &lt;head&gt;
+  &lt;title&gt; My Toys &lt;/title&gt;
+  &lt;style&gt;
+   body &gt; div { background: navy; color: yellow; }
+  &lt;/style&gt;
+ &lt;/head&gt;
+ &lt;body&gt;
+  &lt;header&gt;
+   &lt;h1&gt;My toys&lt;/h1&gt;
+  &lt;/header&gt;
+  &lt;nav&gt;
+   &lt;p&gt;&lt;a href="/"&gt;Home&lt;/a&gt;&lt;/p&gt;
+   &lt;p&gt;&lt;a href="/contact"&gt;Contact&lt;/a&gt;&lt;/p&gt;
+  &lt;/nav&gt;
+<strong>  &lt;div&gt;
+   &lt;p&gt;I really like my chained book and my telephone. I'm not such a
+   fan of my big ball.&lt;/p&gt;
+   &lt;p&gt;Another toy I like is my mirror.&lt;/p&gt;
+  &lt;/div&gt;</strong>
+  &lt;footer&gt;
+   &lt;p&gt;&copy; copyright 2010 by the boy&lt;/p&gt;
+  &lt;/footer&gt;
+ &lt;/body&gt;
+&lt;/html&gt;</pre>
+
+  </div><h4 id="tag-clouds"><span class="secno">4.13.2 </span>Tag clouds</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p id="tag-cloud">This specification does not define any markup
   specifically for marking up lists of keywords that apply to a group
   of pages (also known as <i>tag clouds</i>). In general, authors are
   encouraged to either mark up such lists using <code><a href="#the-ul-element">ul</a></code>
@@ -39897,7 +40042,7 @@
    that apply to the page itself; they are just part of an index
    listing the tags themselves.</p>
 
-  </div><h4 id="conversations"><span class="secno">4.13.2 </span>Conversations</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2009-September/022576.html --><p>This specification does not define a specific element for marking
+  </div><h4 id="conversations"><span class="secno">4.13.3 </span>Conversations</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2009-September/022576.html --><p>This specification does not define a specific element for marking
   up conversations, meeting minutes, chat transcripts, dialogues in
   screenplays, instant message logs, and other situations where
   different players take turns in discourse.<p>Instead, authors are encouraged to mark up conversations using
@@ -39930,7 +40075,7 @@
 &lt;p&gt; &lt;time&gt;14:24&lt;/time&gt; &lt;b&gt;kaj&lt;/b&gt; you are not helping your case</pre>
    <!-- with thanks to http://bash.org/?854262 -->
 
-  </div><h4 id="footnotes"><span class="secno">4.13.3 </span>Footnotes</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>HTML does not have a dedicated mechanism for marking up
+  </div><h4 id="footnotes"><span class="secno">4.13.4 </span>Footnotes</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>HTML does not have a dedicated mechanism for marking up
   footnotes. Here are the recommended alternatives.<hr><p>For short inline annotations, the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute should be used.<div class="example">
 
    <p>In this example, two parts of a dialogue are annotated with

Received on Wednesday, 4 August 2010 22:28:26 UTC