/[suikacvs]/webroot/www/2006/auto-discovery.en.html
Suika

Diff of /webroot/www/2006/auto-discovery.en.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.1 by wakaba, Sun Dec 3 09:52:00 2006 UTC revision 1.3 by wakaba, Sat Apr 7 09:02:52 2007 UTC
# Line 9  Line 9 
9    
10  <div class="header">  <div class="header">
11  <h1>Auto-Discovery Auto-Discovery Specification</h1>  <h1>Auto-Discovery Auto-Discovery Specification</h1>
12    <h2>Working Draft 7 April 2007</h2>
13    
14  <dl class="versions-uri">  <dl class="versions-uri">
15  <dt>This Version</dt>  <dt>This Version</dt>
# Line 24  Line 25 
25  -->  -->
26  <!-- <dt>Previous Version</dt> -->  <!-- <dt>Previous Version</dt> -->
27  </dl>  </dl>
28  <dl class="authors">  <dl class="authors" id="author">
29  <dt>Author</dt>  <dt>Author</dt>
30    <dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>    <dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>
31    <code class="mail">&lt;<a href="mailto:w@suika.fam.cx" rel="author"    <code class="mail">&lt;<a href="mailto:w@suika.fam.cx" rel="author"
32        >w@suika.fam.cx</a>&gt;</code></dd>        >w@suika.fam.cx</a>&gt;</code></dd>
33  </dl>  </dl>
34    
35  <p class="copyright" lang="en">&#xA9; 2006 <a  <p class="copyright" lang="en">&#xA9; 2006, 2007 <a
36      href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>.      href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>.
37  Permission is granted to copy, distribute and/or modify this document  Permission is granted to copy, distribute and/or modify this document
38  under the terms of the <a rel="license"  under the terms of the <a rel="license"
# Line 56  available at <code class="URI">&lt;<a Line 57  available at <code class="URI">&lt;<a
57  <div id="status" class="section">  <div id="status" class="section">
58  <h2>Status of This Document</h2>  <h2>Status of This Document</h2>
59    
60  <div class="ed issue"><p>Work in progress</p></div>  <p><em>This section describes the status of this document
61    at the time of its publication.  Other documents
62    might supersede this document.</em></p>
63    
64    <div class="ed issue"><p><em>Oops, it's too late for the April
65    Fool!</em></p></div>
66    
67    <p>This document is a working draft.
68    It might be updated, replaced, or obsoleted by
69    other documents at any time.  It is inappropriate to
70    cite this document as other than <q>work in progress</q>.</p>
71    
72    <p>Comments on this document are welcome and
73    may be sent to the <a href="#author">author</a>.</p>
74    
75    <p>Translations of thie document might be available.
76    The English version of the document is the only
77    normative version.</p>
78  </div>  </div>
79    
80  <div id="introduction" class="section">  <div id="introduction" class="section">
81  <h2>Introduction</h2>  <h2>Introduction</h2>
82    
83  <div class="ed issue">...</div>  <p>Recently, a number of auto-discovery conventions
84    are proposed and implemented in various Web browsers
85    and so-called <q>Web 2.0</q> services.  They provide
86  </div>  means to extract links to resources (or other useful
87    information) from Web documents in somewhat reliable
88  <div class="section">  ways.  However, the syntax of these techniques
89  <h2>Embeding Auto-Discovery Auto-Discovery Link in HTML Document</h2>  vary and the implementators have to add specific
90    code for each auto-discovery technique.</p>
91  <div class="section informative">  
92  <h3>Introduction</h3>  <p>The <dfn id="DT-autodiscovery-autodiscovery">Auto-Discovery
93    Auto-Discovery</dfn> is a mechanism to discover
94  <p>This section is <em>informative</em>.</p>  auto-discovery element that contains links (or
95    other information) for auto-discovery techniques.
96  <div class="example figure block">  With the Auto-Discovery Auto-Discovery, user agents
97  <div class="caption">Auto-Discovery Auto-Discovery  can detect auto-discovery elements without any
98  for TrackBack Auto-Discovery</div>  particular knowledge to a specific auto-discovery
99    technique.</p>
 <pre><code class="HTML">  
   &lt;rdf:RDF  
       xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"  
       xmlns:dc="http://purl.org/dc/elements/1.1/"  
       xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/"  
       xml:id="trackback">  
     &lt;rdf:Description  
         rdf:about="http://www.foo.example/archive.html#foo"  
         dc:identifier="http://www.foo.example/archive.html#foo"  
         dc:title="Foo Bar"  
         trackback:ping="http://www.foo.example/tb.cgi/5" />  
   &lt;/rdf:RDF>  
   &lt;link rel="meta" href="#trackback">  
 </code></pre>  
 </div>  
   
 <div class="example figure block">  
 <div class="caption">Auto-Discovery Auto-Discovery  
 for Atom Auto-Discovery</div>  
100    
 <pre><code class="HTML">  
 &lt;link rel="meta" href="#atom">  
 &lt;link id="atom" rel="feed" href="feed.atom" type="application/atom+xml">  
 </code></pre>  
101  </div>  </div>
102    
103    <div class="section" id="terminology">
104    <h2>Terminology</h2>
105    
106    <p>The key words <q><em class="rfc2119">MUST</em></q>,
107    <q><em class="rfc2119">MUST NOT</em></q>,
108    <q><em class="rfc2119">SHOULD</em></q>, and
109    <q><em class="rfc2119">SHOULD NOT</em></q> in this
110    document are to be interpreted as described in
111    <abbr title="Request for Comments">RFC</abbr> 2119
112    <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
113  </div>  </div>
114    
115  <div class="section">  <div class="section" id="for-authors">
116  <h3>Definition</h3>  <h2>Embeding Auto-Discovery Auto-Discovery Link</h2>
117    
118  <p>An <dfn id="DT-autodiscovery-autodiscovery-link">Auto-Discovery  <p>An <dfn id="DT-autodiscovery-autodiscovery-link">Auto-Discovery
119  Auto-Discovery link</dfn> is a hyperlink to  Auto-Discovery link</dfn> is a hyperlink to
120  an Auto-Discovery element.    an auto-discovery element.  
121  The <dfn id="DT-referenced-element">referenced element</dfn>  The <dfn id="DT-referenced-element">referenced element</dfn>
122  is the outermost element for the Auto-Discovery.</p>  is the outermost element for the auto-discovery.</p>
123    
124  <p>The <dfn id="DT-referencing-element">referencing element</dfn>  <p>The <dfn id="DT-referencing-element">referencing element</dfn>
125  is the element representing an <a  is the element representing an <a
126      href="#DT-autodiscovery-autodiscovery-link">Auto-Discovery      href="#DT-autodiscovery-autodiscovery-link">Auto-Discovery
127  Auto-Discovery link</a>.</p>  Auto-Discovery link</a>.</p>
128    
129    <!--
130  <p>The <a href="#DT-referenced-element">referenced element</a>  <p>The <a href="#DT-referenced-element">referenced element</a>
131  <em class="rfc2119">MUST</em> have an  <em class="rfc2119">MUST</em> have an
132  <code class="HTMLa">id</code> attribute.</p>  <code>ID</code> attribute.</p>
133    
134      <div class="note memo">
135      <p>In HTML, the <code class="HTMLa">id</code> attribute
136      is an <code>ID</code> attribute.  In XML, the
137      <code class="XMLa">xml:id</code> attribute may be used.</p>
138      </div>
139    -->
140    
141  <p>The <a href="#DT-referencing-element">referencing element</a>  <p>The <a href="#DT-referencing-element">referencing element</a>
142  <em class="rfc2119">MUST</em> be a <code class="HTMLe">link</code>  <em class="rfc2119">MUST</em> be a <code class="HTMLe">link</code>
# Line 132  element in the <code class="URI">http:// Line 144  element in the <code class="URI">http://
144  namespace.</p>  namespace.</p>
145    
146  <p>The <a href="#DT-referencing-element">referencing element</a>  <p>The <a href="#DT-referencing-element">referencing element</a>
147  <em class="rfc2119">MUST</em> have a <code class="HTMLa">rel</code>  <em class="rfc2119">MUST</em> have the <code class="HTMLa">rel</code>
148  attribute which contains <code class="HTML">meta</code>  attribute which contains <code class="HTML">meta</code>
149  as the only link relationship value.</p>  as its only link relationship value.</p>
150    
151  <p>The <a href="#DT-referencing-element">referencing element</a>  <p>The <a href="#DT-referencing-element">referencing element</a>
152  <em class="rfc2119">MUST</em> have an <code class="HTMLa">id</code>  <em class="rfc2119">MUST</em> have the <code class="HTMLa">href</code>
153  attribute whose value is a same-document IRI reference  attribute whose value is a same-document IRI reference
154  <cite class="bibref normative">[<a href="#ref-IRI">IRI</a>]</cite>  <cite class="bibref normative">[<a href="#ref-IRI">IRI</a>]</cite>
155  referencing the <a href="#DT-referenced-element">referenced  referencing a <a href="#DT-referenced-element">referenced
156  element</a> in the same document.  The  element</a> within the same document.  The
157  <a href="#DT-referenced-element">referenced element</a>  <a href="#DT-referenced-element">referenced element</a>
158  <em class="rfc2119">MUST NOT</em> be an element  <em class="rfc2119">MUST NOT</em> be a
159  representing an <a href="#DT-autodiscovery-autodiscovery-link">Auto-Discovery  <a href="#DT-referencing-element">referencing element</a>.</p>
 Auto-Discovery link</a>.</p>  
160    
161  <div class="issue ed">  <div class="issue ed">
162  <p>Ensure that <q>same-document IRI reference</q>  <p>Ensure that <q>same-document IRI reference</q>
163  is a defined term.</p>  is a defined term.</p>
164  </div>  </div>
165    
166      <div class="note memo">
167      <p>The <a href="#DT-referencing-element">referencing element</a>
168      might have any other attributes as defined in relavant specifications.
169      For example, a <a href="#DT-referencing-element">referencing element</a>
170      that points a <a href="#DT-referenced-element">referenced element</a>
171      which only applied to specific media might have the
172      <code class="HTMLa">media</code> attribute specified.</p>
173      </div>
174    
175      <div class="note memo">
176      <p>It is necessary for a <a href="#DT-referencing-element">referencing
177      element</a> to be inserted to the position where it is allowed.
178      For example, no elements in the HTML namespace other than
179      <code class="HTMLe">head</code> is allowed to contain
180      <code class="HTMLe">link</code> elements
181      <cite class="bibref normative">[<a href="#ref-HTML5">HTML5</a>]</cite>.</p>
182    
183      <p>Note also that <a href="#DT-referencing-element">referencing element</a>s
184      might appear in non-HTML documents.  For example, they might
185      be used in the <code class="XMLe">rss</code> element
186      of an <abbr>RSS</abbr> feed document.</p>
187      </div>
188    
189  <p>The <a href="#DT-referencing-element">referencing element</a>  </div>
190  <em class="rfc2119">MAY</em> have other attributes.</p>  
191    </div>
192    
193    <div class="section" id="for-ua">
194    <h2>Auto-Discovering Auto-Discovery Elements</h2>
195    
196  <div class="ed">...</div>  <div class="ed">...</div>
197    
198  </div>  </div>
199    
200    <div class="section" id="examples">
201    <h2>Examples</h2>
202    
203    <p>This section is <em>informative</em>.</p>
204    
205    <div class="ed issue">...</div>
206    
207    <div class="example figure block">
208    <div class="caption">Auto-Discovery Auto-Discovery
209    for TrackBack Auto-Discovery</div>
210    
211    <pre><code class="HTML">
212      &lt;rdf:RDF
213          xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
214          xmlns:dc="http://purl.org/dc/elements/1.1/"
215          xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/"
216          xml:id="trackback">
217        &lt;rdf:Description
218            rdf:about="http://www.foo.example/archive.html#foo"
219            dc:identifier="http://www.foo.example/archive.html#foo"
220            dc:title="Foo Bar"
221            trackback:ping="http://www.foo.example/tb.cgi/5" />
222      &lt;/rdf:RDF>
223      &lt;link rel="meta" href="#trackback">
224    </code></pre>
225    </div>
226    
227    <div class="example figure block">
228    <div class="caption">Auto-Discovery Auto-Discovery
229    for Atom Auto-Discovery</div>
230    
231    <pre><code class="HTML">
232    &lt;link rel="meta" href="#atom">
233    &lt;link id="atom" rel="feed" href="feed.atom" type="application/atom+xml">
234    </code></pre>
235  </div>  </div>
236    
 <div class="ed issue">  
 <p>In RSS, Atom, or other XML document...</p>  
237  </div>  </div>
238    
239  <div id="references" class="section reference">  <div id="references" class="section reference">
# Line 174  is a defined term.</p> Line 244  is a defined term.</p>
244    
245  <dl>  <dl>
246  <dt id="ref-HTML5">HTML5</dt>  <dt id="ref-HTML5">HTML5</dt>
247    <dd class="ed">WA1</dd>    <dd><a href="http://www.whatwg.org/specs/web-apps/current-work/"><cite>Web
248      Applications 1.0</cite></a>,
249      <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
250      Working Draft.  Work in progress.  Latest version of the specification
251      is referenced.</dd>
252  <dt id="ref-IRI">IRI</dt>  <dt id="ref-IRI">IRI</dt>
253    <dd class="ed">RFC 3987</dd>    <dd class="ed">RFC 3987.  The exact version of the specification
254      is referenced.</dd>
255    <dt id="ref-KEYWORDS">KEYWORDS</dt>
256      <dd class="ed">RFC 2119.  The exact version of the specification
257      is referenced.</dd>
258  </dl>  </dl>
259  </div>  </div>
260    
# Line 188  is a defined term.</p> Line 266  is a defined term.</p>
266    <dd class="ed">...</dd>    <dd class="ed">...</dd>
267  <dt id="ref-ATOMAUTODISCOVERY">ATOMAUTODISCOVERY</dt>  <dt id="ref-ATOMAUTODISCOVERY">ATOMAUTODISCOVERY</dt>
268    <dd class="ed">I-D</dd>    <dd class="ed">I-D</dd>
269    <dt id="ref-COMMENTAPI">COMMENTAPI</dt>
270      <dd><cite><a href="http://wellformedweb.org/story/9"
271          >The Comment API</a></cite>,
272      <cite>The Well-Formed Web</cite>, BitWorking, Inc,
273      <time title="2003-01-17">17 January 2003</time>.</dd>
274  <dt id="ref-FEEDAUTODISCOVERY">FEEDAUTODISCOVERY</dt>  <dt id="ref-FEEDAUTODISCOVERY">FEEDAUTODISCOVERY</dt>
275    <dd class="ed">wiki</dd>    <dd class="ed">wiki</dd>
276  <dt id="ref-FOAFAUTODISCOVERY">FOAFAUTODISCOVERY</dt>  <dt id="ref-FOAFAUTODISCOVERY">FOAFAUTODISCOVERY</dt>
277    <dd class="ed">...</dd>    <dd class="ed">...</dd>
278  <dt id="ref-MOBILEAUTODISCOVERY">MOBILEAUTODISCOVERY</dt>  <dt id="ref-MOBILEAUTODISCOVERY">MOBILEAUTODISCOVERY</dt>
279    <dd class="ed">...</dd>    <dd class="ed">...</dd>
280    <dt id="ref-OPMLAUTO">OPMLAUTO</dt>
281      <dd><cite><a href="http://www.cleverclogs.org/2006/10/opml_autodiscov.html"
282          >OPML Auto-discovery Bookmarklet</a></cite>,
283      <cite>CleverClogs</cite>, Marjolein Hoekstra, 15 October 2006.</dd>
284  <dt id="ref-PINGBACK">PINGBACK</dt>  <dt id="ref-PINGBACK">PINGBACK</dt>
285    <dd class="ed">...</dd>    <dd class="ed">...</dd>
286  <dt id="ref-RSSAUTODISCOVERY">RSSAUTODISCOVERY</dt>  <dt id="ref-RSSAUTO">RSSAUTO</dt>
287    <dd class="ed">...</dd>    <dd><cite><a
288          href="http://diveintomark.org/archives/2002/05/30/rss_autodiscovery"
289          >RSS auto-discovery</a></cite>,
290      <cite>dive into mark</cite>, Mark Pilgrim, 30 May 2002.</dd>
291      <dd><cite><a
292          href="http://diveintomark.org/archives/2002/06/02/important_change_to_the_link_tag"
293          >Important change to the LINK tag</a></cite>,
294      <cite>dive into mark</cite>, Mark Pilgrim, 2 June 2002.</dd>
295  <dt id="ref-TRACKBACK">TRACKBACK</dt>  <dt id="ref-TRACKBACK">TRACKBACK</dt>
296      <dd>Six Apart, <cite><a    <dd><cite><a
297          href="http://www.sixapart.com/pronet/docs/trackback_spec"        href="http://www.sixapart.com/pronet/docs/trackback_spec"
298          >TrackBack Technical Specification</a></cite>,        >TrackBack Technical Specification</a></cite>,
299      Version 1.2, 1 August 2004.</dd>    Six Apart, Version 1.2, 1 August 2004.</dd>
300  <dt id="ref-WIDGETS">WIDGETS</dt>  <dt id="ref-WIDGETS">WIDGETS</dt>
301    <dd class="ed">...</dd>    <dd class="ed">...</dd>
302    <dt id="ref-XMLID">XMLID</dt>
303      <dd class="ed">xml:id</dd>
304  </dl>  </dl>
305  </div>  </div>
306    
Legend:
Removed from v.1.1  
changed lines
  Added in v.1.3
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24