- From: poot <cvsmail@w3.org>
- Date: Sun, 4 Apr 2010 16:03:25 +0900 (JST)
- To: public-html-diffs@w3.org
hixie: Define rel=alternate for feeds as something conforming. (whatwg
r4964)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3985&r2=1.3986&f=h
http://html5.org/tools/web-apps-tracker?from=4963&to=4964
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3985
retrieving revision 1.3986
diff -u -d -r1.3985 -r1.3986
--- Overview.html 4 Apr 2010 06:33:56 -0000 1.3985
+++ Overview.html 4 Apr 2010 07:03:10 -0000 1.3986
@@ -38432,75 +38432,104 @@
* http://microformats.org/wiki/rel-enclosure
--><h5 id="link-type-alternate"><span class="secno">4.12.3.1 </span>Link type "<dfn title="rel-alternate"><code>alternate</code></dfn>"</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</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. For <code><a href="#the-link-element">link</a></code> elements, if the <code title="attr-link-rel"><a href="#attr-link-rel">rel</a></code> attribute does not also contain the
- keyword <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code>, it creates a
- <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>; but if it
- <em>does</em> also contain the keyword <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code>, the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword instead modifies the
- meaning of the <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code>
- keyword in the way described for that keyword, and the rest of this
- subsection doesn't apply.<p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword
- indicates that the referenced document is an alternate
- representation of the current document.<p>The nature of the referenced document is given by the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes.<p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
- used with the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>
- attribute, it indicates that the referenced document is intended for
- use with the media specified.<p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
- used with the <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>
- attribute, and that attribute's value differs from the <a href="#root-element">root
- element</a>'s <a href="#language">language</a>, it indicates that the
- referenced document is a translation.<p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
- used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
- attribute, it indicates that the referenced document is a
- reformulation of the current document in the specified format.<p>The <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes can be combined
- when specified with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>
- keyword.<div class="example">
+ elements.<p>The meaning of this keyword depends on the values of the other
+ attributes.<dl class="switch"><dt>If the element is a <code><a href="#the-link-element">link</a></code> element and the <code title="attr-link-rel"><a href="#attr-link-rel">rel</a></code> attribute also contains the
+ keyword <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code></dt>
- <p>For example, the following link is a French translation that
- uses the PDF format:</p>
+ <dd>
- <pre><link rel=alternate type=application/pdf hreflang=fr href=manual-fr></pre>
+ <p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword
+ modifies the meaning of the <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code> keyword in the way
+ described for that keyword. The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword does not create a
+ link of its own.</p>
- </div><div class="impl">
+ </dd>
- <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
- used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
- attribute set to the value <code title="">application/rss+xml</code>
- or the value <code title="">application/atom+xml</code>, then it
- indicates that the referenced document is a syndication feed (though
- not necessarily syndicating exactly the same content as the current
- page).</p>
- <div class="impl">
+ <dt>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+ used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
+ attribute set to the value <code title="">application/rss+xml</code> or the value <code title="">application/atom+xml</code></dt>
- <p>The first <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, or <code><a href="#the-area-element">area</a></code>
- element in the document (in tree order) with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attribute set to the value
- <code title="">application/rss+xml</code> or the value <code title="">application/atom+xml</code> must be treated as the default
- syndication feed for the purposes of feed autodiscovery.</p>
+ <dd>
- <div class="example">
- <p>The following <code><a href="#the-link-element">link</a></code> element gives the syndication
- feed for the current page:</p>
- <pre><link rel="alternate" type="application/atom+xml" href="data.xml"></pre>
- <p>The following extract offers various different syndication
- feeds:</p>
- <pre><p>You can access the planets database using Atom feeds:</p>
+ <p>The link is a <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>
+ referencing a syndication feed (though not necessarily syndicating
+ exactly the same content as the current page).</p>
+
+ <div class="impl">
+
+ <p>The first <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, or <code><a href="#the-area-element">area</a></code>
+ element in the document (in tree order) with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attribute set to the value
+ <code title="">application/rss+xml</code> or the value <code title="">application/atom+xml</code> must be treated as the default
+ syndication feed for the purposes of feed autodiscovery.</p>
+
+ <div class="example">
+ <p>The following <code><a href="#the-link-element">link</a></code> element gives the syndication
+ feed for the current page:</p>
+ <pre><link rel="alternate" type="application/atom+xml" href="data.xml"></pre>
+ <p>The following extract offers various different syndication
+ feeds:</p>
+ <pre><p>You can access the planets database using Atom feeds:</p>
<ul>
<li><a href="recently-visited-planets.xml" rel="alternate" type="application/atom+xml">Recently Visited Planets</a></li>
<li><a href="known-bad-planets.xml" rel="alternate" type="application/atom+xml">Known Bad Planets</a></li>
<li><a href="unexplored-planets.xml" rel="alternate" type="application/atom+xml">Unexplored Planets</a></li>
</ul></pre>
- </div>
+ </div>
- </div>
+ </div>
+ </dd>
+ <dt>Otherwise</dt>
- </div><p>The <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> link
- relationship is transitive — that is, if a document links to
- two other documents with the link type "<code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>", then, in addition to
- implying that those documents are alternative representations of the
- first document, it is also implying that those two documents are
- alternative representations of each other.<h5 id="link-type-archives"><span class="secno">4.12.3.2 </span>Link type "<dfn title="rel-archives"><code>archives</code></dfn>"</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="rel-archives"><a href="#link-type-archives">archives</a></code> keyword may be
+ <dd>
+
+ <p>The link is a <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>
+ referencing an alternate representation of the current
+ document.</p>
+
+ <p>The nature of the referenced document is given by the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes.</p>
+
+ <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+ used with the <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>
+ attribute, it indicates that the referenced document is intended for
+ use with the media specified.</p>
+
+ <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+ used with the <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>
+ attribute, and that attribute's value differs from the <a href="#root-element">root
+ element</a>'s <a href="#language">language</a>, it indicates that the
+ referenced document is a translation.</p>
+
+ <p>If the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code> keyword is
+ used with the <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code>
+ attribute, it indicates that the referenced document is a
+ reformulation of the current document in the specified format.</p>
+
+ <p>The <code title="attr-hyperlink-media"><a href="#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="#attr-hyperlink-type">type</a></code> attributes can be combined
+ when specified with the <code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>
+ keyword.</p>
+
+ <div class="example">
+
+ <p>For example, the following link is a French translation that
+ uses the PDF format:</p>
+
+ <pre><link rel=alternate type=application/pdf hreflang=fr href=manual-fr></pre>
+
+ </div>
+
+ <p>This relationship is transitive — that is, if a document
+ links to two other documents with the link type "<code title="rel-alternate"><a href="#link-type-alternate">alternate</a></code>", then, in addition to
+ implying that those documents are alternative representations of
+ the first document, it is also implying that those two documents
+ are alternative representations of each other.</p>
+
+ </dd>
+
+ </dl><h5 id="link-type-archives"><span class="secno">4.12.3.2 </span>Link type "<dfn title="rel-archives"><code>archives</code></dfn>"</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="rel-archives"><a href="#link-type-archives">archives</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. For <code><a href="#the-link-element">link</a></code> elements, it creates a <a href="#hyperlink-link" title="hyperlink link">hyperlink</a>.<p>The <code title="rel-archives"><a href="#link-type-archives">archives</a></code> keyword indicates
that the referenced document describes a collection of records,
Received on Sunday, 4 April 2010 07:03:55 UTC