Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

TracNav-4.3.tar.gz (13.6 kB view details)

Uploaded Source

Built Distribution

TracNav-4.3-py2.py3-none-any.whl (15.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file TracNav-4.3.tar.gz.

File metadata

  • Download URL: TracNav-4.3.tar.gz
  • Upload date:
  • Size: 13.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.24.0 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.1

File hashes

Hashes for TracNav-4.3.tar.gz
Algorithm Hash digest
SHA256 2db1eee52e87a0cf0efeb4008460aabc020274045d194d2060ab1a562c02eec5
MD5 52f54359563cac5dbf2ea846cdaa094a
BLAKE2b-256 26b85b3c9fceb45dbea5056fee2410546dd4e90a9f5c40250a7874d21a491880

See more details on using hashes here.

File details

Details for the file TracNav-4.3-py2.py3-none-any.whl.

File metadata

  • Download URL: TracNav-4.3-py2.py3-none-any.whl
  • Upload date:
  • Size: 15.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.24.0 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.1

File hashes

Hashes for TracNav-4.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 db3052a5cda7acdb0e2666e256cec591659f6068ba7da440302f04be12632da5
MD5 9b7243053e6dd98b3da64749ac39e60f
BLAKE2b-256 3e9fc1ec72e435e6f917e7ac9387df3fd0f6ed1212d1ac5995e9e89ca319d9f9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page