The Navigation Bar for Trac
Project description
TracNav Plugin for Trac
Description
The [[TracNav]]
macro implements a fully customizable navigation bar
for the Trac wiki engine. The contents of the navigation bar is a wiki
page itself and can be edited like any other wiki page through the web
interface. The navigation bar supports hierarchical ordering of
topics. The design of TracNav mimics the design of the TracGuideToc
that was originally supplied with Trac. The drawback of TracGuideToc
is that it is not customizable without editing its source code and
that it does not support hierarchical ordering.
Usage
To use TracNav, create an index page for your site and call the TracNav macro on each page, where the navigation bar should be displayed. The index page is a regular wiki page. The page with the table of contents must include an unordered list of links that should be displayed in the navigation bar.
To display the navigation bar on a page, you must call the TracNav macro on that page and pass the name of your table of contents as argument.
It is possible to have more than one index page for your toc: Simply list them all separated by a bar like this:
[[TracNav(MyTOC|AnotherTOC)]]
The TOCs are appended to each other to form one navigation bar.
Installation
See http://trac.edgewall.org/wiki/TracPlugins.
Short version for the impatient: run python ./setup.py bdist_egg
and
copy the resulting .egg
file from the dist
directory to the
plugins
directory of your Trac project. Using the WebAdmin plugin,
you can even upload and deploy the .egg
file to your project using a
browser.
It is very likely that you have to override the location of the
temporary directory to which .egg
files are unpacked by setting the
PYTHON_EGG_CACHE
environment variable in your webserver's
configuration, see
http://trac.edgewall.org/wiki/TracPlugins#SettingupthePluginCache.
Homepage
See https://svn.ipd.kit.edu/trac/javaparty/wiki/TracNav. This page contains a life demo of the plugin, too.
Authors and License
- Copyright 2005-2006, Bernhard Haumacher (haui at haumacher.de)
- Copyright 2005-2021, Thomas Moschny (thomas.moschny at gmx.de)
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for TracNav-4.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | db3052a5cda7acdb0e2666e256cec591659f6068ba7da440302f04be12632da5 |
|
MD5 | 9b7243053e6dd98b3da64749ac39e60f |
|
BLAKE2b-256 | 3e9fc1ec72e435e6f917e7ac9387df3fd0f6ed1212d1ac5995e9e89ca319d9f9 |