We relaunched the TWiki.org project with an expanded TWiki charter, and we invite you to participate! The TWiki.org Code of Conduct agreement took effect on 27 Oct 2008. We ask existing twiki.org users to opt-in. You need to opt-in to participate in the Blog, Codev, Plugins and TWiki webs. -- PeterThoeny - 27 Oct 2008
You are here: TWiki> Plugins Web>TocPlugin (01 Oct 2008, SanjayGoyal)
Tags:
navigation2Add my vote for this tag create new tag
, view all tags

TocPlugin

Table of contents and cross-reference management.

This plugin adds powerful support for generation and maintenance of tables of contents and cross-references within a TWiki web. Originally developed for use by Motorola documentation teams.

Syntax Rules

Adds a number of new tags:

  • %SECTIONn% - inserts an anchored section header
  • %CONTENTS% - generates a table of contents for a topic or an entire web, with full expansion depth control
  • %REF% - inserts a symbolically named cross-reference URL
  • %ANCHOR% - inserts a symbolically named jump target

The TWiki.TocPluginHelp topic in the installation contains complete help information.

TocPlugin Settings

  • Set SHORTDESCRIPTION = Sophisticated table of contents generation

  • Set DEBUG = 0

Plugin Installation Instructions

  • Download the ZIP file from the Plugin web (see below). Contents:
File: Description:
data/TWiki/TocPlugin.txt Plugin topic
data/TWiki/TocPluginHelp.txt Plugin help
data/TWiki/WebOrder.txt Order topic for TWiki web
lib/TWiki/Plugins/TocPlugin.pm Plugin Perl module
lib/TWiki/Plugins/TocPlugin/Attrs.pm Library component
lib/TWiki/Plugins/TocPlugin/Anchor.pm Library component
lib/TWiki/Plugins/TocPlugin/Section.pm Library component
lib/TWiki/Plugins/TocPlugin/TOC.pm Library component
lib/TWiki/Plugins/TocPlugin/TOCIF.pm Library component
lib/TWiki/Plugins/TocPlugin/TopLevelSection.pm Library component
lib/TWiki/Plugins/TocPlugin/test.zip Test code
lib/TWiki/Plugins/TocPlugin/build.xml Ant build file
  • Unzip TocPlugin.zip in your twiki installation directory.
  • (Dakar) Visit configure in your TWiki installation, and enable the plugin in the {Plugins} section.
  • If you see a link here: %REF{topic=TocPluginHelp,type=Section,name=installation}% then installation was successful
  • Check the TocPluginHelp? topic. You should see expanded section numbers.

Plugin Info

One Line Description: Table of contents and cross-reference management
Plugin Author: TWiki:Main.CrawfordCurrie
Plugin Version: 1.0
Change History: 15 Sep 2001: Initial version
  23 Sep 2001: Directories restructured according to Plugin requirements, and turned into a zip file
  1 Oct 2001: Corrected directory naming (no thanks to WindowsME!)
  20 Apr 2006: Minor doc update, headings no longer marked up as anchor text (TWiki:Main.SteffenPoulsen)
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.0
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/TocPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/TocPluginDev

Related Topics: TWikiPreferences, TWikiPlugins

Copyright

This code is a development of the Architectures and Systems Platforms group of Motorola Inc. and is protected by the following copyrights:

  • Copyright (C) 2002 Motorola. All Rights Reserved.

License

As required for the publication of all extensions to TWiki, this software is published under the terms of the GNU General Public License.

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, published at http://www.gnu.org/copyleft/gpl.html

Topic attachments
I Attachment Action Size Date Who Comment
elsemd5 TocPlugin.md5 manage 0.2 K 20 Apr 2006 - 21:22 SteffenPoulsen md5 checksums
ziptgz TocPlugin.tgz manage 27.8 K 14 Sep 2006 - 08:42 CrawfordCurrie Download, untar and run the installer script for manual install
zipzip TocPlugin.zip manage 38.1 K 14 Sep 2006 - 08:42 CrawfordCurrie Download, unzip and run the installer script for manual install
Topic revision: r17 - 01 Oct 2008 - 13:54:36 - SanjayGoyal
Plugins.TocPlugin moved from Plugins.TOCPlugin on 21 Sep 2001 - 10:02 by PeterThoeny - put it back
 
TWIKI.NET
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback