HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
324make definitions of linktypes more consistent with each other. define 'alternate'. move comment down2006-11-22 02:29
@@ -13091,229 +13091,168 @@ XXX selection ranges -->
    title="attr-hyperlink-ping">ping</code> attribute so that the user agent
    can improve <!-- XXX optimise? --> the user experience.</p> <!--
    XXX need a better way to end that sentence. It's what I mean, but
    it sounds kooky. -->
 
   </div>
 
 
   <h4 id="linkTypes">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">profile</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
-
-
-  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>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.</p>
 
-  -->
+  <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.</p>
 
   <table>
    <thead>
     <tr>
      <th rowspan="2">Link type</th>
      <th colspan="2">Effect on...</th>
      <th rowspan="2">Brief description</th>
     </tr>
     <tr>
      <th><code>link</code></th>
      <th><code>a</code> and <code>area</code></th>
     </tr>
    </thead>
    <tbody>
 
     <tr>
      <td><code title="rel-alternate">alternate</code></td> <!-- second most used <link rel> value -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Gives alternate representations of the document.</td>
+     <td>Gives alternate representations of the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-archives">archives</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
      <td>Provides a link to a collection of records, documents, or other materials of historical interest.</td>
     </tr>
 
     <tr>
      <td><code title="rel-author">author</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Gives a link to the document's author.</td>
+     <td>Gives a link to the current document's author.</td>
     </tr>
 
     <tr>
      <td><code title="rel-bookmark">bookmark</code></td> <!-- fourth most used <a rel> value -->
      <td><em>not allowed</em></td>
      <td><span>Hyperlink</span></td>
      <td>Gives the permalink for the nearest ancestor section.</td>
     </tr>
 
     <tr>
      <td><code title="rel-contact">contact</code></td> <!-- 8th most used <a rel> value -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Gives a link to contact information for the document.</td>
+     <td>Gives a link to contact information for the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-external">external</code></td> <!-- fifth and sixth most used <a rel> value (sixth is "external nofollow") -->
      <td><em>not allowed</em></td>
      <td><span>Hyperlink</span></td>
-     <td>Indicates that the target resource is not part of the site that the document is part of.</td>
+     <td>Indicates that the target document is not part of the same site as the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-feed">feed</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Gives the address of a syndication feed for the document.</td>
+     <td>Gives the address of a syndication feed for the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-first">first</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Indicates that the document is a part of a series, and that the first document in the series is the target document.</td>
+     <td>Indicates that the current document is a part of a series, and that the first document in the series is the target document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-help">help</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
      <td>Provides a link to context-sensitive help.</td>
     </tr>
 
     <tr>
      <td><code title="rel-icon">icon</code></td> <!-- link rel="shortcut icon" and its ilk are the fourth, sixth, and ninth most used values -->
      <td><span title="external resource link">External Resource</span></td>
      <td><em>not allowed</em></td>
-     <td>Imports an icon to represent the document.</td>
+     <td>Imports an icon to represent the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-index">index</code></td> <!-- used more than "top" and "contents" on <link> (though on <a>, "contents" wins) -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
      <td>Gives a link to the document that provides a table of contents or index listing the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-last">last</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Indicates that the document is a part of a series, and that the last document in the series is the target document.</td>
+     <td>Indicates that the current document is a part of a series, and that the last document in the series is the target document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-license">license</code></td> <!-- seventh most used <a rel> value -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Indicates that the document is covered by the copyright license described by the target document.</td>
+     <td>Indicates that the current document is covered by the copyright license described by the target document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-next">next</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Indicates that the document is a part of a series, and that the next document in the series is the target document.</td>
+     <td>Indicates that the current document is a part of a series, and that the next document in the series is the target document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-nofollow">nofollow</code></td> <!-- most used <a rel> value (and sixth most used is "external nofollow") -->
      <td><em>not allowed</em></td>
      <td><span>Hyperlink</span></td>
-     <td>Indicates that the document's original author or publisher does not endorse the target document.</td>
+     <td>Indicates that the current document's original author or publisher does not endorse the target document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-pingback">pingback</code></td>
      <td><span title="external resource link">External Resource</span></td>
      <td><em>not allowed</em></td>
-     <td>Gives the address of the pingback server that handles pingbacks to this document.</td>
+     <td>Gives the address of the pingback server that handles pingbacks to the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-prefetch">prefetch</code></td>
      <td><span title="external resource link">External Resource</span></td>
      <td><em>not allowed</em></td>
      <td>Specifies that the target resource should be pre-emptively cached.</td>
     </tr>
 
     <tr>
      <td><code title="rel-prev">prev</code></td> <!-- prev is used more than previous -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Indicates that the document is a part of a series, and that the previous document in the series is the target document.</td>
+     <td>Indicates that the current document is a part of a series, and that the previous document in the series is the target document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-search">search</code></td> <!-- used quite a bit -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
      <td>Gives a link to a resource that can be used to search through the current document and its related pages.</td>
     </tr>
 
     <tr>
@@ -13327,35 +13266,139 @@ disallow: http://microformats.org/wiki/rel-enclosure
      <td><code title="rel-sidebar">sidebar</code></td> <!-- used quite a bit -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
      <td>Specifies that the target document, if retrieved, is intended to be shown in the browser's sidebar (if it has one).</td>
     </tr>
 
     <tr>
      <td><code title="rel-tag">tag</code></td> <!-- second and third most used <a rel> value (third is technically "category tag"). -->
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
-     <td>Gives a tag (identified by the given address) that applies to this document.</td>
+     <td>Gives a tag (identified by the given address) that applies to the current document.</td>
     </tr>
 
     <tr>
      <td><code title="rel-up">up</code></td>
      <td><span title="hyperlink link">Hyperlink</span></td>
      <td><span>Hyperlink</span></td>
      <td>Provides a link to a document giving the context for the current document.</td>
     </tr>
 
    </tbody>
   </table>
 
 
 
+  <h4>Link type "<dfn title="rel-alternate"><code>alternate</code></dfn>"</h4>
+
+  <p>On the <code>link</code> element, if the the <code
+  title="attr-link-rel">rel</code> attribute also contains the keyword
+  <code title="rel-stylesheet">stylesheet</code>, the <code
+  title="rel-alternate">alternate</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>
+
+  <p>Otherwise, the <code title="rel-alternate">alternate</code>
+  keyword indicates that the referenced document is an alternate
+  representation of the current document.</p>
+
+  <p>The nature of the target document is given by the <code
+  title="attr-hyperlink-media">media</code>, <code
+  title="attr-hyperlink-hreflang">hreflang</code>, and <code
+  title="attr-hyperlink-type">type</code> attributes.</p>
+
+  <p>If the <code title="rel-alternate">alternate</code> keyword is
+  used with the <code title="attr-hyperlink-media">media</code>
+  attribute, it indicates that the target document is intended for use
+  with the media specified.</p>
+
+  <p>If the <code title="rel-alternate">alternate</code> keyword is
+  used with the <code title="attr-hyperlink-hreflang">hreflang</code>
+  attribute, it indicates that the target document is a
+  translation.</p>
+
+  <p>If the <code title="rel-alternate">alternate</code> keyword is
+  used with the <code title="attr-hyperlink-type">type</code>
+  attribute, it indicates that the target document is a reformulation
+  of the current document in the specified format.</p>
+
+  <p>If the <code title="rel-alternate">alternate</code> keyword is
+  used with the <code title="attr-hyperlink-type">type</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>Image maps</h4>
 
   <p class="big-issue">...<dfn>image map</dfn>, <dfn>valid area</dfn>,
   <dfn title="attr-hyperlink-usemap"><code>usemap</code></dfn>, <dfn
   title="attr-area-coords"><code>coords</code></dfn>, <dfn
   title="attr-area-shape"><code>shape</code></dfn>, <dfn>server side
   image map</dfn>.</p>
 
   <!-- usemap is special-cased when it starts with a "#".
        does any browser support it when it doesn't? -->

|