Permalink
Browse files

[act] (0) Drop support for rel=up, rel=last, rel=index, rel=first, an…

…d any related synonyms.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7475

git-svn-id: http://svn.whatwg.org/webapps@5924 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Mar 2, 2011
1 parent 8a3a269 commit 16485bf232227f99628894f182e48bbb0634eb1d
Showing with 122 additions and 539 deletions.
  1. +46 −181 complete.html
  2. +46 −181 index
  3. +30 −177 source

<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1>Web Applications 1.0</h1>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 1 March 2011</h2>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 2 March 2011</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
<li><a href=#link-type-stylesheet><span class=secno>4.12.4.14 </span>Link type "<code>stylesheet</code>"</a></li>
<li><a href=#link-type-sidebar><span class=secno>4.12.4.15 </span>Link type "<code>sidebar</code>"</a></li>
<li><a href=#link-type-tag><span class=secno>4.12.4.16 </span>Link type "<code>tag</code>"</a></li>
<li><a href=#hierarchical-link-types><span class=secno>4.12.4.17 </span>Hierarchical link types</a>
<li><a href=#sequential-link-types><span class=secno>4.12.4.17 </span>Sequential link types</a>
<ol>
<li><a href=#link-type-index><span class=secno>4.12.4.17.1 </span>Link type "<code>index</code>"</a></li>
<li><a href=#link-type-up><span class=secno>4.12.4.17.2 </span>Link type "<code>up</code>"</a></ol></li>
<li><a href=#sequential-link-types><span class=secno>4.12.4.18 </span>Sequential link types</a>
<ol>
<li><a href=#link-type-first><span class=secno>4.12.4.18.1 </span>Link type "<code>first</code>"</a></li>
<li><a href=#link-type-last><span class=secno>4.12.4.18.2 </span>Link type "<code>last</code>"</a></li>
<li><a href=#link-type-next><span class=secno>4.12.4.18.3 </span>Link type "<code>next</code>"</a></li>
<li><a href=#link-type-prev><span class=secno>4.12.4.18.4 </span>Link type "<code>prev</code>"</a></ol></li>
<li><a href=#other-link-types><span class=secno>4.12.4.19 </span>Other link types</a></ol></ol></li>
<li><a href=#link-type-next><span class=secno>4.12.4.17.1 </span>Link type "<code>next</code>"</a></li>
<li><a href=#link-type-prev><span class=secno>4.12.4.17.2 </span>Link type "<code>prev</code>"</a></ol></li>
<li><a href=#other-link-types><span class=secno>4.12.4.18 </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=#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=#rel-up><span class=secno>4.13.2 </span>Bread crumb navigation</a></li>
<li><a href=#tag-clouds><span class=secno>4.13.3 </span>Tag clouds</a></li>
<li><a href=#conversations><span class=secno>4.13.4 </span>Conversations</a></li>
<li><a href=#footnotes><span class=secno>4.13.5 </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>
<td><em>not allowed</em></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td>Indicates that the referenced document is not part of the same site as the current document.</td>
<tr><td><code title=rel-first><a href=#link-type-first>first</a></code></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td>Indicates that the current document is a part of a series, and that the first document in the series is the referenced document.</td>
<tr><td><code title=rel-help><a href=#link-type-help>help</a></code></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#external-resource-link title="external resource link">External Resource</a></td>
<td><em>not allowed</em></td>
<td>Imports an icon to represent the current document.</td>
<tr><td><code title=rel-index><a href=#link-type-index>index</a></code></td> <!-- used more than "top" and "contents" on <link> (though on <a>, "contents" wins) -->
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td>Gives a link to the document that provides a table of contents or index listing the current document.</td>
<tr><td><code title=rel-last><a href=#link-type-last>last</a></code></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td>Indicates that the current document is a part of a series, and that the last document in the series is the referenced document.</td>
<tr><td><code title=rel-license><a href=#link-type-license>license</a></code></td> <!-- seventh most used <a rel> value -->
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td>Gives a tag (identified by the given address) that applies to the current document.</td>
<tr><td><code title=rel-up><a href=#link-type-up>up</a></code></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td><a href=#hyperlink>Hyperlink</a></td>
<td>Provides a link to a document giving the context for the current document.</td>
</table><div class=impl>

<p>Some of the types described below list synonyms for these
the popular tag across a set of pages.</p>


<h5 id=hierarchical-link-types><span class=secno>4.12.4.17 </span>Hierarchical link types</h5>

<p>Some documents form part of a hierarchical structure of
documents.</p>

<p>A hierarchical structure of documents is one where each document
can have various subdocuments. The document of which a document is a
subdocument is said to be the document's <em>parent</em>. A document
with no parent forms the top of the hierarchy.</p>

<p>A document may be part of multiple hierarchies.</p>


<h6 id=link-type-index><span class=secno>4.12.4.17.1 </span>Link type "<dfn title=rel-index><code>index</code></dfn>"</h6>

<p>The <code title=rel-index><a href=#link-type-index>index</a></code> keyword may be used with
<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. This keyword creates a <a href=#hyperlink>hyperlink</a>.</p>

<p>The <code title=rel-index><a href=#link-type-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. It
conveys more information when used with the <code title=rel-up><a href=#link-type-up>up</a></code> keyword (q.v.).</p>

<div class=impl>

<p><strong>Synonyms</strong>: For historical reasons, user agents
must also treat the keywords "<code title="">top</code>", "<code title="">contents</code>", and "<code title="">toc</code>" like the
<code title=rel-index><a href=#link-type-index>index</a></code> keyword.</p>

</div>


<h6 id=link-type-up><span class=secno>4.12.4.17.2 </span>Link type "<dfn title=rel-up><code>up</code></dfn>"</h6>

<p>The <code title=rel-up><a href=#link-type-up>up</a></code> keyword may be used with
<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. This keyword creates a <a href=#hyperlink>hyperlink</a>.</p>

<p>The <code title=rel-up><a href=#link-type-up>up</a></code> keyword indicates that the
document is part of a hierarchical structure, and that the link is
leading to a document that is an ancestor of the current
document.</p>

<p>The <code title=rel-up><a href=#link-type-up>up</a></code> keyword may be repeated within
a <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code> attribute to indicate
the hierarchical distance from the current document to the
referenced document. If it occurs only once, then the link is
leading to the current document's parent; each additional occurrence
of the keyword represents one further level. If the <code title=rel-index><a href=#link-type-index>index</a></code> keyword is also present, then the
number of <code title=rel-up><a href=#link-type-up>up</a></code> keywords is the depth of
the current page relative to the top of the hierarchy. Only one link
is created for the set of one or more <code title=rel-up><a href=#link-type-up>up</a></code>
keywords and, if present, the <code title=rel-index><a href=#link-type-index>index</a></code>
keyword.</p>

<p>If the page is part of multiple hierarchies, then they should be
described in different <a href=#paragraph title=paragraph>paragraphs</a>. <span class=impl>User agents
must scope any interpretation of the <code title=rel-up><a href=#link-type-up>up</a></code>
and <code title=rel-index><a href=#link-type-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.</span></p>

<div class=impl>

<p>When two links have both the <code title=rel-up><a href=#link-type-up>up</a></code> and
<code title=rel-index><a href=#link-type-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=#link-type-up>up</a></code> keywords, the link with the
greater number of <code title=rel-up><a href=#link-type-up>up</a></code> keywords must be
taken as giving the depth of the document.</p>

</div>

<div class=example>

<p>This can be used to mark up a navigation style sometimes known
as bread crumbs. In the following example, the current page can be
reached via two paths.</p>

<pre>&lt;nav&gt;
&lt;p&gt;
&lt;a href="/" rel="index up up up"&gt;Main&lt;/a&gt; &gt;
&lt;a href="/products/" rel="up up"&gt;Products&lt;/a&gt; &gt;
&lt;a href="/products/dishwashers/" rel="up"&gt;Dishwashers&lt;/a&gt; &gt;
&lt;a&gt;Second hand&lt;/a&gt;
&lt;/p&gt;
&lt;p&gt;
&lt;a href="/" rel="index up up"&gt;Main&lt;/a&gt; &gt;
&lt;a href="/second-hand/" rel="up"&gt;Second hand&lt;/a&gt; &gt;
&lt;a&gt;Dishwashers&lt;/a&gt;
&lt;/p&gt;
&lt;/nav&gt;</pre>

</div>

<p class=note>The <code title=dom-a-relList><a href=#dom-a-rellist>relList</a></code> IDL
attribute (e.g. on the <code><a href=#the-a-element>a</a></code> element) does not currently
represent multiple <code title=rel-up><a href=#link-type-up>up</a></code> keywords (the
interface hides duplicates).</p>


<h5 id=sequential-link-types><span class=secno>4.12.4.18 </span>Sequential link types</h5>
<h5 id=sequential-link-types><span class=secno>4.12.4.17 </span>Sequential link types</h5>

<p>Some documents form part of a sequence of documents.</p>

<p>A document may be part of multiple sequences.</p>


<h6 id=link-type-first><span class=secno>4.12.4.18.1 </span>Link type "<dfn title=rel-first><code>first</code></dfn>"</h6>

<p>The <code title=rel-first><a href=#link-type-first>first</a></code> keyword may be used with
<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. This keyword creates a <a href=#hyperlink>hyperlink</a>.</p>

<p>The <code title=rel-first><a href=#link-type-first>first</a></code> keyword indicates that
the document is part of a sequence, and that the link is leading to
the document that is the first logical document in the sequence.</p>

<div class=impl>

<p><strong>Synonyms</strong>: For historical reasons, user agents
must also treat the keywords "<code title="">begin</code>" and
"<code title="">start</code>" like the <code title=rel-first><a href=#link-type-first>first</a></code> keyword.</p>

</div>


<h6 id=link-type-last><span class=secno>4.12.4.18.2 </span>Link type "<dfn title=rel-last><code>last</code></dfn>"</h6>

<p>The <code title=rel-last><a href=#link-type-last>last</a></code> keyword may be used with
<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. This keyword creates a <a href=#hyperlink>hyperlink</a>.</p>

<p>The <code title=rel-last><a href=#link-type-last>last</a></code> keyword indicates that the
document is part of a sequence, and that the link is leading to the
document that is the last logical document in the sequence.</p>

<div class=impl>

<p><strong>Synonyms</strong>: For historical reasons, user agents
must also treat the keyword "<code title="">end</code>" like the
<code title=rel-last><a href=#link-type-last>last</a></code> keyword.</p>

</div>


<h6 id=link-type-next><span class=secno>4.12.4.18.3 </span>Link type "<dfn title=rel-next><code>next</code></dfn>"</h6>
<h6 id=link-type-next><span class=secno>4.12.4.17.1 </span>Link type "<dfn title=rel-next><code>next</code></dfn>"</h6>

<p>The <code title=rel-next><a href=#link-type-next>next</a></code> keyword may be used with
<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>
document that is the next logical document in the sequence.</p>


<h6 id=link-type-prev><span class=secno>4.12.4.18.4 </span>Link type "<dfn title=rel-prev><code>prev</code></dfn>"</h6>
<h6 id=link-type-prev><span class=secno>4.12.4.17.2 </span>Link type "<dfn title=rel-prev><code>prev</code></dfn>"</h6>

<p>The <code title=rel-prev><a href=#link-type-prev>prev</a></code> keyword may be used with
<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>
</div>


<h5 id=other-link-types><span class=secno>4.12.4.19 </span>Other link types</h5>
<h5 id=other-link-types><span class=secno>4.12.4.18 </span>Other link types</h5>

<p><dfn id=concept-rel-extensions title=concept-rel-extensions>Extensions to the predefined
set of link types</dfn> may be registered in the <a href=http://wiki.whatwg.org/wiki/RelExtensions>WHATWG Wiki
</div>


<h4 id=tag-clouds><span class=secno>4.13.2 </span>Tag clouds</h4>
<h4 id=rel-up><span class=secno>4.13.2 </span>Bread crumb navigation</h4>

<p>This specification does not provide a machine-readable way of
describing bread-crumb navigation menus. Authors are encouraged to
just use a series of links in a paragraph. The <code><a href=#the-nav-element>nav</a></code>
element can be used to mark the section containing these
paragraphs as being navigation blocks.</p>

<div class=example>

<p>In the following example, the current page can be reached via
two paths.</p>

<pre>&lt;nav&gt;
&lt;p&gt;
&lt;a href="/"&gt;Main&lt;/a&gt; &gt;
&lt;a href="/products/"&gt;Products&lt;/a&gt; &gt;
&lt;a href="/products/dishwashers/"&gt;Dishwashers&lt;/a&gt; &gt;
&lt;a&gt;Second hand&lt;/a&gt;
&lt;/p&gt;
&lt;p&gt;
&lt;a href="/"&gt;Main&lt;/a&gt; &gt;
&lt;a href="/second-hand/"&gt;Second hand&lt;/a&gt; &gt;
&lt;a&gt;Dishwashers&lt;/a&gt;
&lt;/p&gt;
&lt;/nav&gt;</pre>

</div>


<h4 id=tag-clouds><span class=secno>4.13.3 </span>Tag clouds</h4>

<p id=tag-cloud>This specification does not define any markup
specifically for marking up lists of keywords that apply to a group
</div>


<h4 id=conversations><span class=secno>4.13.3 </span>Conversations</h4>
<h4 id=conversations><span class=secno>4.13.4 </span>Conversations</h4>

<!-- http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2009-September/022576.html -->

</div>


<h4 id=footnotes><span class=secno>4.13.4 </span>Footnotes</h4>
<h4 id=footnotes><span class=secno>4.13.5 </span>Footnotes</h4>

<p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.</p>
that does not contain a U+003A COLON characters (:) <a href=#converted-to-ascii-lowercase title="converted to ASCII lowercase">to ASCII
lowercase</a>.</li>

<li><p>If <var title="">list of tokens</var> contains more than
one instance of the token <code title=rel-up><a href=#link-type-up>up</a></code>, then
remove all such tokens.</li>

<li><p>Coalesce duplicate tokens in <var title="">list of
tokens</var>.</li>

Oops, something went wrong.

0 comments on commit 16485bf

Please sign in to comment.