create new tag
, view all tags

Nav Plugin

This plugin allows an author to create a set of TWiki Topic pages that together form a logical, ordered set. This could be a for a presentation/slide-show or sections of a document.

Each document set is composed of a number of individual topics and an "index" topic. To link each of these topics together, a variable named %DOCNAME% is introduced.

Based on the value of %DOCNAME%, NavPlugin finds the name of the "index" topic, and parses the contents of it to determine the respective navigation links. The Index lists the individual pages in the order.

If a document does not have a %DOCNAME% variable defined, the document is displayed without the navigation links.

The NavPlugin uses a simple skin (included with the plugin) for the viewing/navigation. A small JavaScript function is used to determine if the navigation icons should be displayed and to insert the correct hyperlinks.

See NavPluginDev for development discussion.


See the example document set NavPluginExample.

Syntax Rules

Title Page

Start the document set with a hyperlink that forces the page to be viewed with the "nav" skin. You could do this from a Title Page.

   =<a href="NavPluginPageOne?skin=nav">Begin the example</a>=   

Index Page

Every document set needs an index page. The index page must be a valid WikiWord name that ends in Index: < SomeWikiName >Index.

The Index page contains an ordered list of TWiki pages. This list must use the bullet syntax and start with an IndexStart and IndexEnd flag in HTML comments.

   * NavPluginPageOne
   * NavPluginPageTwo
   * NavPluginLastPage

The index page can be a part of the document set by putting the DOCNAME variable in it. Often, this it's useful for the Index page to double as the "Agenda" or "Table of Contents" of the presentation/document.

On each page, identify that it belongs to a document set

Each page in the document set must have the DOCNAME variable defined. It can defined in an HTML comment so that it's not visible, putting the start/end comment delimeters on the line above it and after it.

The DOCNAME should be set to the base document name, such as "NavPlugin." The plugin source code will automatically append "Index" to this name to determine the next/previous/index hyperlinks.

   * Set DOCNAME = SomeWikiName

First and Last Pages

When you are on the first page, the "Previous" simply reloads the first page in the index. When you get to the last page, the "Next" simply reloads the last page. The TOC always takes you to the index page.


When you are viewing with the nav skin, these icons appear at the top of the page

  • prev.gif: Go to previous page in the document set
  • toc.gif: Go to the document set index (i.e. table of contents), identified by DOCNAMEIndex
  • next.gif: Go to the next page in the document set

If you are viewing with the nave skin and you want to "break-out" so that you can edit one of the pages, edit the URL and remove the ?skin=nav parameter.

NavPlugin Settings

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = This plugin allows a user to easily combine different TWiki topics into one logical document that a user can can easily navigate through "navigation" links displayed at the header and footer of each page.

Plugin Installation Instructions

  • Download the ZIP file from the Plugin web (see below)
  • Unzip NavPlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/NavPlugin.txt Plugin topic
    data/TWiki/NavPlugin.txt,v Plugin topic repository
    data/TWiki/NavPluginExample*.txt Example
    lib/TWiki/Plugins/NavPlugin.pm Plugin Perl module
    templates/view.nav.tmpl (skin for navigation)
    pub/Plugins/NavPlugin/*.gif next, previous, and index images for the nav skin
  • Turn on NavPlugin in TWikiPreferences.
  • Test if the plugin is correctly installed, by viewing NavPlugin#NewFunctionalityTest

Known Issues/Limitations

All pages referenced in the index must be in the same web as the index page.

Plugin Info

Plugin Author: MikeBarton, AlbertoBaez
Plugin Version: 30 Jan 2002
Change History: 30 Jan 2002: Initial version
  8 Jul 2003: MikeBarton no longer maintaining this
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.0
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/NavPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/NavPluginDev

Related Topics: TWikiPreferences, TWikiPlugins, DefaultPlugin

-- MikeBarton - 30 Jan 2002

Mike sent me an email saying:

Martin, No plans to continue maintaining the NavPlugin.


-- MartinCleaver - 08 Jul 2003

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 NavPlugin.md5 r2 r1 manage 0.1 K 2008-12-12 - 11:47 SopanShewale checksum file , Uploaded as a part of Release Process
Compressed Zip archivetgz NavPlugin.tgz r2 r1 manage 7.5 K 2008-12-12 - 11:47 SopanShewale See NavPlugin for details. Untar and run the installer script, Uploaded as a part of Release Process
Compressed Zip archivezip NavPlugin.zip r6 r5 r4 r3 r2 manage 11.3 K 2008-12-12 - 11:47 SopanShewale See NavPlugin for details. Unzip and run the installer script , Uploaded as a part of Release Process
Unknown file formatEXT NavPlugin_installer r2 r1 manage 3.7 K 2008-12-12 - 11:47 SopanShewale Installer Script, Uploaded as a part of Release Process
GIFgif next.gif r1 manage 0.2 K 2002-01-30 - 18:34 MikeBarton next icon
GIFgif prev.gif r1 manage 0.2 K 2002-01-30 - 18:34 MikeBarton previous icon
GIFgif toc.gif r1 manage 0.2 K 2002-01-30 - 18:34 MikeBarton table of contents or "index" icon
Edit | Attach | Watch | Print version | History: r9 < r8 < r7 < r6 < r5 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r9 - 2008-12-12 - SopanShewale
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.