[html5] r1112 - /
whatwg at whatwg.org
whatwg at whatwg.org
Tue Oct 30 17:03:12 PDT 2007
Author: ianh
Date: 2007-10-30 17:03:11 -0700 (Tue, 30 Oct 2007)
New Revision: 1112
Modified:
index
source
Log:
[] (0) Breadcrumbs. More complicated than necessary.
Modified: index
===================================================================
--- index 2007-10-30 23:29:46 UTC (rev 1111)
+++ index 2007-10-31 00:03:11 UTC (rev 1112)
@@ -22,7 +22,7 @@
<h1 id=html-5>HTML 5</h1>
- <h2 class="no-num no-toc" id=working>Working Draft — 30 October 2007</h2>
+ <h2 class="no-num no-toc" id=working>Working Draft — 31 October 2007</h2>
<p>You can take part in this work. <a
href="http://www.whatwg.org/mailing-list">Join the working group's
@@ -32025,7 +32025,9 @@
<p>The <code title=rel-index><a href="#index">index</a></code> keyword
indicates that the document is part of a hierarchical structure, and that
- the link is leading to the document that is the top of the hierarchy.
+ the link is leading to the document that is the top of the hierarchy. It
+ conveys more information when used with the <code title=rel-up><a
+ href="#up">up</a></code> keyword (q.v.).
<p><strong>Synonyms</strong>: For historical reasons, user agents must also
treat the keywords "<code title="">top</code>", "<code
@@ -32093,19 +32095,54 @@
<p>The <code title=rel-up><a href="#up">up</a></code> keyword indicates
that the document is part of a hierarchical structure, and that the link
- is leading to the document that is the parent of the current document.</p>
- <!-- idea: rel="up" vs rel="up up" vs rel="up up up top"
- this would allow you to do breadcrumbs:
- <nav>
- <p>
- <a href="/" rel="top up up up">Main</a> >
- <a href="/products/" rel="up up">Products</a> >
- <a href="/products/dishwashers" rel="up">Dishwashers</a> >
- Second hand
- </p>
- </nav>
- -->
+ is leading to the document that is the parent of the current document.
+ <p>The <code title=rel-up><a href="#up">up</a></code> keyword may be
+ repeated within a <code title=attr-hyperlink-rel><a
+ href="#rel3">rel</a></code> attribute to indicate the hierarchical
+ distance from the current document to the referenced document. Each
+ occurance of the keyword represents one further level. If the <code
+ title=rel-index><a href="#index">index</a></code> keyword is also present,
+ then the number of <code title=rel-up><a href="#up">up</a></code> keywords
+ is the depth of the current page relative to the top of the hierarchy.
+
+ <p>If the page is part of multiple hierarchies, then they should be
+ described in different <a href="#paragraph"
+ title=paragraph>paragraphs</a>. User agents must scope any interpretation
+ of the <code title=rel-up><a href="#up">up</a></code> and <code
+ title=rel-index><a href="#index">index</a></code> keywords together
+ indicating the depth of the hierarchy to the <a
+ href="#paragraph">paragraph</a> in which the link finds itself, if any, or
+ to the document otherwise.
+
+ <p>When two links have both the <code title=rel-up><a
+ href="#up">up</a></code> and <code title=rel-index><a
+ href="#index">index</a></code> keywords specified together in the same
+ scope and contradict each other by having a different number of <code
+ title=rel-up><a href="#up">up</a></code> keywords, the link with the
+ greater number of <code title=rel-up><a href="#up">up</a></code> keywords
+ must be taken as giving the depth of the document.
+
+ <div class=example>
+ <p>This can be used to mark up a navigation style sometimes known as
+ breadcrumbs. In the following example, the current page can be reached
+ via two paths.</p>
+
+ <pre><nav>
+ <p>
+ <a href="/" rel="index up up up">Main</a> >
+ <a href="/products/" rel="up up">Products</a> >
+ <a href="/products/dishwashers/" rel="up">Dishwashers</a> >
+ <a>Second hand</a>
+ </p>
+ <p>
+ <a href="/" rel="index up up">Main</a> >
+ <a href="/second-hand/" rel="up">Second hand</a> >
+ <a>Dishwashers</a>
+ </p>
+</nav></pre>
+ </div>
+
<h5 id=other0><span class=secno>4.12.3.19. </span>Other link types</h5>
<p>Other than the types defined above, only types defined as extensions in
Modified: source
===================================================================
--- source 2007-10-30 23:29:46 UTC (rev 1111)
+++ source 2007-10-31 00:03:11 UTC (rev 1112)
@@ -29486,7 +29486,9 @@
<p>The <code title="rel-index">index</code> keyword indicates that
the document is part of a hierarchical structure, and that the link
- is leading to the document that is the top of the hierarchy.</p>
+ is leading to the document that is the top of the hierarchy. It
+ conveys more information when used with the <code
+ title="rel-up">up</code> keyword (q.v.).</p>
<p><strong>Synonyms</strong>: For historical reasons, user agents
must also treat the keywords "<code title="">top</code>", "<code
@@ -29553,19 +29555,52 @@
leading to the document that is the parent of the current
document.</p>
- <!-- idea: rel="up" vs rel="up up" vs rel="up up up top"
- this would allow you to do breadcrumbs:
- <nav>
- <p>
- <a href="/" rel="top up up up">Main</a> >
- <a href="/products/" rel="up up">Products</a> >
- <a href="/products/dishwashers" rel="up">Dishwashers</a> >
- Second hand
- </p>
- </nav>
- -->
+ <p>The <code title="rel-up">up</code> keyword may be repeated within
+ a <code title="attr-hyperlink-rel">rel</code> attribute to indicate
+ the hierarchical distance from the current document to the
+ referenced document. Each occurance of the keyword represents one
+ further level. If the <code title="rel-index">index</code> keyword
+ is also present, then the number of <code title="rel-up">up</code>
+ keywords is the depth of the current page relative to the top of the
+ hierarchy.</p>
+ <p>If the page is part of multiple hierarchies, then they should be
+ described in different <span
+ title="paragraph">paragraphs</span>. User agents must scope any
+ interpretation of the <code title="rel-up">up</code> and <code
+ title="rel-index">index</code> keywords together indicating the
+ depth of the hierarchy to the <span>paragraph</span> in which the
+ link finds itself, if any, or to the document otherwise.</p>
+ <p>When two links have both the <code title="rel-up">up</code> and
+ <code title="rel-index">index</code> keywords specified together in
+ the same scope and contradict each other by having a different
+ number of <code title="rel-up">up</code> keywords, the link with the
+ greater number of <code title="rel-up">up</code> keywords must be
+ taken as giving the depth of the document.</p>
+
+ <div class="example">
+
+ <p>This can be used to mark up a navigation style sometimes known
+ as breadcrumbs. In the following example, the current page can be
+ reached via two paths.</p>
+
+ <pre><nav>
+ <p>
+ <a href="/" rel="index up up up">Main</a> >
+ <a href="/products/" rel="up up">Products</a> >
+ <a href="/products/dishwashers/" rel="up">Dishwashers</a> >
+ <a>Second hand</a>
+ </p>
+ <p>
+ <a href="/" rel="index up up">Main</a> >
+ <a href="/second-hand/" rel="up">Second hand</a> >
+ <a>Dishwashers</a>
+ </p>
+</nav></pre>
+
+ </div>
+
<h5>Other link types</h5>
<p>Other than the types defined above, only types defined as
More information about the Commit-Watchers
mailing list