[html5] r1749 - /
whatwg at whatwg.org
whatwg at whatwg.org
Thu Jun 12 13:57:02 PDT 2008
Author: ianh
Date: 2008-06-12 13:57:01 -0700 (Thu, 12 Jun 2008)
New Revision: 1749
Modified:
index
source
Log:
[e] (0) examples and xrefs in the outline section
Modified: index
===================================================================
--- index 2008-06-12 20:22:31 UTC (rev 1748)
+++ index 2008-06-12 20:57:01 UTC (rev 1749)
@@ -9315,36 +9315,90 @@
<h5 id=outlines><span class=secno>3.7.10.1. </span>Creating an outline</h5>
- <p>This section defines an algorithm for creating an <dfn
- id=outline>outline</dfn> for a <a href="#sectioning0">sectioning
- content</a> element or a <a href="#sectioning1">sectioning root</a>
- element. It is defined in terms of a walk over the nodes of a DOM tree, in
- tree order, with each node being visited when it is <i>entered</i> and
- when it is <i>exited</i> during the walk.
+ <p>This section defines an algorithm for creating an outline for a <a
+ href="#sectioning0">sectioning content</a> element or a <a
+ href="#sectioning1">sectioning root</a> element. It is defined in terms of
+ a walk over the nodes of a DOM tree, in tree order, with each node being
+ visited when it is <i>entered</i> and when it is <i>exited</i> during the
+ walk.
- <p>The outline for a <a href="#sectioning0">sectioning content</a> element
- or a <a href="#sectioning1">sectioning root</a> element consists of a list
- of one or more potentially nested sections. Each section can have one
- heading associated with it. The algorithm for the outline also associates
- each node in the DOM tree with a particular section and potentially a
- heading. (The sections in the outline aren't <code><a
- href="#section">section</a></code> elements, though some may correspond to
- such elements — they are merely conceptual sections.)
+ <p>The <dfn id=outline>outline</dfn> for a <a
+ href="#sectioning0">sectioning content</a> element or a <a
+ href="#sectioning1">sectioning root</a> element consists of a list of one
+ or more potentially nested <a href="#section0"
+ title=concept-section>sections</a>. A <dfn id=section0
+ title=concept-section>section</dfn> is a container that corresponds to
+ some nodes in the original DOM tree. Each section can have one heading
+ associated with it, and can contain any number of further nested sections.
+ The algorithm for the outline also associates each node in the DOM tree
+ with a particular section and potentially a heading. (The sections in the
+ outline aren't <code><a href="#section">section</a></code> elements,
+ though some may correspond to such elements — they are merely
+ conceptual sections.)
+ <div class=example>
+ <p>The following markup fragment:</p>
+
+ <pre><body>
+ <h1>A</h1>
+ <p>B</p>
+ <h2>C</h2>
+ <p>D</p>
+ <h2>E</h2>
+ <p>F</p>
+</body></pre>
+
+ <p>...results in the following outline being created for the <code><a
+ href="#body0">body</a></code> node (and thus the entire document):</p>
+
+ <ol class=brief>
+ <li>
+ <p>Section created for <code><a href="#body0">body</a></code> node.</p>
+
+ <p>Associated with heading "A".</p>
+
+ <p>Also associated with paragraph "B".</p>
+
+ <p>Nested sections:</p>
+
+ <ol class=brief>
+ <li>
+ <p>Section implied for first <code><a href="#h2">h2</a></code>
+ element.</p>
+
+ <p>Associated with heading "C".</p>
+
+ <p>Also associated with paragraph "D".</p>
+
+ <p>No nested sections.</p>
+
+ <li>
+ <p>Section implied for second <code><a href="#h2">h2</a></code>
+ element.</p>
+
+ <p>Associated with heading "E".</p>
+
+ <p>Also associated with paragraph "F".</p>
+
+ <p>No nested sections.</p>
+ </ol>
+ </ol>
+ </div>
+
<p>The algorithm that must be followed during a walk of a DOM subtree
rooted at a <a href="#sectioning0">sectioning content</a> element or a <a
href="#sectioning1">sectioning root</a> element to determine that
- element's outline is as follows:
+ element's <a href="#outline">outline</a> is as follows:
<ol>
<li>
<p>Let <var title="">current outlinee</var> be null. (It holds the
- element whose outline is being created.)
+ element whose <a href="#outline">outline</a> is being created.)
<li>
<p>Let <var title="">current section</var> be null. (It holds a pointer
- to a section, so that elements in the DOM can all be associated with a
- section.)
+ to a <a href="#section0" title=concept-section>section</a>, so that
+ elements in the DOM can all be associated with a section.)
<li>
<p>Create a stack to hold elements, which is used to handle nesting.
@@ -9381,12 +9435,14 @@
<p>Let <var title="">current outlinee</var> be the element that is
being entered.</p>
- <p>Let <var title="">current section</var> be a newly created section
- for the <var title="">current outlinee</var> element.</p>
+ <p>Let <var title="">current section</var> be a newly created <a
+ href="#section0" title=concept-section>section</a> for the <var
+ title="">current outlinee</var> element.</p>
- <p>Let there be a new outline for the new <var title="">current
- outlinee</var>, initialized with just the new <var title="">current
- section</var> as the only section in the outline.</p>
+ <p>Let there be a new <a href="#outline">outline</a> for the new <var
+ title="">current outlinee</var>, initialized with just the new <var
+ title="">current section</var> as the only <a href="#section0"
+ title=concept-section>section</a> in the outline.</p>
<dt>When exiting a <a href="#sectioning0">sectioning content</a>
element, if the stack is not empty
@@ -9396,12 +9452,13 @@
title="">current outlinee</var> be that element.</p>
<p>Let <var title="">current section</var> be the last section in the
- outline of the <var title="">current outlinee</var> element.</p>
+ <a href="#outline">outline</a> of the <var title="">current
+ outlinee</var> element.</p>
- <p>Append the outline of the <a href="#sectioning0">sectioning
- content</a> element being exited to the <var title="">current
- section</var>. (This does not change which section is the last section
- in the outline.)</p>
+ <p>Append the <a href="#outline">outline</a> of the <a
+ href="#sectioning0">sectioning content</a> element being exited to the
+ <var title="">current section</var>. (This does not change which
+ section is the last section in the <a href="#outline">outline</a>.)</p>
<dt>When exiting a <a href="#sectioning1">sectioning root</a> element,
if the stack is not empty
@@ -9416,15 +9473,17 @@
<li>
<p>Let <var title="">current section</var> be the last section in the
- outline of the <var title="">current outlinee</var> element.
+ <a href="#outline">outline</a> of the <var title="">current
+ outlinee</var> element.
<li>
<p><i>Loop:</i> If <var title="">current section</var> has no child
sections, stop these steps.
<li>
- <p>Let <var title="">current section</var> be the last child section
- of the current <var title="">current section</var>.
+ <p>Let <var title="">current section</var> be the last child <a
+ href="#section0" title=concept-section>section</a> of the current
+ <var title="">current section</var>.
<li>
<p>Go back to the substep labeled <i>Loop</i>.
@@ -9437,8 +9496,10 @@
<p class=note>The <var title="">current outlinee</var> is the element
being exited.</p>
- <p>Let <var title="">current section</var> be the first section in the
- outline of the <var title="">current outlinee</var> element.</p>
+ <p>Let <var title="">current section</var> be the first <a
+ href="#section0" title=concept-section>section</a> in the <a
+ href="#outline">outline</a> of the <var title="">current
+ outlinee</var> element.</p>
<p>Skip to the next step in the overall set of steps. (The walk is
over.)</p>
@@ -9455,13 +9516,15 @@
element being entered be the heading for the <var title="">current
section</var>.</p>
- <p>Otherwise, if the element being entered has a rank equal to or
- greater than the heading of the <var title="">current section</var>,
- then create a new section and append it to the outline of the <var
- title="">current outlinee</var> element, so that this new section is
- the new last section of that outline. Let <var title="">current
- section</var> be that new section. Let the element being entered be
- the new heading for the <var title="">current section</var>.</p>
+ <p>Otherwise, if the element being entered has a <a
+ href="#rank">rank</a> equal to or greater than the heading of the <var
+ title="">current section</var>, then create a new <a href="#section0"
+ title=concept-section>section</a> and append it to the <a
+ href="#outline">outline</a> of the <var title="">current
+ outlinee</var> element, so that this new section is the new last
+ section of that outline. Let <var title="">current section</var> be
+ that new section. Let the element being entered be the new heading for
+ the <var title="">current section</var>.</p>
<p>Otherwise, run these substeps:</p>
@@ -9471,18 +9534,21 @@
section</var>.
<li>
- <p>If the element being entered has a rank lower than the rank of the
- heading of the <var title="">candidate section</var>, then create a
- new section, and append it to <var title="">candidate section</var>.
- (This does not change which section is the last section in the
- outline.) Let <var title="">current section</var> be this new
- section. Let the element being entered be the new heading for the
- <var title="">current section</var>. Abort these substeps.</p>
+ <p>If the element being entered has a <a href="#rank">rank</a> lower
+ than the rank of the heading of the <var title="">candidate
+ section</var>, then create a new <a href="#section0"
+ title=concept-section>section</a>, and append it to <var
+ title="">candidate section</var>. (This does not change which
+ section is the last section in the outline.) Let <var
+ title="">current section</var> be this new section. Let the element
+ being entered be the new heading for the <var title="">current
+ section</var>. Abort these substeps.</p>
<li>
- <p>Let <var title="">new candidate section</var> be the section that
- contains <var title="">candidate section</var> in the outline of
- <var title="">current outlinee</var>.
+ <p>Let <var title="">new candidate section</var> be the <a
+ href="#section0" title=concept-section>section</a> that contains
+ <var title="">candidate section</var> in the <a
+ href="#outline">outline</a> of <var title="">current outlinee</var>.
<li>
<p>Let <var title="">candidate section</var> be <var title="">new
@@ -9503,27 +9569,29 @@
<p id=associatedSection>In addition, whenever you exit a node, after
doing the steps above, if <var title="">current section</var> is not
- null, associate the node with the section <var title="">current
- section</var>.</p>
+ null, associate the node with the <a href="#section0"
+ title=concept-section>section</a> <var title="">current section</var>.</p>
<li>
<p>If the <var title="">current outlinee</var> is null, then there was no
<a href="#sectioning0">sectioning content</a> element or <a
href="#sectioning1">sectioning root</a> element in the DOM. There is no
- outline. Abort these steps.
+ <a href="#outline">outline</a>. Abort these steps.
<li>
- <p>Associate any nodes that were not associated a section in the steps
- above with <var title="">current outlinee</var> as their section.
+ <p>Associate any nodes that were not associated a <a href="#section0"
+ title=concept-section>section</a> in the steps above with <var
+ title="">current outlinee</var> as their section.
<li>
- <p>Associate all nodes with the heading of the section with which they
- are associated, if any.
+ <p>Associate all nodes with the heading of the <a href="#section0"
+ title=concept-section>section</a> with which they are associated, if
+ any.
<li>
<p>If <var title="">current outlinee</var> is <a href="#the-body1">the
<code>body</code> element</a>, then the outline created for that element
- is the outline of the entire document.
+ is the <a href="#outline">outline</a> of the entire document.
</ol>
<p>The tree of sections created by the algorithm above, or a proper subset
@@ -9532,14 +9600,16 @@
<p>When creating an interactive table of contents, entries should jump the
user to the relevant <a href="#sectioning0">sectioning content</a>
- element, if the section was created for a real element in the original
- document, or to the relevant <a href="#heading0">heading content</a>
- element, if the section in the tree was generated for a heading in the
- above process.
+ element, if the <a href="#section0" title=concept-section>section</a> was
+ created for a real element in the original document, or to the relevant <a
+ href="#heading0">heading content</a> element, if the <a href="#section0"
+ title=concept-section>section</a> in the tree was generated for a heading
+ in the above process.
- <p class=note>Selecting the first section of the document therefore always
- takes the user to the top of the document, regardless of where the first
- header in the <code><a href="#body0">body</a></code> is to be found.</p>
+ <p class=note>Selecting the first <a href="#section0"
+ title=concept-section>section</a> of the document therefore always takes
+ the user to the top of the document, regardless of where the first header
+ in the <code><a href="#body0">body</a></code> is to be found.</p>
<!-- XXX assuming there is a body, anyway -->
<div class=note>
@@ -9580,24 +9650,25 @@
sections created for <code><a href="#nav">nav</a></code> and <code><a
href="#aside">aside</a></code> elements, and any of their descendants, if
the only root of the tree is <a href="#the-body1">the <code>body</code>
- element</a>'s section, and it has only a single subsection which is
- created by an <code><a href="#article">article</a></code> element, then
- the heading of <a href="#the-body1">the <code>body</code> element</a>
- should be assumed to be a site-wide heading, and the heading of the
- <code><a href="#article">article</a></code> element should be assumed to
- be the page's heading.
+ element</a>'s <a href="#section0" title=concept-section>section</a>, and
+ it has only a single subsection which is created by an <code><a
+ href="#article">article</a></code> element, then the heading of <a
+ href="#the-body1">the <code>body</code> element</a> should be assumed to
+ be a site-wide heading, and the heading of the <code><a
+ href="#article">article</a></code> element should be assumed to be the
+ page's heading.
<p>If a page starts with a heading that is common to the whole site, the
document must be authored such that, in the document's <a
href="#outline">outline</a>, ignoring any sections created for <code><a
href="#nav">nav</a></code> and <code><a href="#aside">aside</a></code>
- elements and any of their descendants, the tree has only one root section,
- <a href="#the-body1">the <code>body</code> element</a>'s section, its
- heading is the site-wide heading, <a href="#the-body1">the
- <code>body</code> element</a> has just one subsection, that subsection is
- created by an <code><a href="#article">article</a></code> element, and
- that <code><a href="#article">article</a></code>'s heading is the page
- heading.
+ elements and any of their descendants, the tree has only one root <a
+ href="#section0" title=concept-section>section</a>, <a
+ href="#the-body1">the <code>body</code> element</a>'s section, its heading
+ is the site-wide heading, <a href="#the-body1">the <code>body</code>
+ element</a> has just one subsection, that subsection is created by an
+ <code><a href="#article">article</a></code> element, and that <code><a
+ href="#article">article</a></code>'s heading is the page heading.
<p>If a page does not contain a site-wide heading, then the page must be
authored such that, in the document's <a href="#outline">outline</a>,
@@ -9606,8 +9677,9 @@
descendants, either <a href="#the-body1">the <code>body</code> element</a>
has no subsections, or it has more than one subsection, or it has a single
subsection but that subsection is not created by an <code><a
- href="#article">article</a></code> element, or there is more than one
- section at the root of the outline.
+ href="#article">article</a></code> element, or there is more than one <a
+ href="#section0" title=concept-section>section</a> at the root of the
+ outline.
<p class=note>Conceptually, a site is thus a document with many articles
— when those articles are split into many pages, the heading of the
Modified: source
===================================================================
--- source 2008-06-12 20:22:31 UTC (rev 1748)
+++ source 2008-06-12 20:57:01 UTC (rev 1749)
@@ -7534,35 +7534,79 @@
<h5 id="outlines">Creating an outline</h5>
- <p>This section defines an algorithm for creating an
- <dfn>outline</dfn> for a <span>sectioning content</span> element or
- a <span>sectioning root</span> element. It is defined in terms of a
- walk over the nodes of a DOM tree, in tree order, with each node
- being visited when it is <i>entered</i> and when it is <i>exited</i>
- during the walk.</p>
+ <p>This section defines an algorithm for creating an outline for a
+ <span>sectioning content</span> element or a <span>sectioning
+ root</span> element. It is defined in terms of a walk over the nodes
+ of a DOM tree, in tree order, with each node being visited when it
+ is <i>entered</i> and when it is <i>exited</i> during the walk.</p>
- <p>The outline for a <span>sectioning content</span> element or a
- <span>sectioning root</span> element consists of a list of one or
- more potentially nested sections. Each section can have one heading
- associated with it. The algorithm for the outline also associates
- each node in the DOM tree with a particular section and potentially
- a heading. (The sections in the outline aren't <code>section</code>
- elements, though some may correspond to such elements — they
- are merely conceptual sections.)</p>
+ <p>The <dfn>outline</dfn> for a <span>sectioning content</span>
+ element or a <span>sectioning root</span> element consists of a list
+ of one or more potentially nested <span
+ title="concept-section">sections</span>. A <dfn
+ title="concept-section">section</dfn> is a container that
+ corresponds to some nodes in the original DOM tree. Each section can
+ have one heading associated with it, and can contain any number of
+ further nested sections. The algorithm for the outline also
+ associates each node in the DOM tree with a particular section and
+ potentially a heading. (The sections in the outline aren't
+ <code>section</code> elements, though some may correspond to such
+ elements — they are merely conceptual sections.)</p>
+ <div class="example">
+
+ <p>The following markup fragment:</p>
+
+ <pre><body>
+ <h1>A</h1>
+ <p>B</p>
+ <h2>C</h2>
+ <p>D</p>
+ <h2>E</h2>
+ <p>F</p>
+</body></pre>
+
+ <p>...results in the following outline being created for the
+ <code>body</code> node (and thus the entire document):</p>
+
+ <ol class="brief">
+ <li>
+ <p>Section created for <code>body</code> node.</p>
+ <p>Associated with heading "A".</p>
+ <p>Also associated with paragraph "B".</p>
+ <p>Nested sections:</p>
+ <ol class="brief">
+ <li>
+ <p>Section implied for first <code>h2</code> element.</p>
+ <p>Associated with heading "C".</p>
+ <p>Also associated with paragraph "D".</p>
+ <p>No nested sections.</p>
+ </li>
+ <li>
+ <p>Section implied for second <code>h2</code> element.</p>
+ <p>Associated with heading "E".</p>
+ <p>Also associated with paragraph "F".</p>
+ <p>No nested sections.</p>
+ </li>
+ </ol>
+ </li>
+ </ol>
+
+ </div>
+
<p>The algorithm that must be followed during a walk of a DOM
subtree rooted at a <span>sectioning content</span> element or a
<span>sectioning root</span> element to determine that element's
- outline is as follows:</p>
+ <span>outline</span> is as follows:</p>
<ol>
<li><p>Let <var title="">current outlinee</var> be null. (It holds
- the element whose outline is being created.)</p></li>
+ the element whose <span>outline</span> is being created.)</p></li>
<li><p>Let <var title="">current section</var> be null. (It holds a
- pointer to a section, so that elements in the DOM can all be
- associated with a section.)</p></li>
+ pointer to a <span title="concept-section">section</span>, so that
+ elements in the DOM can all be associated with a section.)</p></li>
<li><p>Create a stack to hold elements, which is used to handle
nesting. Initialize this stack to empty.</p></li>
@@ -7606,13 +7650,13 @@
that is being entered.</p>
<p>Let <var title="">current section</var> be a newly created
- section for the <var title="">current outlinee</var>
- element.</p>
+ <span title="concept-section">section</span> for the <var
+ title="">current outlinee</var> element.</p>
- <p>Let there be a new outline for the new <var title="">current
- outlinee</var>, initialized with just the new <var
- title="">current section</var> as the only section in the
- outline.</p>
+ <p>Let there be a new <span>outline</span> for the new <var
+ title="">current outlinee</var>, initialized with just the new
+ <var title="">current section</var> as the only <span
+ title="concept-section">section</span> in the outline.</p>
</dd>
@@ -7626,13 +7670,13 @@
title="">current outlinee</var> be that element.</p>
<p>Let <var title="">current section</var> be the last section
- in the outline of the <var title="">current outlinee</var>
- element.</p>
+ in the <span>outline</span> of the <var title="">current
+ outlinee</var> element.</p>
- <p>Append the outline of the <span>sectioning content</span>
- element being exited to the <var title="">current
+ <p>Append the <span>outline</span> of the <span>sectioning
+ content</span> element being exited to the <var title="">current
section</var>. (This does not change which section is the last
- section in the outline.)</p>
+ section in the <span>outline</span>.)</p>
</dd>
@@ -7650,15 +7694,15 @@
title="">current outlinee</var> be that element.</p></li>
<li><p>Let <var title="">current section</var> be the last
- section in the outline of the <var title="">current
+ section in the <span>outline</span> of the <var title="">current
outlinee</var> element.</p></li>
<li><p><i>Loop:</i> If <var title="">current section</var> has
no child sections, stop these steps.</p></li>
<li><p>Let <var title="">current section</var> be the last
- child section of the current <var title="">current
- section</var>.</p></li>
+ child <span title="concept-section">section</span> of the
+ current <var title="">current section</var>.</p></li>
<li><p>Go back to the substep labeled <i>Loop</i>.</p></li>
@@ -7675,8 +7719,9 @@
<p class="note">The <var title="">current outlinee</var> is
the element being exited.</p>
- <p>Let <var title="">current section</var> be the first section
- in the outline of the <var title="">current outlinee</var>
+ <p>Let <var title="">current section</var> be the first <span
+ title="concept-section">section</span> in the
+ <span>outline</span> of the <var title="">current outlinee</var>
element.</p>
<p>Skip to the next step in the overall set of steps. (The walk
@@ -7698,14 +7743,15 @@
let the element being entered be the heading for the <var
title="">current section</var>.</p>
- <p>Otherwise, if the element being entered has a rank equal to
- or greater than the heading of the <var title="">current
- section</var>, then create a new section and append it to the
- outline of the <var title="">current outlinee</var> element, so
- that this new section is the new last section of that
- outline. Let <var title="">current section</var> be that new
- section. Let the element being entered be the new heading for
- the <var title="">current section</var>.</p>
+ <p>Otherwise, if the element being entered has a
+ <span>rank</span> equal to or greater than the heading of the
+ <var title="">current section</var>, then create a new <span
+ title="concept-section">section</span> and append it to the
+ <span>outline</span> of the <var title="">current outlinee</var>
+ element, so that this new section is the new last section of
+ that outline. Let <var title="">current section</var> be that
+ new section. Let the element being entered be the new heading
+ for the <var title="">current section</var>.</p>
<p>Otherwise, run these substeps:</p>
@@ -7714,9 +7760,10 @@
<li><p>Let <var title="">candidate section</var> be <var
title="">current section</var>.</p></li>
- <li><p>If the element being entered has a rank lower than the
- rank of the heading of the <var title="">candidate
- section</var>, then create a new section, and append it to <var
+ <li><p>If the element being entered has a <span>rank</span>
+ lower than the rank of the heading of the <var
+ title="">candidate section</var>, then create a new <span
+ title="concept-section">section</span>, and append it to <var
title="">candidate section</var>. (This does not change which
section is the last section in the outline.) Let <var
title="">current section</var> be this new section. Let the
@@ -7724,8 +7771,9 @@
title="">current section</var>. Abort these substeps.</p>
<li><p>Let <var title="">new candidate section</var> be the
- section that contains <var title="">candidate section</var> in
- the outline of <var title="">current outlinee</var>.</p></li>
+ <span title="concept-section">section</span> that contains <var
+ title="">candidate section</var> in the <span>outline</span> of
+ <var title="">current outlinee</var>.</p></li>
<li><p>Let <var title="">candidate section</var> be <var
title="">new candidate section</var>.</p></li>
@@ -7748,26 +7796,28 @@
<p id="associatedSection">In addition, whenever you exit a node,
after doing the steps above, if <var title="">current
- section</var> is not null, associate the node with the section
- <var title="">current section</var>.</p>
+ section</var> is not null, associate the node with the <span
+ title="concept-section">section</span> <var title="">current
+ section</var>.</p>
</li>
<li><p>If the <var title="">current outlinee</var> is null,
then there was no <span>sectioning content</span> element or
<span>sectioning root</span> element in the DOM. There is no
- outline. Abort these steps.</p></li>
+ <span>outline</span>. Abort these steps.</p></li>
- <li><p>Associate any nodes that were not associated a section in
- the steps above with <var title="">current outlinee</var> as their
- section.</p></li>
+ <li><p>Associate any nodes that were not associated a <span
+ title="concept-section">section</span> in the steps above with <var
+ title="">current outlinee</var> as their section.</p></li>
- <li><p>Associate all nodes with the heading of the section with
- which they are associated, if any.</p></li>
+ <li><p>Associate all nodes with the heading of the <span
+ title="concept-section">section</span> with which they are
+ associated, if any.</p></li>
<li><p>If <var title="">current outlinee</var> is <span>the
<code>body</code> element</span>, then the outline created for that
- element is the outline of the entire document.</p></li>
+ element is the <span>outline</span> of the entire document.</p></li>
</ol>
@@ -7777,15 +7827,17 @@
<p>When creating an interactive table of contents, entries should
jump the user to the relevant <span>sectioning content</span>
- element, if the section was created for a real element in the
- original document, or to the relevant <span>heading content</span>
- element, if the section in the tree was generated for a heading in
- the above process.</p>
+ element, if the <span title="concept-section">section</span> was
+ created for a real element in the original document, or to the
+ relevant <span>heading content</span> element, if the <span
+ title="concept-section">section</span> in the tree was generated for
+ a heading in the above process.</p>
- <p class="note">Selecting the first section of the document
- therefore always takes the user to the top of the document,
- regardless of where the first header in the <code>body</code> is to
- be found.</p> <!-- XXX assuming there is a body, anyway -->
+ <p class="note">Selecting the first <span
+ title="concept-section">section</span> of the document therefore
+ always takes the user to the top of the document, regardless of
+ where the first header in the <code>body</code> is to be found.</p>
+ <!-- XXX assuming there is a body, anyway -->
<div class="note">
@@ -7826,23 +7878,24 @@
<p>Given the <span>outline</span> of a document, but ignoring any
sections created for <code>nav</code> and <code>aside</code>
elements, and any of their descendants, if the only root of the tree
- is <span>the <code>body</code> element</span>'s section, and it has
- only a single subsection which is created by an <code>article</code>
- element, then the heading of <span>the <code>body</code>
- element</span> should be assumed to be a site-wide heading, and the
- heading of the <code>article</code> element should be assumed to be
- the page's heading.</p>
+ is <span>the <code>body</code> element</span>'s <span
+ title="concept-section">section</span>, and it has only a single
+ subsection which is created by an <code>article</code> element, then
+ the heading of <span>the <code>body</code> element</span> should be
+ assumed to be a site-wide heading, and the heading of the
+ <code>article</code> element should be assumed to be the page's
+ heading.</p>
<p>If a page starts with a heading that is common to the whole site,
the document must be authored such that, in the document's
<span>outline</span>, ignoring any sections created for
<code>nav</code> and <code>aside</code> elements and any of their
- descendants, the tree has only one root section, <span>the
- <code>body</code> element</span>'s section, its heading is the
- site-wide heading, <span>the <code>body</code> element</span> has
- just one subsection, that subsection is created by an
- <code>article</code> element, and that <code>article</code>'s
- heading is the page heading.</p>
+ descendants, the tree has only one root <span
+ title="concept-section">section</span>, <span>the <code>body</code>
+ element</span>'s section, its heading is the site-wide heading,
+ <span>the <code>body</code> element</span> has just one subsection,
+ that subsection is created by an <code>article</code> element, and
+ that <code>article</code>'s heading is the page heading.</p>
<p>If a page does not contain a site-wide heading, then the page
must be authored such that, in the document's <span>outline</span>,
@@ -7851,7 +7904,8 @@
<span>the <code>body</code> element</span> has no subsections, or it
has more than one subsection, or it has a single subsection but that
subsection is not created by an <code>article</code> element, or
- there is more than one section at the root of the outline.</p>
+ there is more than one <span title="concept-section">section</span>
+ at the root of the outline.</p>
<p class="note">Conceptually, a site is thus a document with many
articles — when those articles are split into many pages, the
More information about the Commit-Watchers
mailing list