rel-directory

From Microformats

[edit]

rel-directory

Table of contents

1 rel-directory

1.1 Draft Specification 2005-08-24

1.1.1 Acknowledgments
1.1.2 Copyright
1.1.3 Patents

1.2 Abstract
1.3 Scope
1.4 XMDP profile
1.5 Implementations
1.6 References

1.6.1 Normative References
1.6.2 Informative References
1.6.3 Commentary

1.7 See also

[edit]

Draft Specification 2005-08-24

Editor: Ryan King (http://theryanking.com)

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

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

[edit]

Acknowledgments

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

[edit]

Copyright

This specification is (C) 2005-2008 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 (http://gmpg.org/), IETF (http://ietf.org/), and/or W3C (http://w3.org). Anyone wishing to contribute should read their copyright principles, policies and licenses (e.g. the GMPG Principles (http://gmpg.org/principles)) and agree to them, including licensing of all contributions under all required licenses (e.g. CC-by 1.0 (http://creativecommons.org/licenses/by/1.0/) and later), before contributing.

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.

[edit]

Patents

This specification is subject to a royalty free patent policy, e.g. per the W3C Patent Policy (http://www.w3.org/Consortium/Patent-Policy-20040205/), and IETF RFC3667 (http://www.ietf.org/rfc/rfc3667.txt) & RFC3668 (http://www.ietf.org/rfc/rfc3668.txt).

[edit]

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.

[edit]

Scope

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

[edit]

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>

[edit]

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.

Technorati Blog Finder (http://technorati.com/blogs/) 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 Technorati Blog Finder Help (http://technorati.com/help/blogfinder.html) for more info.

[edit]