{deck:id=TOC|width=907px}
{card:label=Overview}
This macro generates a Table of Contents for the current page based on its headings.
h4. Table of Contents Plugin
* *toc* - Generates a table of contents based on what headings are present in the current page.
* *toc-zone* - Lists all the headings within the macro's body.
{card}
{card:label=Documentation}
{deck:id=TOCm}
{card:label=toc}
Generates a table of contents based on what headings are present in the current page.
h3. The Code
{code}
{toc}
{code}
h3. {toggle-cloak:id=1} Result
{cloak:id=1}
{toc}
{cloak}
h3. {toggle-cloak:id=2} Parameters
{cloak:id=2}
||*Name*||*Required?*||*Default*||*Description*||
|type|(x)|list|The type of TOC to output. May be 'list' or 'flat'. |
|outlne|(x)|false|If true each item will be prefixed by a hierarchical number (e.g. '1.3'). |
|style|(x)|none| The style of bullet-point to use for each item. Any CSS styles are valid.|
|separator|(x)|brackets|The type of separator when in 'flat' mode. May be any of the following: *brackets*, *braces*. *parentheses* (parens), etc.|
|indent|(x)| |When displayed as a 'list', the amount to indent each heading level. Note: This is a CSS quantity, so make sure you use the quantity type (eg. '10px' not '10'). |
|minLevel|(x)|1|The minimum level to report headings for, inclusive. Eg. '2' will list 'h2.' and 'h3.' headings, but not 'h1.'.|
|maxLevel|(x)|7|The maximum level to report headings for, inclusive. Eg. '2' will list 'h1.' and 'h2.' headings, but not 'h3.' or above.|
|include|(x)| |If set, any headings not matching the regular expression will be ignored. |
|exclude|(x)| |If set, any headings which do match the regular expression will be ignored. |
|name|(x)| |Parameter description goes here. |
|printable|(x)|true|If set to false, the TOC will not be visible when printing. |
|class|(x)| |If specified, a <div> surrounding the TOC will be output with the specified 'class' attribute. Use CSS styles to customize the look of the TOC.|
{cloak}
{card}
{card:label=toc-zone}
Allows you to split a table of contents based on the headings of the current page. By default, the macro will also display links to headings both above and below the content which it contains.
h3. The Code
{code}
{toc-zone}
h4. Heading 1
Some Content.
h4. Heading 2
More content.
h4. Heading 3
Some more content.
{toc-zone}
{code}
h3. {toggle-cloak:id=3} Result
{cloak:id=3}
{cloak}
h3. {toggle-cloak:id=4} Parameters
{cloak:id=4}
||*Name*||*Required?*||*Default*||*Description*||
{cloak}
{card}
{deck}
{card}
{deck}
{roundrect:bgcolor=#828282|width=909px|height=50px|corners=false,false,true,true}
{roundrect}
|