Download and Installation of TracNav

For the impatient

Use "easy_install TracNav" to install the latest release or "easy_install TracNav==dev" for the development version.

Development version

• Trac browser
• anonymous SVN

You can install the development version using easy_install with the above SVN url.

Current released version: TracNav Plugin for Trac 0.11.x

This version works with version 0.11 of Trac. It is available here (version 4.1):

• Source: ZIP archive​
• Binary: Python 2.5 egg​

Note: This version will not work with Trac 0.10! Use the previous version instead (see below).

Previous version: TracNav Plugin for Trac 0.9 and 0.10

TracNav is no longer implemented as a macro, but as a Trac plugin. This makes installation even more easy: Simply drop the Python egg into the plugin subdir of your project.
Note: This requires Trac >= 0.9 and setuptools >= 0.6! The pre-packaged egg is for Python 2.4. The source code is available, so you can build your own egg. The version number is 3.92.

• Source: Trac browser, anonymous SVN, ZIP archive​
• Binary: Python 2.4 egg​

For more information about Trac plugins, see ​http://projects.edgewall.com/trac/wiki/TracPlugins.

Old version: TracNav Macro

Per-project installation

To install TracNav, place the file TracNav.py​ in the wiki-macros subdirectory and the file tracnav.css​ file in the htdocs subdirectory of your Trac project.

Then add this line

@import url(<?cs var:chrome.href ?>/site/tracnav.css);

to the templates/site_css.cs file of your Trac project.

The tracnav.css file defines the styles for displaying the navigation bar. These styles build upon the styles for TracGuideToc that come with your Trac distribution. If you just install the macro but miss to install the style file, TracNav will work but look somewhat strange.

Global installation

Place the file TracNav.py​ in the wiki-macros subdirectory of your Trac installation (typically /usr/share/trac/wiki-macros) and add the contents of the style file​ to the wiki.css of your Trac installation (typically /usr/share/trac/htdocs/css/wiki.css).

MacroBazaar

The TracNav macro can also be downloaded from the ​MacroBazaar at the home page of ​Trac.