Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
make definitions of linktypes more consistent with each other. define…
… 'alternate'. move comment down

git-svn-id: http://svn.whatwg.org/webapps@324 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Nov 22, 2006
1 parent d4fb41e commit d9d5bca
Show file tree
Hide file tree
Showing 2 changed files with 267 additions and 176 deletions.
234 changes: 141 additions & 93 deletions index
Expand Up @@ -678,7 +678,11 @@
<li><a href="#linkTypes"><span class=secno>4.5.3. </span>Link
types</a>

<li><a href="#image"><span class=secno>4.5.4. </span>Image maps</a>
<li><a href="#link-type"><span class=secno>4.5.4. </span>Link type
"<dfn id=alternate
title=rel-alternate><code>alternate</code></dfn>"</a>

<li><a href="#image"><span class=secno>4.5.5. </span>Image maps</a>
</ul>

<li><a href="#tabular0"><span class=secno>4.6. </span>Tabular data</a>
Expand Down Expand Up @@ -14764,75 +14768,14 @@ XXX selection ranges -->

<h4 id=linkTypes><span class=secno>4.5.3. </span>Link types</h4>

<p class=big-issue>This section might at some future point list a small set
of link <code>rel</code>ationship types and more exactly define their
semantics than HTML4. This section (or indeed this specification in
general) is unlikely to specify anything related to the <code
title=attr-head-profile><a href="#profile">profile</a></code> attribute
and how to extend the link types in HTML. Work in this area is currently
being done by <a href="http://gmpg.org/">GMPG</a> and <a
href="http://protogenius.com/rel-schemas/draft-scheid-rel-schemas-00.htm">others</a>.</p>
<!--
this section defines whether a particular link type is an external resource or a hyperlink
<p>The following table summarises the link types that are defined by this
specification. This table is non-normative; the actual definitions for the
link types are given in the next few sections.


issues for rel="", etc:
rel="alternate" with hreflang=""
rel="alternate" with type=""
rel="alternate" with media=""
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"
rel="related" // see also
rel="prefetch"
rel="help" (Charles McCathieNevile): alternative to help="". give algo for nearest con.-sen. help
`-> "Nearness" seems in general like a really bad way to guess where the
> help is. Do you mean closest in the markup, or in the laid-out
> rendering? If the link were required to be inside a label in order to be
> associated with a form control, that might make sense though.
rev=""
rel="nofollow" - http://www.google.com/googleblog/2005/01/preventing-comment-spam.html
Refers to a resource that may be related to the linking
document, but is not endorsed by the author. This should
not be counted as a negative rating for the resource,
however. - http://www.w3.org/mid/41F0E7FA.4060301@iinet.net.au
- http://radio.weblogs.com/0001011/2005/01/31.html#a9301 (scoble on why it isn't bad)
which relationship combinations are allowed
what multiple values might mean (multiple rel="top")
removal of redundancy
http://www.euronet.nl/~tekelenb/WWW/LINK/
http://shift.freezope.org/konq_rellinks/development_html
http://hixie.ch/specs/html/link/001
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
> are present, UAs should render them. As with <a> elements, when <link>
> elements that use these relationships do not exist, UAs should not
> 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

-->
<p>In this section, the term <em>referenced document</em> refers to the
resource identified by the element representing the link, and the term
<em>current document</em> refers to the resource within which the element
representing the link finds itself.

<table>
<thead>
Expand All @@ -14851,14 +14794,14 @@ disallow: http://microformats.org/wiki/rel-enclosure

<tbody>
<tr>
<td><code title=rel-alternate>alternate</code></td>
<td><code title=rel-alternate><a href="#alternate0">alternate</a></code></td>
<!-- second most used <link rel> value -->

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

<td><a href="#hyperlinks">Hyperlink</a>

<td>Gives alternate representations of the document.
<td>Gives alternate representations of the current document.

<tr>
<td><code title=rel-archives>archives</code>
Expand All @@ -14877,7 +14820,7 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Gives a link to the document's author.
<td>Gives a link to the current document's author.

<tr>
<td><code title=rel-bookmark>bookmark</code></td>
Expand All @@ -14897,7 +14840,7 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Gives a link to contact information for the document.
<td>Gives a link to contact information for the current document.

<tr>
<td><code title=rel-external>external</code></td>
Expand All @@ -14907,8 +14850,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Indicates that the target resource is not part of the site that the
document is part of.
<td>Indicates that the target document is not part of the same site as
the current document.

<tr>
<td><code title=rel-feed>feed</code>
Expand All @@ -14917,7 +14860,7 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Gives the address of a syndication feed for the document.
<td>Gives the address of a syndication feed for the current document.

<tr>
<td><code title=rel-first>first</code>
Expand All @@ -14926,8 +14869,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Indicates that the document is a part of a series, and that the
first document in the series is the target document.
<td>Indicates that the current document is a part of a series, and that
the first document in the series is the target document.

<tr>
<td><code title=rel-help>help</code>
Expand All @@ -14947,7 +14890,7 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><em>not allowed</em>

<td>Imports an icon to represent the document.
<td>Imports an icon to represent the current document.

<tr>
<td><code title=rel-index>index</code></td>
Expand All @@ -14967,8 +14910,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Indicates that the document is a part of a series, and that the last
document in the series is the target document.
<td>Indicates that the current document is a part of a series, and that
the last document in the series is the target document.

<tr>
<td><code title=rel-license>license</code></td>
Expand All @@ -14978,8 +14921,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Indicates that the document is covered by the copyright license
described by the target document.
<td>Indicates that the current document is covered by the copyright
license described by the target document.

<tr>
<td><code title=rel-next>next</code>
Expand All @@ -14988,8 +14931,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Indicates that the document is a part of a series, and that the next
document in the series is the target document.
<td>Indicates that the current document is a part of a series, and that
the next document in the series is the target document.

<tr>
<td><code title=rel-nofollow>nofollow</code></td>
Expand All @@ -14999,8 +14942,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Indicates that the document's original author or publisher does not
endorse the target document.
<td>Indicates that the current document's original author or publisher
does not endorse the target document.

<tr>
<td><code title=rel-pingback>pingback</code>
Expand All @@ -15011,7 +14954,7 @@ disallow: http://microformats.org/wiki/rel-enclosure
<td><em>not allowed</em>

<td>Gives the address of the pingback server that handles pingbacks to
this document.
the current document.

<tr>
<td><code title=rel-prefetch>prefetch</code>
Expand All @@ -15031,8 +14974,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Indicates that the document is a part of a series, and that the
previous document in the series is the target document.
<td>Indicates that the current document is a part of a series, and that
the previous document in the series is the target document.

<tr>
<td><code title=rel-search>search</code></td>
Expand Down Expand Up @@ -15075,8 +15018,8 @@ disallow: http://microformats.org/wiki/rel-enclosure

<td><a href="#hyperlinks">Hyperlink</a>

<td>Gives a tag (identified by the given address) that applies to this
document.
<td>Gives a tag (identified by the given address) that applies to the
current document.

<tr>
<td><code title=rel-up>up</code>
Expand All @@ -15089,7 +15032,112 @@ disallow: http://microformats.org/wiki/rel-enclosure
document.
</table>

<h4 id=image><span class=secno>4.5.4. </span>Image maps</h4>
<h4 id=link-type><span class=secno>4.5.4. </span>Link type "<dfn
id=alternate0 title=rel-alternate><code>alternate</code></dfn>"</h4>

<p>On the <code><a href="#link0">link</a></code> element, if the the <code
title=attr-link-rel><a href="#rel">rel</a></code> attribute also contains
the keyword <code title=rel-stylesheet>stylesheet</code>, the <code
title=rel-alternate><a href="#alternate0">alternate</a></code> keyword
modifies the meaning of the <code title=rel-stylesheet>stylesheet</code>
keyword in the way described for that keyword, and the rest of this
subsection doesn't apply.

<p>Otherwise, the <code title=rel-alternate><a
href="#alternate0">alternate</a></code> keyword indicates that the
referenced document is an alternate representation of the current
document.

<p>The nature of the target document is given by the <code
title=attr-hyperlink-media><a href="#media5">media</a></code>, <code
title=attr-hyperlink-hreflang><a href="#hreflang3">hreflang</a></code>,
and <code title=attr-hyperlink-type><a href="#type14">type</a></code>
attributes.

<p>If the <code title=rel-alternate><a
href="#alternate0">alternate</a></code> keyword is used with the <code
title=attr-hyperlink-media><a href="#media5">media</a></code> attribute,
it indicates that the target document is intended for use with the media
specified.

<p>If the <code title=rel-alternate><a
href="#alternate0">alternate</a></code> keyword is used with the <code
title=attr-hyperlink-hreflang><a href="#hreflang3">hreflang</a></code>
attribute, it indicates that the target document is a translation.

<p>If the <code title=rel-alternate><a
href="#alternate0">alternate</a></code> keyword is used with the <code
title=attr-hyperlink-type><a href="#type14">type</a></code> attribute, it
indicates that the target document is a reformulation of the current
document in the specified format.

<p>If the <code title=rel-alternate><a
href="#alternate0">alternate</a></code> keyword is used with the <code
title=attr-hyperlink-type><a href="#type14">type</a></code> attribute set
to the value <code title="">application/rss+xml</code> or the value <code
title="">application/atom+xml</code>, then the user agent must treat the
link as it would if it had the <code title=rel-feed>feed</code> keyword
specified as well.</p>
<!--
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"
rel="related" // see also
rel="prefetch"
rel="help" (Charles McCathieNevile): alternative to help="". give algo for nearest con.-sen. help
`-> "Nearness" seems in general like a really bad way to guess where the
> help is. Do you mean closest in the markup, or in the laid-out
> rendering? If the link were required to be inside a label in order to be
> associated with a form control, that might make sense though.
rev=""
rel="nofollow" - http://www.google.com/googleblog/2005/01/preventing-comment-spam.html
Refers to a resource that may be related to the linking
document, but is not endorsed by the author. This should
not be counted as a negative rating for the resource,
however. - http://www.w3.org/mid/41F0E7FA.4060301@iinet.net.au
- http://radio.weblogs.com/0001011/2005/01/31.html#a9301 (scoble on why it isn't bad)
which relationship combinations are allowed
what multiple values might mean (multiple rel="top")
removal of redundancy
http://www.euronet.nl/~tekelenb/WWW/LINK/
http://shift.freezope.org/konq_rellinks/development_html
http://hixie.ch/specs/html/link/001
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
> are present, UAs should render them. As with <a> elements, when <link>
> elements that use these relationships do not exist, UAs should not
> 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

-->

<h4 id=image><span class=secno>4.5.5. </span>Image maps</h4>

<p class=big-issue>...<dfn id=image0>image map</dfn>, <dfn id=valid5>valid
area</dfn>, <dfn id=usemap1
Expand Down

0 comments on commit d9d5bca

Please sign in to comment.