Jump to: navigation, search

This document represents a draft microformat specification. Although drafts are somewhat mature in the development process, the stability of this document cannot be guaranteed, and implementers should be prepared to keep abreast of future developments and changes. Watch this wiki page, or follow discussions on the #microformats Freenode IRC channel to stay up-to-date.


Draft Specification 2005-08-24

Ryan King
Blaine Cook (Odeo)
Ryan King (Technorati)
Tantek Çelik (Technorati)
Kevin Marks (Technorati)


Thanks to everyone who helped with brainstorming and feedback: Dorion Carroll, Josh Kinberg, Chris Messina, Evan Henshaw Plath (Rabble), Derek Powazek, Dr. Ernie Prabhakar, David Sifry, David Weinberger, and many others.


This specification is (C) 2005-2015 by the authors. However, the authors intend to submit this specification to a standards body with a liberal copyright/licensing policy such as the GMPG, IETF, and/or W3C. Anyone wishing to contribute should read their copyright principles, policies and licenses (e.g. the GMPG Principles) and agree to them, including licensing of all contributions under all required licenses (e.g. CC-by 1.0 and later), before contributing.


This specification is subject to a royalty free patent policy, e.g. per the W3C Patent Policy, and IETF RFC3667 & RFC3668.


Rel-Directory is one of several microformats. By adding 'directory' to the rel attribute of a hyperlink, a page indicates that the destination of the hyperlink is a directory listing containing an entry for the current page.

<a rel="directory" href="">Computers/Internet</a>

the author indicates that the page 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

<a rel="tag directory" href="">arts</a>
<a rel="tag directory" href="">evolution</a>

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


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

XMDP profile

<dl class="profile">
 <dt id="rel">rel</dt>
   <a rel="help" href="">
     HTML4 definition of the 'rel' attribute.</a>  
   Here is an additional value.</p>
   <dt id="directory">directory</dt>
   <dd>Indicates that the referred resource serves as a directory listing for the referring page.</dd>


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.


Normative References

Informative References


See also


rel-directory was last modified: Sunday, April 7th, 2013