Skip to content

Commit

Permalink
Hierarchical link types; remove some comments that have already been …
Browse files Browse the repository at this point in the history 
…dealt with; minor markup fixups

git-svn-id: http://svn.whatwg.org/webapps@336 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Nov 22, 2006
1 parent 2b5f67c commit c523f5a
Show file tree
Hide file tree
Showing 2 changed files with 283 additions and 41 deletions.
183 changes: 159 additions & 24 deletions index
View file
Original file line number Diff line number Diff line change
Expand Up @@ -705,7 +705,33 @@
<li><a href="#link-type5"><span class=secno>4.5.3.7. </span>Link
type "<dfn id=feed title=rel-feed><code>feed</code></dfn>"</a>

<li><a href="#other"><span class=secno>4.5.3.8. </span>Other link
<li><a href="#hierarchical"><span class=secno>4.5.3.8.
</span>Hierarchical link types</a>
<ul class=toc>
<li><a href="#link-type6"><span class=secno>4.5.3.8.1. </span>Link
type "<dfn id=first title=rel-first><code>first</code></dfn>"</a>


<li><a href="#link-type7"><span class=secno>4.5.3.8.2. </span>Link
type "<dfn id=index title=rel-index><code>index</code></dfn>"</a>


<li><a href="#link-type8"><span class=secno>4.5.3.8.3. </span>Link
type "<dfn id=last title=rel-last><code>last</code></dfn>"</a>

<li><a href="#link-type9"><span class=secno>4.5.3.8.4. </span>Link
type "<dfn id=next title=rel-next><code>next</code></dfn>"</a>

<li><a href="#link-type10"><span class=secno>4.5.3.8.5.
</span>Link type "<dfn id=prev
title=rel-prev><code>prev</code></dfn>"</a>

<li><a href="#link-type11"><span class=secno>4.5.3.8.6.
</span>Link type "<dfn id=up
title=rel-up><code>up</code></dfn>"</a>
</ul>

<li><a href="#other"><span class=secno>4.5.3.9. </span>Other link
types</a>
</ul>

Expand Down Expand Up @@ -14891,7 +14917,7 @@ XXX selection ranges -->
<td>Gives the address of a syndication feed for the current document.

<tr>
<td><code title=rel-first>first</code>
<td><code title=rel-first><a href="#first0">first</a></code>

<td><a href="#hyperlink0" title="hyperlink link">Hyperlink</a>

Expand Down Expand Up @@ -14921,7 +14947,7 @@ XXX selection ranges -->
<td>Imports an icon to represent the current document.

<tr>
<td><code title=rel-index>index</code></td>
<td><code title=rel-index><a href="#index0">index</a></code></td>
<!-- used more than "top" and "contents" on <link> (though on <a>, "contents" wins) -->

<td><a href="#hyperlink0" title="hyperlink link">Hyperlink</a>
Expand All @@ -14932,7 +14958,7 @@ XXX selection ranges -->
index listing the current document.

<tr>
<td><code title=rel-last>last</code>
<td><code title=rel-last><a href="#last0">last</a></code>

<td><a href="#hyperlink0" title="hyperlink link">Hyperlink</a>

Expand All @@ -14953,7 +14979,7 @@ XXX selection ranges -->
license described by the target document.

<tr>
<td><code title=rel-next>next</code>
<td><code title=rel-next><a href="#next0">next</a></code>

<td><a href="#hyperlink0" title="hyperlink link">Hyperlink</a>

Expand Down Expand Up @@ -14995,7 +15021,7 @@ XXX selection ranges -->
<td>Specifies that the target resource should be pre-emptively cached.

<tr>
<td><code title=rel-prev>prev</code></td>
<td><code title=rel-prev><a href="#prev0">prev</a></code></td>
<!-- prev is used more than previous -->

<td><a href="#hyperlink0" title="hyperlink link">Hyperlink</a>
Expand Down Expand Up @@ -15050,7 +15076,7 @@ XXX selection ranges -->
current document.

<tr>
<td><code title=rel-up>up</code>
<td><code title=rel-up><a href="#up0">up</a></code>

<td><a href="#hyperlink0" title="hyperlink link">Hyperlink</a>

Expand Down Expand Up @@ -15133,7 +15159,7 @@ XXX selection ranges -->
past posts with <code title="">rel="archives"</code>.

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

<h5 id=link-type1><span class=secno>4.5.3.3. </span>Link type "<dfn
Expand Down Expand Up @@ -15283,13 +15309,136 @@ XXX selection ranges -->
&lt;li>&lt;a href="unexplored-planets.xml" rel="feed">Unexplored Planets&lt;/a>&lt;/li>
&lt;/ul></pre>
</div>

<h5 id=hierarchical><span class=secno>4.5.3.8. </span>Hierarchical link
types</h5>

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

<p>A hierarchical structure of documents is one where each document can
have various subdocuments. A subdocument is said to be a <em>child</em> of
the document it is a subdocument of. The document of which it is a
subdocument is said to be its <em>parent</em>. The children of a document
have a relative order; the subdocument that precedes another is its
<em>previous sibling</em>, and the one that follows it is its <em>next
sibling</em>. A document with no parent forms the top of the hierarchy.

<h6 id=link-type6><span class=secno>4.5.3.8.1. </span>Link type "<dfn
id=first0 title=rel-first><code>first</code></dfn>"</h6>

<p>The <code title=rel-first><a href="#first0">first</a></code> keyword may
be <code><a href="#link0">link</a></code>, <code><a
href="#a0">a</a></code>, and <code><a href="#area0">area</a></code>
elements. For <code><a href="#link0">link</a></code> elements, it creates
a <a href="#hyperlink0" title="hyperlink link">hyperlink</a>.

<p>The <code title=rel-first><a href="#first0">first</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 first child of the current
document's parent document.

<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="#first0">first</a></code> keyword.

<h6 id=link-type7><span class=secno>4.5.3.8.2. </span>Link type "<dfn
id=index0 title=rel-index><code>index</code></dfn>"</h6>

<p>The <code title=rel-index><a href="#index0">index</a></code> keyword may
be <code><a href="#link0">link</a></code>, <code><a
href="#a0">a</a></code>, and <code><a href="#area0">area</a></code>
elements. For <code><a href="#link0">link</a></code> elements, it creates
a <a href="#hyperlink0" title="hyperlink link">hyperlink</a>.

<p>The <code title=rel-index><a href="#index0">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.

<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="#index0">index</a></code> keyword.

<h6 id=link-type8><span class=secno>4.5.3.8.3. </span>Link type "<dfn
id=last0 title=rel-last><code>last</code></dfn>"</h6>

<p>The <code title=rel-last><a href="#last0">last</a></code> keyword may be
<code><a href="#link0">link</a></code>, <code><a href="#a0">a</a></code>,
and <code><a href="#area0">area</a></code> elements. For <code><a
href="#link0">link</a></code> elements, it creates a <a href="#hyperlink0"
title="hyperlink link">hyperlink</a>.

<p>The <code title=rel-last><a href="#last0">last</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 last child of the current
document's parent document.

<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="#last0">last</a></code> keyword.

<h6 id=link-type9><span class=secno>4.5.3.8.4. </span>Link type "<dfn
id=next0 title=rel-next><code>next</code></dfn>"</h6>

<p>The <code title=rel-next><a href="#next0">next</a></code> keyword may be
<code><a href="#link0">link</a></code>, <code><a href="#a0">a</a></code>,
and <code><a href="#area0">area</a></code> elements. For <code><a
href="#link0">link</a></code> elements, it creates a <a href="#hyperlink0"
title="hyperlink link">hyperlink</a>.

<p>The <code title=rel-next><a href="#next0">next</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 next sibling of the
current document.

<h6 id=link-type10><span class=secno>4.5.3.8.5. </span>Link type "<dfn
id=prev0 title=rel-prev><code>prev</code></dfn>"</h6>

<p>The <code title=rel-prev><a href="#prev0">prev</a></code> keyword may be
<code><a href="#link0">link</a></code>, <code><a href="#a0">a</a></code>,
and <code><a href="#area0">area</a></code> elements. For <code><a
href="#link0">link</a></code> elements, it creates a <a href="#hyperlink0"
title="hyperlink link">hyperlink</a>.

<p>The <code title=rel-prev><a href="#prev0">prev</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 previous sibling of the
current document.

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

<h6 id=link-type11><span class=secno>4.5.3.8.6. </span>Link type "<dfn
id=up0 title=rel-up><code>up</code></dfn>"</h6>

<p>The <code title=rel-up><a href="#up0">up</a></code> keyword may be
<code><a href="#link0">link</a></code>, <code><a href="#a0">a</a></code>,
and <code><a href="#area0">area</a></code> elements. For <code><a
href="#link0">link</a></code> elements, it creates a <a href="#hyperlink0"
title="hyperlink link">hyperlink</a>.

<p>The <code title=rel-up><a href="#up0">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> &gt;
<a href="/products/" rel="up up">Products</a> &gt;
<a href="/products/dishwashers" rel="up">Dishwashers</a> &gt;
Second hand
</p>
</nav>
-->
<!--
this section defines whether a particular link type is an external resource or a hyperlink


issues for rel="", etc:
rel="alternate stylesheet"
rel="up" vs rel="up up" vs rel="up up up top"
rel="feed" vs rel="alternate" type="application/rss+xml"
rel="icon"
rel="script"
Expand All @@ -15315,14 +15464,6 @@ this section defines whether a particular link type is an external resource or a
http://hixie.ch/specs/html/link/002
http://www.hixie.ch/specs/html/metadata

<nav>
<p>
<a href="/" rel="top up up up">Main</a> &gt;
<a href="/products/" rel="up up">Products</a> &gt;
<a href="/products/dishwashers" rel="up">Dishwashers</a> &gt;
Second hand
</p>
</nav>

mpt says:
> "As with <a> elements, when <link> elements that use these relationships
Expand All @@ -15331,17 +15472,11 @@ mpt says:
> render them. UAs should not make <link> rendering any easier to hide
> than <a> rendering."

rel="bookmark" gives permalink of nearest sectioning element
<dd>The first <code>a</code> element with a <code>rel</code>
attribute having as one of its values the keyword
<code>bookmark</code> in a depth first search of the
<code>article</code> element is the article's permalink.

disallow: http://microformats.org/wiki/rel-enclosure

-->

<h5 id=other><span class=secno>4.5.3.8. </span>Other link types</h5>
<h5 id=other><span class=secno>4.5.3.9. </span>Other link types</h5>

<p class=big-issue>Address extensibility.

Expand Down
Loading

0 comments on commit c523f5a

Please sign in to comment.