Tags:
classification1Add my vote for this tag navigation1Add my vote for this tag create new tag
, view all tags

Index Gen Add-On

To see the results of this example please look at the navigation bar on the left of this page : http://www.flossmanuals.net/audacity (more on this example below).

This plugin is designed so you can quickly make an navigation 'bar' of topics in a web.

With this Addon and customised skins you can make 'websites' from any TWiki web. It was originally designed to make the creation of published online manuals easy, allowing you to choose topics from a web to include in manual, then place headings to separate groups of chapters, make the chapter topics readable (non-wiki words), and then use a skin that includes the index you just created. Although the process is developed for online manuals it may be suitable for any number of outputs requiring a typical website navigation bar.

It uses an easy drag and drop method to generate an 'index' (a topic called _index) which can be included in templates. Names of each link can be defined separately to the topic name to make for nice non-wikiname navigation.

Originally made for http://www.flossmanuals.net.

Usage

Set the format of the link to be made in the WebPreferences of the web you are working on. To do this set the

INDEXGENURL
variable to something like:

      *  INDEXGENURL=/bin/view/%WEB%/%TOPIC%

This would generate links in the navbar similar to this:

<li><a href="/bin/view/Audacity/Introduction">INTRODUCTION</a></li>

Alternatively you could use IndexGenAddOn in combination with a publishing plugin and reference and html file like so:

      *  INDEXGENURL=/publish/%WEB%/%TOPIC%.html

This would generate links in the navbar similar to this :

<li><a href="/publish/Audacity/Introduction.html">INTRODUCTION</a></li>

Once that is done go to

http://[your url]/bin/arrange/$web

Drag and drop the topics from the selected web onto the bar on the right you can arrange them in the order you like. Double click on the topic names to change the text of the link. Separators (Headings) can be made by clicking on the '---' text.

When you have finished, press 'save' and a new topic is created (_index) on the web you are working on. If you then use an

%INCLUDE{_index}%
statement in a template the navbar will show at the appropriate place.

For best results use css to define the look and feel of the navigation bar.

The css tags look something like this (using the Audacity example):

<li class="title">AUDACITY</li>
<li><a href="/Audacity/Introduction">INTRODUCTION</a></li>
<li><a href="/Audacity/DigitalAudio">WHAT IS DIGITAL AUDIO?</a></li>
<li class="heading">INSTALLING</li>
<li><a href="/Audacity/InstallingUbuntu">UBUNTU</a></li>
<li><a href="/Audacity/InstallingOSX">OSX</a></li>

General Configuration

The following table shows the various configuration variables and their meaning. The first column shows the variable to use if using a TWiki preference variable (i.e. Set VARIABLE = ). The third column gives the default value if TWiki preference variable is not used.

Twiki Preference Variable Default Value Example Explanation
INDEXGENIGNORE   WebAtom,WebTopics List of topics we want to ignore.
INDEXGENTEMPLATE indexgen.tmpl   Template
INDEXGENURL      

Add-On Installation Instructions

Note: You do not need to install anything on the browser to use this add-on. The following instructions are for the administrator who installs the add-on on the server where TWiki is running.

  • Download the ZIP file from the Add-on Home (see below)
  • Unzip IndexGenAddOn.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/IndexGenAddOn.txt Add-on topic
    data/TWiki/IndexGenAddOn.txt,v Add-on topic repository
    pub/TWiki/MochiKit/ MochiKit library
    bin/arrange Add-on script

Add-On Info

  • Set SHORTDESCRIPTION = Make a navigation bar for any web with easy drag and drop operations

Add-on Author: TWiki:Main.AleksandarErkalovic
Copyright: © 2006, TWiki:Main.AleksandarErkalovic
License: GPL (GNU General Public License)
Add-on Version: 30 Apr 2007 (V1.000)
Change History:  
30 Apr 2007: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.1 (TWiki 4.0)
CPAN Dependencies: List::Compare::Functional
Other Dependencies: MochiKit
Perl Version: 5.005
Add-on Home: http://TWiki.org/cgi-bin/view/Plugins/IndexGenAddOn
Feedback: http://TWiki.org/cgi-bin/view/Plugins/IndexGenAddOnDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/IndexGenAddOnAppraisal

Related Topic: TWikiAddOns

-- TWiki:Main/AleksandarErkalovic - 30 Apr 2007

Topic attachments
I Attachment History Action Size Date Who Comment
Compressed Zip archivezip IndexGenAddOn.zip r2 r1 manage 94.4 K 2007-05-31 - 07:25 AdamHyde updated IndexGen.pm and plugin info
Edit | Attach | Watch | Print version | History: r6 < r5 < r4 < r3 < r2 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r6 - 2007-05-31 - AdamHyde
 
  • 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-2016 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.