= Macro for listing sibling wiki pages =

== Description ==

This plugin adds a {{{[[SiblingNav]]}}} wiki macro resulting in a listing of the wiki path leading to the current page and a list of sibling pages. This is only useful for a hierarchic wiki structure, e.g. {{{Meetings/20080304}}} is a subpage of {{{Meetings}}}. This plugin does the right thing for both top pages and subpages.

The output is modeled after the standard trac navigation and some other plugins, i.e. it uses the {{{wiki-toc}}} class on the surrounding {{{<div>}}}, so it should show up as a familiar navigation pane.

See also my [http://uwstopia.nl/blog/2008/03/trac-sibling-nav-plugin announcement blog post for the Sibling Nav plugin].

== Feedback == 

If you have any questions, issues or patches, please contact me via e-mail: [mailto:uws+trackhacks@xs4all.nl]. I don't read TracHacks tickets, sorry.


== Download Source ==

I don't use the Track Hacks SVN repository. The plugin is available from my Bazaar branch at [http://uwstopia.nl/geek/projects/trac/SiblingNav.uws/]. You can {{{bzr branch}}} that url or just download the appropriate file to your plugin directory.


== Example ==

Simple usage for the current page: {{{[[SiblingNav]]}}}

For a navigation list for a different page prefix, use {{{[[SiblingNav(PagePrefix)]]}}}.

Example output in ascii art for a bunch of pages in the {{{Meetings/}}} hierarchy:

{{{
Meetings
========
20080301
20080304
20080307
}}}


== Author/Contributors ==

'''Author:''' [wiki:WouterBolsterlee]