README

= Navigation Tags

Provides hierarchical tree navigation based on Radiant's site structure. Outputs navigation in the form of a -very flexible and CSS'able- unordered list.

== Usage

  <r:nav [root="/"] [depth="2"] [expand_all="true"] [ids_for_lis="true"] [ids_for_links="true"] [append_urls=".."] [prepend_urls=".."]/>

  Given this directory tree: 

   * Home
   ** About
   *** Contact us
   ** Blog
   *** First Article
   *** Second Article
   ** Catalog

  <r:nav /> would output a navigation list like: 

  <ul>
    <li class="parent_of_current has_children"><a href="/about/">About</a>
      <ul>
        <li class="current"><a href="/about/contact">Contact Us</a></li>
      </ul>
    </li>
    <li class="has_children"><a href="/blog/">Blog</a></li>
    <li class="has_children"><a href="/catalogue">Catalogue</a></li>
  </ul>

  == Available tag attributes:

  * ids_for_lis: 	  defaults to false, 			enable this to give each li an id
  * ids_for_links: 	defaults to false, 			enable this to give each a unique id
  * root: 		      defaults to "/", 	      which page to start building the navigation from
  * depth: 		      defaults to 2,				  which will print out the first two levels of pages.
  * expand_all: 	  defaults to false, 			enable this to have all li's create sub-ul's of their children, i.o. only the currently active li
  * prepend_urls:   defaults to none        allows to add certain pages at the top of the list
  * qppend_urls:    defaults to none        allows to add certain pages at the bottom of the list
  * id, class, monkeyballs, ... 	          will be used as html attributes for the ul

= CREDITS

* Ryan Heneise
* Marty Haught
* Benny Degezelle