Editing Template:Compact TOC/doc (section)

==Usage==
===Features===
* This template '''replaces''' the regular Table of Contents functionality. If you want a regular Table of Contents on a page where {{tl|Compact TOC}} is in use, use <code><nowiki>__FORCETOC__</nowiki></code> or <code><nowiki>__TOC__</nowiki></code> as explained at [[HELP:TOC]].
* The compact format goes sideways: A B C D E F G H I J K L ....
* The centering or numbers are optional: center=yes, num=yes.
* The "Contents" heading can go on top (default) or the side (side=yes).
* Letter ranges can be set (''see below:'' [[#Letters]]): A B C–F G H–K L...
* Some letters can be omitted, instead of 26 separate letters.
* Other headers can be listed in the TOC (''see below:'' [[#Listing custom headers|#Listing custom headers]]).
** Set upper headers before "ABCDEF" by pre1, pre2, ... pre12.
** Set lower headers after "ABCDEF" by custom1, custom2, ... custom12.
* Conceal subheader link-text as "pre1name" over "pre1link" and "custom1name" over "custom1link" etc.
* Other options include: top=yes, seealso=yes, refs=yes, extlinks=yes, etc.

===Syntax===
; Typical use : <nowiki>{{Compact TOC |symnum=yes}}</nowiki>
; Alphabetic (i.e. "A", "B", … "Z") links only : <nowiki>{{Compact TOC}}</nowiki>
; Common applications : <nowiki>{{Compact TOC |center=yes |seealso=yes|refs=yes|further=yes}}</nowiki>

===Full blank syntax===
<syntaxhighlight lang="wikitext">
{{Compact TOC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre12=|pre12name=|pre12link=
 |prebreak=<!--yes-->

 |num= |sym= |symnum=
 |letters=

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom12=|custom12name=|custom12link=

 |nobreak=
 |seealso= |refs= |notesfirst=|notes= |further= |extlinks=
 |a=|b= <!--(etc, until:)--> |z=
}}
</syntaxhighlight>

===Parameters===
* <code>name=</code>: change the heading to an alternative name instead of "Contents", or hide it completely by entering <code>name=no</code>
* <code>side=yes</code>: put the "Contents" heading on the left side with a colon, instead of the top without one
* <code>center=yes</code>: float TOC centered in the horizontal middle of the page, instead of floated left
* <code>right=yes</code>: align the TOC horizontally to the right of the page (may require <code><nowiki><br style="clear:right;" /></nowiki></code> after it, depending on page layout), instead of floated left (this parameter is mutually exclusive with the "center" option above, and should be used sparingly and with good reason)
* <code>nobreak=yes</code>: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use <code>side=</code> for that)
* <code>top=yes</code>: enable the "Top" link; this is only useful if this copy of the TOC is a secondary TOC not at the top of the page, e.g. in the middle of a long glossary. (Every rendered page has a hidden <code><nowiki><a name="top" id="top"></a></nowiki></code> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
* <code>num=yes</code>: enable the "0–9" link for numeric entries section (create a heading of <code><nowiki>==0&amp;ndash;9==</nowiki></code> for the link to work)
* <code>sym=yes</code>: enable the "!$@" link for symbolic entries section
* <code>symnum=yes</code>: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of <code><nowiki>==!&amp;ndash;9==</nowiki></code> for the link to work)
* <code>letters=no</code>: suppresses the "A", "B", ..., "Z" entries.
<!-- ------------------------------- Parameters pre1..pre8 -->
* <code>pre1</code> to <code>pre12</code>: list up to 12 extra section headers ''before'' (pre-list) the "ABCDEF" list. These appear as <nowiki>[[#pre1|pre1]]</nowiki>.
* <code>pre1name</code> to <code>pre12name</code>: modifies the way the pre-list section headers appear: <nowiki>[[#pre1|pre1name]]</nowiki>
* <code>pre1link</code> to <code>pre12link</code>: modifies the targets of the pre-list headers: <nowiki>[[pre1link|pre1]]</nowiki>.
* <code>prebreak=yes</code>: set break-line after all pre-list headers
<!-- ------------------------------- Parameters custom1..12 -->
* <code>custom1</code> to <code>custom12</code>: add up to 12 extra "custom" sections after the "ABCDEF" list. These appear as <nowiki>[[#custom1|custom1]]</nowiki>.
* <code>custom1name</code> to <code>custom12name</code>: modifies the way the custom section headers appear: <nowiki>[[#custom1|custom1name]]</nowiki>
* <code>custom1link</code> to <code>custom12link</code>: modifies the targets of the custom sections: <nowiki>[[custom1link|custom1]]</nowiki>. Use this only for linking to another page.  ''Use sparingly!'' About the only legitimate use for this is connecting the sub-pages of multi-page articles, like long lists that have been broken up. Do not repurpose the TOC as a makeshift navbox.
<!-- ------------------------- Parameters seealso, refs...-->
* <code>seealso=yes</code>: enable link to the "See also" section
* <code>notesfirst=yes</code>: enable link to the "Notes" section, but placed before "References"; ''do not use with <code>notes</code>'' (and do observe that it is plural)
* <code>refs=yes</code>: enable link to the "References" section (observe that it is plural)
* <code>notes=yes</code>: enable link to the "Notes" section (observe that it is plural)
* <code>further=yes</code>: enable link to the "Further reading" section
* <code>extlinks=yes</code>: enable link to the "External links" section
* <code>a=</code> through <code>z=</code>: individually disable particular letters that have no entries. ''Use with caution'' and check regularly to make sure that new entries do not require the removal of these parameters. Can also be used to create range links, e.g. "X-Z". ''(See following section for more detailed documentation of this feature.)''
** The equivalent of this for numbers is <code>0-9=</code> - note this is a hyphen and not a dash (the heading uses a dash)
* <code>allowtoc=yes</code>: disables the hiding of the automatically-generated table of contents that <code><nowiki>__NOTOC__</nowiki></code> usually hides. (Since this template's purpose is usually to ''replace the existing table of contents'', this functionality is usually only necessary on Wikipedia guideline pages that use this template in examples.)