View source for rel-directory

<entry-title>rel-directory</entry-title>
{{DraftSpecification}}
__TOC__
== Draft Specification 2005-08-24 ==
;Editor
:[http://theryanking.com Ryan King]

;Author
: Blaine Cook ([http://odeo.com Odeo])
: [http://theryanking.com Ryan King] ([http://technorati.com Technorati])

; Concept
: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati])
: [http://epeus.blogspot.com/ Kevin Marks] ([http://technorati.com Technorati])

=== Acknowledgments ===
Thanks to everyone who helped with brainstorming and feedback: Dorion Carroll, [http://www.joshkinberg.com/blog/ Josh Kinberg], [http://factoryjoe.com/blog/ Chris Messina], [http://anarchogeek.com/ Evan Henshaw Plath (Rabble)], [http://powazek.com/ Derek Powazek], Dr. Ernie Prabhakar, [http://sifry.com/alerts/ David Sifry], [http://www.hyperorg.com/blogger/ David Weinberger], and many others.

=== Copyright ===
{{MicroFormatCopyrightStatement2005}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
** When all authors/editors have done so, we can remove the MicroFormatCopyrightStatement template reference and replace it with the MicroFormatPublicDomainContributionStatement.

=== Patents ===
{{MicroFormatPatentStatement}}

== Abstract ==
Rel-Directory is one of several [[microformats]].  By adding '<code>directory</code>' to the <code>rel</code> attribute of a hyperlink, a page indicates that the destination of the hyperlink is a directory listing containing an entry for the current page.

<pre><nowiki><a rel="directory" href="http://dmoz.org/Computers/Internet/">Computers/Internet</a></nowiki></pre>

the author indicates that the page <code>http://dmoz.org/Computers/Internet/</code> is a directory listing for the referring page.

This assertion will typically apply to just the referring page, though it may in some cases refer to a larger work, such as a blog or podcast.

Additionally, in the case that the directory page is a taggable url (follows the [[rel-tag]] microformat), these

<pre><nowiki>
<a rel="tag directory" href="http://odeo.com/tag/arts/">arts</a>
<a rel="tag directory" href="http://technorati.com/blogs/evolution">evolution</a>
</nowiki></pre>

can be used to show that the referred page is both a directory listing and a tag for the current page.

== Scope ==
[[rel-directory]] is  specifically designed for building a directory in a distributed manner and for making links to any directory listing explicit.

== XMDP profile ==
<pre><nowiki>
<dl class="profile">
 <dt id="rel">rel</dt>
 <dd><p>
   <a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
     HTML4 definition of the 'rel' attribute.</a>  
   Here is an additional value.</p>
  <dl>
   <dt id="directory">directory</dt>
   <dd>Indicates that the referred resource serves as a directory listing for the referring page.</dd>
  </dl>
 </dd>
</dl>
</nowiki></pre>


== Implementations ==
This section is '''informative'''.  The following implementations have been developed which either generate or parse rel-directory links. If you have a rel-directory implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* [http://technorati.com/blogs/ Technorati Blog Finder] is a blog directory that is organized and constructed by bloggers who themselves choose which categories their blog belongs in, using either a user interface, or by simply using a rel-directory tag link from their blog to the page for a particular category in a directory.  See [http://technorati.com/help/blogfinder.html Technorati Blog Finder Help] for more info.

== References ==
=== Normative References ===
* [http://www.w3.org/TR/REC-html40/ HTML 4]
* [http://www.w3.org/TR/xhtml1/ XHTML]
* [http://gmpg.org/xmdp/ XMDP]
* [[rel-tag| Rel-Tag]]
* [http://www.ietf.org/rfc/rfc3986.txt <nowiki>RFC 3986</nowiki> specifies URL syntax]

=== Informative References ===
* This document was originally cloned from the [[rel-tag]] specification.
* [[directory-inclusion-examples]]
* [[directory-inclusion-formats]]
* [[directory-inclusion-brainstorming]]

=== Commentary ===
* http://www.aef-dmoz.org/blog/index.php/2005/09/07/39-rel-directory-rel-tag-directory

==See also==
{{rel-related-pages}}

[[Category:Draft Specifications]]
[[Category:rel-directory]]