Template:TOC/doc
 | This is a documentation subpage for Template:TOC. It contains usage information, categories and other content that is not part of the original Template page. |
 | This template uses TemplateStyles: |
Tables of contents contain links to sections within an article, providing easy and automatic on-page navigation.
Template for changing the way the table of contents is rendered.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Heading level limit | limit | How many heading levels to show in the table of contents. The lower, the fewer headings are shown. Note that in articles, the main level for headings starts at 2 (the article title is H1, so limit=1 would generally show no headings at all).
| Number | optional |
| Alignment | align | Whether to align the table of contents to the "right" or "left". The default is left.
| String | optional |
Standard Tables of Contents
Articles will include a default table of contents when more than three section headings appear. The default table of contents will include all section headings and will appear just before the first section heading. By default, the table of contents will be left aligned.
You may hide an individual table of contents when viewing an article by clicking the "hide" link in the table. Alternately, if you do not wish to see any tables of contents, you may deactivate their display entirely within the Misc tab of your user preferences. Simply uncheck the box next to "Show table of contents (for pages with more than 3 headings)" and no tables of contents will be displayed.
Modifying the Table of Contents
Several magic words and templates exist which modify the standard tables of contents.
Removing the Table of Contents from an article
To remove the table of contents from any article, simply add the magic word __NOTOC__ anywhere within the article. It's usually not advisable to do so, unless you are manually providing an alternative table of contents, but in some cases it may make the page more usable (e.g. on your main page, or on a page that just contains a list of links and is therefore already a TOC, of sorts).
Forcing and Moving the Table of Contents
To force the table of contents to appear regardless of how many headings an article has, simply add the magic word __TOC__ anywhere within the article. The table of contents will appear wherever you place the template, allowing you to move it up or down the page from its normal position.
Changing the alignment of the table of contents
To force the table of contents to appear on the right of a page, use the {{tocright}} template. The table of contents will appear wherever you place the template.
To force the table of contents to float on the left of a page, use the {{tocleft}} template. The table of contents will appear wherever you place the template. Note that the text of the page will wrap around a floated table of contents, whereas the standard table does not allow text to appear to the right of the table and instead creates whitespace.
Limiting the headings listed in a table of contents
Section headings create a hierarchy. In this page's table of contents, note how Section 2, "Modifying the Table of Contents", contains several subsections. These subsections could also contain subsections of their own.
It's possible to limit the depth of headings which are included in the table using the {{toclimit}} template. By setting a number value for |limit=, only headings of the specified level or greater will display. For example, {{toclimit|limit=2}} will include only level two headings (==Heading==), while {{toclimit|limit=3}} will include level three headings (===Heading===) as well as level two headings, and so on.
Like the other TOC templates, {{toclimit}} will cause the table to appear wherever the template is placed on the page. Additionally, both {{tocleft}} and {{tocright}} support the use of the |limit variable.
