org.apache.wiki.plugin

Class TableOfContents

java.lang.Object

org.apache.wiki.plugin.TableOfContents

All Implemented Interfaces:

WikiPlugin, HeadingListener

public class TableOfContents
extends Object
implements WikiPlugin, HeadingListener

Provides a table of contents.

Parameters :

• title - The title of the table of contents.
• numbered - if true, generates automatically numbers for the headings.
• start - If using a numbered list, sets the start number.
• prefix - If using a numbered list, sets the prefix used for the list.

Since:

2.2

Field Summary

Fields

Modifier and Type	Field and Description
static String	PARAM_NUMBERED Parameter name for setting whether the headings should be numbered.
static String	PARAM_PREFIX Parameter name for setting what the prefix for the heading is.
static String	PARAM_START Parameter name for setting where the numbering should start.
static String	PARAM_TITLE Parameter name for setting the title.

Fields inherited from interface org.apache.wiki.api.plugin.WikiPlugin

CORE_PLUGINS_RESOURCEBUNDLE

Constructor Summary

Constructors

Constructor and Description
TableOfContents()

Method Summary

Modifier and Type	Method and Description
String	execute(WikiContext context, Map<String,String> params) This is the main entry point for any plugin.
void	headingAdded(WikiContext context, Heading hd) Is called whenever a heading is encountered in the stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PARAM_TITLE

public static final String PARAM_TITLE

Parameter name for setting the title.

See Also:

Constant Field Values

PARAM_NUMBERED

public static final String PARAM_NUMBERED

Parameter name for setting whether the headings should be numbered.

See Also:

Constant Field Values

PARAM_START

public static final String PARAM_START

Parameter name for setting where the numbering should start.

See Also:

Constant Field Values

PARAM_PREFIX

public static final String PARAM_PREFIX

Parameter name for setting what the prefix for the heading is.

See Also:

Constant Field Values

Constructor Detail

TableOfContents

public TableOfContents()

Method Detail

headingAdded

public void headingAdded(WikiContext context,
                         Heading hd)

Is called whenever a heading is encountered in the stream.

Specified by:

headingAdded in interface HeadingListener

Parameters:

context - The WikiContext

hd - The heading which was just encountered.

execute

public String execute(WikiContext context,
                      Map<String,String> params)
               throws PluginException

This is the main entry point for any plugin. The parameters are parsed, and a special parameter called "_body" signifies the name of the plugin body, i.e. the part of the plugin that is not a parameter of the form "key=value". This has been separated using an empty line.

Note that it is preferred that the plugin returns XHTML-compliant HTML (i.e. close all tags, use <br /> instead of <br>, etc.

Specified by:

execute in interface WikiPlugin

Parameters:

context - The current WikiContext.

params - A Map which contains key-value pairs. Any parameter that the user has specified on the wiki page will contain String-String parameters, but it is possible that at some future date, JSPWiki will give you other things that are not Strings.

Returns:

HTML, ready to be included into the rendered page.

Throws:

PluginException - In case anything goes wrong.