wiki:NavigationMenuPlugin

Version 2 (modified by Beider, 8 years ago) (diff)

Fixed download links

SubTree Navigation Menu

Description

This is a combination of the SubWiki and TOCMacro plugin/macros. Basically it let's you have subtree browsing in a TracGuideToc menu style. Also allows for some usage of default menus.

Most of the credit goes to the creators of the original hacks. I just combined them into one big ugly hack.

If no parameters are supplied it generates the menu from the current page and any subpages it may have.

    [[TOC]]

To generate subtrees from multiple pages you may pass in something like.

[[TOC(Trac, Wiki)]]

The following control arguments change the default behaviour of the TOC macro:

Argument Meaning
heading=<x> Override the default heading of "Table of Contents"
noheading Suppress display of the heading.
inline Display TOC inline rather than as a side-bar.
defmenu=<x> A default menu. Usefull if you add / remove subtrees often.

Note that the current page must also be specified if individual wiki pages are given in the argument list.

Defmenu usage:

First make a page like:

http://localhost:8000/my-project/wiki/DefaultMenu

Then on this page write a couple of comma separated pages you would like to have listed, just like you would do with normal parameters:

Trac,Wiki

Then add [[TOC(defmenu=DefaultMenu)]] to every page you want the menu on, now instead of having to change every page when you want to change the menu. You can just change the defaultmenu page.

Bugs/Feature Requests

Existing bugs and feature requests for NavigationMenuPlugin are here.

If you have any issues, create a new ticket.

Download

http://trac-hacks.org/attachment/wiki/NavigationMenuPlugin/TracNavigationMenu-1.0-py2.4.egg

Source

http://trac-hacks.org/attachment/wiki/NavigationMenuPlugin/NavigationMenu.rar

Example

Some examples:

[[TOC(defmenu=DefaultMenu)]]

[[TOC(heading=My Heading,Wiki,Trac,defmenu=SomeDefMenuPage)]]

[[TOC]]

[[TOC(RootPageOne,RootPageTwo,RootPageThree)]]

Recent Changes

[1664] by Beider on 2006-12-09 04:52:46
New hack NavigationMenuPlugin, created by Beider

Author/Contributors

Author: Beider?
Contributors:

Attachments (2)

Download all attachments as: .zip