1 Date: Wed, 4 May 2011 17:46:02 +0000
2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
4 Content-Type: application/x-phpwiki;
5 pagename=Help%2FCreateTocPlugin;
6 flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
9 Content-Transfer-Encoding: binary
11 The **~CreateToc** [[Help:WikiPlugin|plugin]] allows to create a dynamical **Table of Contents** of all headers. It also allows to number the headers in the page.
13 The headers might be in classic Phpwiki syntax or in Wikicreole/Mediawiki syntax (see below).
15 The Table of Contents can easily be inserted by clicking on the TOC button in the Edit toolbar.
19 <<CreateToc arguments>>
31 | Provide a button to hide/display the Table of Contents
35 | Style of first level numbering: //number//, //letter// or //roman//.
39 | Which headers to include. See below.
47 | Boolean if the Table of Contents should be initially hidden and on click expanded.
51 | List style: //dl// or //ol// or //ul//. Using //ol// is equivalent to //with_counter=1//.
55 | Boolean if the Table of Contents header should be omitted.
59 | Boolean if the Table of Contents should no be displayed (headers are numbered).
63 | Table of Contents of which page?
67 | Where to display the Table of Contents: //full//, //left// or //right//.
75 | Width of Table of Contents (if position is //left// or //right//)
79 | Boolean if hierarchical prefixes should be added.
83 | Boolean if headers should link back to the Table of Contents.
89 Syntax: a comma-separated list of levels. !!!,!!,! also allowed
95 ! Wikicreole/Mediawiki syntax
98 | 1 || ~!~!~! || ~=~= || h2
100 | 2 || ~!~! || ~=~=~= || h3
102 | 3 || ~! || ~=~=~=~= || h4
104 | 4 || //None// || ~=~=~=~=~= || h5
106 | 5 || //None// || ~=~=~=~=~=~= || h6
111 === Default values ===
116 === Only two levels of headers ===
118 <<CreateToc headers=1,2>>
121 === Table of Contents with hierarchical numbering ===
123 <<CreateToc with_counter=1>>
126 === No Table of Contents, but headers are numbered ===
128 <<CreateToc notoc=1>>
131 === Table of Contents with hierarchical numbering, first level in roman ===
133 <<CreateToc with_counter=1 firstlevelstyle=roman>>
137 * [[PhpWikiDemo:en/TextFormattingRules]]
141 * If you include pages via [[Help:TemplatePlugin|Template]] or [[Help:IncludePagePlugin|IncludePage]] plugins, the Table of Contents will not contain the headers of the included pages.
142 * The Table of Contents will be incorrect if a header contains:
143 ** a [[Help:TemplatePlugin|Template]] plugin call via ~{~{ ~}~},
146 * If you preview the page, the Table of Contents will not be correct if you modified headers. The Table of Contents will be taken from the last saved revision.
150 [[PhpWikiDocumentation]] [[CategoryWikiPlugin]]