rel-directory

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.

Contents

Draft Specification 2005-08-24

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

Acknowledgments

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.

Copyright

This specification is (C) 2005-2014 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.

Patents

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

Abstract

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="http://dmoz.org/Computers/Internet/">Computers/Internet</a>

the author indicates that the page http://dmoz.org/Computers/Internet/ 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="http://odeo.com/tag/arts/">arts</a>
<a rel="tag directory" href="http://technorati.com/blogs/evolution">evolution</a>

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

<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>


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.

References

Normative References

Informative References

Commentary

See also

Categories

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

Views