HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/324

File a bug

SVNBugCommentTime (UTC)
324make definitions of linktypes more consistent with each other. define 'alternate'. move comment down2006-11-22 02:29
Index: source
===================================================================
--- source	(revision 323)
+++ source	(revision 324)
@@ -13098,77 +13098,16 @@
 
   <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>
+  <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>
 
-  <!--
-this section defines whether a particular link type is an external resource or a hyperlink
+  <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>
 
-
-  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
-
-  -->
-
   <table>
    <thead>
     <tr>
@@ -13187,7 +13126,7 @@
      <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>
@@ -13201,7 +13140,7 @@
      <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>
@@ -13215,28 +13154,28 @@
      <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>
@@ -13250,7 +13189,7 @@
      <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>
@@ -13264,35 +13203,35 @@
      <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>
@@ -13306,7 +13245,7 @@
      <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>
@@ -13334,7 +13273,7 @@
      <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>
@@ -13349,6 +13288,110 @@
 
 
 
+  <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>,

|