Difference between revisions of "Template:Compact ToC"

From TnPedia
Jump to navigation Jump to search
(Created page with "{{#if:{{{allowtoc|}}}||__NOTOC__}}<!-- -->{{#ifeq:{{{center|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes | <div style="text-align:center;"><!-- -->}}<!-- Start contents box --><div...")
 
Line 1: Line 1:
{{#if:{{{allowtoc|}}}||__NOTOC__}}<!--
+
{{Documentation subpage}}
-->{{#ifeq:{{{center|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes |
+
{{High-use| 6041 }}
<div style="text-align:center;"><!--
+
{{Intricate template}}
-->}}<!--
+
{{tsh|TOC|Toc}}
 +
<!----Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->
  
Start contents box
+
This is a [[H:TOC|table-of-contents]] replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.
 +
__TOC__
  
--><div role="navigation" {{#if:{{{allowtoc|}}}||id="toc"}} class="toc plainlinks hlist" {{#ifeq:{{{name}}}|no |aria-label="Contents" |aria-labelledby="tocheading"}}
+
== Usage ==
        style="{{#ifeq:{{{center|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes |margin-left:auto;margin-right:auto;
+
=== Features ===
                | {{#ifeq:{{{right}}}|yes |clear:right;float:right;}}
+
* The compact format goes sideways: A B C D E F G H I J K L ....
                }} text-align:{{{align|left}}};">
+
* 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, ... pre8.
 +
** Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
 +
* 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.
  
"[name]/Contents"
+
=== 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>
  
    -->{{#ifeq:{{{name}}}|no |
+
===Full blank syntax===
        |  <div id="toctitle" class="toctitle" style="text-align:center;{{#ifeq:{{{side|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes |display:inline-block;}}"><!--
+
<pre>
              --><span id="tocheading" style="font-weight:bold;">{{{name|{{MediaWiki:Toc}}}}}{{#ifeq:{{{side|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes |&#58;&nbsp;<!--(colon and space)-->}}</span><!--
+
{{Compact ToC
          --></div><!--
+
|side=|center=|right=
    -->}}
+
|name=
<!--
+
|top=
  
  Links
+
  |pre1=|pre1name=|pre1link=
 +
|pre2=|pre2name=|pre2link=
 +
<!--(etc, to:)-->
 +
|pre8=|pre8name=|pre8link=
 +
|prebreak=<!--yes-->
  
    --><div style="margin:auto;white-space:nowrap;{{#ifeq:{{{side|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes |display:inline-block;}}"><!--
+
|num= |sym= |symnum=
            -->{{#ifeq:{{{top}}}|yes |
+
|letters=
* [[#top|Top]]}}<!--
 
            -->{{#if:{{{pre1|{{{preSec1|}}}}}} |
 
* [[{{{pre1link|{{{preSec1link|#{{{pre1|{{{preSec1}}} }}} }}} }}}|{{{pre1name|{{{preSec1name|{{{pre1|{{{preSec1}}} }}} }}} }}}]] <!--
 
            -->}} {{#if:{{{pre2|{{{preSec2|}}}}}} |
 
* [[{{{pre2link|{{{preSec2link|#{{{pre2|{{{preSec2}}} }}} }}} }}}|{{{pre2name|{{{preSec2name|{{{pre2|{{{preSec2}}} }}} }}} }}}]] <!--
 
              -->}} {{#if:{{{pre3|{{{preSec3|}}}}}} |
 
* [[{{{pre3link|{{{preSec3link|#{{{pre3|{{{preSec3}}} }}} }}} }}}|{{{pre3name|{{{preSec3name|{{{pre3|{{{preSec3}}} }}} }}} }}}]] <!--
 
                  -->}} {{#if:{{{pre4|{{{preSec4|}}}}}} |
 
* [[{{{pre4link|{{{preSec4link|#{{{pre4|{{{preSec4}}} }}} }}} }}}|{{{pre4name|{{{preSec4name|{{{pre4|{{{preSec4}}} }}} }}} }}}]] <!--
 
                    -->}} {{#if:{{{pre5|{{{preSec5|}}}}}} |
 
* [[{{{pre5link|{{{preSec5link|#{{{pre5|{{{preSec5}}} }}} }}} }}}|{{{pre5name|{{{preSec5name|{{{pre5|{{{preSec5}}} }}} }}} }}}]] <!--
 
                        -->}} {{#if:{{{pre6|{{{preSec6|}}}}}} |
 
* [[{{{pre6link|{{{preSec6link|#{{{pre6|{{{preSec6}}} }}} }}} }}}|{{{pre6name|{{{preSec6name|{{{pre6|{{{preSec6}}} }}} }}} }}}]] <!--
 
                          -->}} {{#if:{{{pre7|{{{preSec7|}}}}}} |
 
* [[{{{pre7link|{{{preSec7link|#{{{pre7|{{{preSec7}}} }}} }}} }}}|{{{pre7name|{{{preSec7name|{{{pre7|{{{preSec7}}} }}} }}} }}}]] <!--
 
                              -->}} {{#if:{{{pre8|{{{preSec8|}}}}}} |
 
* [[{{{pre8link|{{{preSec8link|#{{{pre8|{{{preSec8}}} }}} }}} }}}|{{{pre8name|{{{preSec8name|{{{pre8|{{{preSec8}}} }}} }}} }}}]] <!--
 
                                -->}} {{#ifeq:{{{prebreak|}}}|yes|<br />
 
  
<nowiki />}} <!--
+
|custom1=|custom1name=|custom1link=
-->{{#ifeq:{{{sym}}}|yes |
+
|custom2=|custom2name=|custom2link=
* [[#!$@{{{2|}}}|!$@]] }}<!--
+
<!--(etc, to:)-->
-->{{#ifeq:{{{num}}}|yes |
+
|custom8=|custom8name=|custom8link=
{{#if:{{{0-9}}}|* {{{0-9|[[#0–9{{{2|}}}|0–9]]}}} }} }}<!--
 
-->{{#ifeq:{{{symnum}}}|yes |
 
* [[#!–9{{{2|}}}|!–9]] }}{{#ifeq:{{{letters}}}|no||
 
{{#if:{{{a}}}|* {{{a|[[#A{{{2|}}}|A]]}}}
 
}}{{#if:{{{b}}}|* {{{b|[[#B{{{2|}}}|B]]}}}
 
}}{{#if:{{{c}}}|* {{{c|[[#C{{{2|}}}|C]]}}}
 
}}{{#if:{{{d}}}|* {{{d|[[#D{{{2|}}}|D]]}}}
 
}}{{#if:{{{e}}}|* {{{e|[[#E{{{2|}}}|E]]}}}
 
}}{{#if:{{{f}}}|* {{{f|[[#F{{{2|}}}|F]]}}}
 
}}{{#if:{{{g}}}|* {{{g|[[#G{{{2|}}}|G]]}}}
 
}}{{#if:{{{h}}}|* {{{h|[[#H{{{2|}}}|H]]}}}
 
}}{{#if:{{{i}}}|* {{{i|[[#I{{{2|}}}|I]]}}}
 
}}{{#if:{{{j}}}|* {{{j|[[#J{{{2|}}}|J]]}}}
 
}}{{#if:{{{k}}}|* {{{k|[[#K{{{2|}}}|K]]}}}
 
}}{{#if:{{{l}}}|* {{{l|[[#L{{{2|}}}|L]]}}}
 
}}{{#if:{{{m}}}|* {{{m|[[#M{{{2|}}}|M]]}}}
 
}}{{#if:{{{n}}}|* {{{n|[[#N{{{2|}}}|N]]}}}
 
}}{{#if:{{{o}}}|* {{{o|[[#O{{{2|}}}|O]]}}}
 
}}{{#if:{{{p}}}|* {{{p|[[#P{{{2|}}}|P]]}}}
 
}}{{#if:{{{q}}}|* {{{q|[[#Q{{{2|}}}|Q]]}}}
 
}}{{#if:{{{r}}}|* {{{r|[[#R{{{2|}}}|R]]}}}
 
}}{{#if:{{{s}}}|* {{{s|[[#S{{{2|}}}|S]]}}}
 
}}{{#if:{{{t}}}|* {{{t|[[#T{{{2|}}}|T]]}}}
 
}}{{#if:{{{u}}}|* {{{u|[[#U{{{2|}}}|U]]}}}
 
}}{{#if:{{{v}}}|* {{{v|[[#V{{{2|}}}|V]]}}}
 
}}{{#if:{{{w}}}|* {{{w|[[#W{{{2|}}}|W]]}}}
 
}}{{#if:{{{x}}}|* {{{x|[[#X{{{2|}}}|X]]}}}
 
}}{{#if:{{{y}}}|* {{{y|[[#Y{{{2|}}}|Y]]}}}
 
}}{{#if:{{{z}}}|* {{{z|[[#Z{{{2|}}}|Z]]}}}
 
}}}} <!--
 
-->{{#ifeq:{{{nobreak|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes | |<nowiki />
 
  
<nowiki />}}<!--
+
|nobreak=
 +
|seealso= |refs= |notesfirst=|notes= |further= |extlinks=
 +
|a=|b= <!--(etc, until:)--> |z=
 +
}}
 +
</pre>
  
  Custom links
+
===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>pre8</code>: list up to 8 extra section headers ''before'' (pre-list) the "ABCDEF" list. These appear as <nowiki>[[#pre1|pre1]]</nowiki>.
 +
* <code>pre1name</code> to <code>pre8name</code>: modifies the way the pre-list section headers appear: <nowiki>[[#pre1|pre1name]]</nowiki>
 +
* <code>pre1link</code> to <code>pre8link</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..8 -->
 +
* <code>custom1</code> to <code>custom8</code>: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as <nowiki>[[#custom1|custom1]]</nowiki>.
 +
* <code>custom1name</code> to <code>custom8name</code>: modifies the way the custom section headers appear: <nowiki>[[#custom1|custom1name]]</nowiki>
 +
* <code>custom1link</code> to <code>custom8link</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.)''
 +
* <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.)
  
-->{{#if:{{{custom1|{{{Sec1|}}}}}} |
+
== Letters ==
* [[{{{custom1link|{{{Sec1link|#{{{custom1|{{{Sec1}}} }}} }}} }}}|{{{custom1name|{{{Sec1name|{{{custom1|{{{Sec1}}} }}} }}} }}}]] <!--
+
Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a ''lowercase'' blank parameter, e.g. {{tlx|Compact ToC&#32;|<nowiki>side=yes |j=|q=</nowiki>}}:
-->}} {{#if:{{{custom2|{{{Sec2|}}}}}} |
+
{| style="margin-left:3.0em"
* [[{{{custom2link|{{{Sec2link|#{{{custom2|{{{Sec2}}} }}} }}} }}}|{{{custom2name|{{{Sec2name|{{{custom2|{{{Sec2}}} }}} }}} }}}]] <!--
+
| {{Compact ToC |side=yes |j=|q=}}
  -->}} {{#if:{{{custom3|{{{Sec3|}}}}}} |
+
|}
* [[{{{custom3link|{{{Sec3link|#{{{custom3|{{{Sec3}}} }}} }}} }}}|{{{custom3name|{{{Sec3name|{{{custom3|{{{Sec3}}} }}} }}} }}}]] <!--
+
Or it can be replaced with an unlinked letter by using that letter (in ''uppercase''), e.g. {{tlx|Compact ToC&#32;|<nowiki>side=yes |j=J|q=Q</nowiki>}}:
      -->}} {{#if:{{{custom4|{{{Sec4|}}}}}} |
+
{| style="margin-left:3.0em"
* [[{{{custom4link|{{{Sec4link|#{{{custom4|{{{Sec4}}} }}} }}} }}}|{{{custom4name|{{{Sec4name|{{{custom4|{{{Sec4}}} }}} }}} }}}]] <!--
+
| {{Compact ToC |side=yes |j=J|q=Q}}
        -->}} {{#if:{{{custom5|{{{Sec5|}}}}}} |
+
|}
* [[{{{custom5link|{{{Sec5link|#{{{custom5|{{{Sec5}}} }}} }}} }}}|{{{custom5name|{{{Sec5name|{{{custom5|{{{Sec5}}} }}} }}} }}}]] <!--
+
''Note:'' It is often better to create an empty placeholder span (e.g. <code><nowiki><span id="Q"></span></nowiki></code>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.
            -->}} {{#if:{{{custom6|{{{Sec6|}}}}}} |
 
* [[{{{custom6link|{{{Sec6link|#{{{custom6|{{{Sec6}}} }}} }}} }}}|{{{custom6name|{{{Sec6name|{{{custom6|{{{Sec6}}} }}} }}} }}}]] <!--
 
              -->}} {{#if:{{{custom7|{{{Sec7|}}}}}} |
 
* [[{{{custom7link|{{{Sec7link|#{{{custom7|{{{Sec7}}} }}} }}} }}}|{{{custom7name|{{{Sec7name|{{{custom7|{{{Sec7}}} }}} }}} }}}]] <!--
 
                  -->}} {{#if:{{{custom8|{{{Sec8|}}}}}} |
 
* [[{{{custom8link|{{{Sec8link|#{{{custom8|{{{Sec8}}} }}} }}} }}}|{{{custom8name|{{{Sec8name|{{{custom8|{{{Sec8}}} }}} }}} }}}]] <!--
 
                    -->}}<!--
 
  
"See also" etc links
+
The letter-assignment feature can also be used to create range links, e.g. {{tlx|Compact ToC&#32;|<nowiki>side=yes |x=[[#X–Z|X–Z]] |y=|z=</nowiki>}}:
 +
{| style="margin-left:3.0em"
 +
| {{Compact ToC |side=yes |x=[[#X–Z|X–Z]] |y=|z=}}
 +
|}
  
-->{{#ifeq:{{{seealso}}}|yes |
+
The feature can also be used (very tediously) for linking to sub-articles (e.g. [[Wikipedia:Naming conventions (long lists)|long lists]] that have been split into multiple pages):<br/>
* [[#See also|See also]] }}<!--
+
{{tlx|Compact ToC&#32;|<nowiki>side=yes |name=[[</nowiki><var>Articlename</var><nowiki>]] |n=[[</nowiki><var>Articlename</var><nowiki> (N–Z)#N|N]] |o=[[</nowiki><var>Articlename</var><nowiki> (N–Z)#O|O]] |... |z=[[</nowiki><var>Articlename</var><nowiki> (N–Z)#Z|Z]]</nowiki>}}
-->{{#ifeq:{{{notesfirst}}}|yes |
+
{| style="margin-left:3.0em"
* [[#Notes|Notes]] }}<!--
+
| {{Compact ToC |side=yes |name=[[Articlename]] |n=[[Article (N–Z)#N|N]] |o=[[Articlename (N–Z)#O|O]] |p=[[Articlename (N–Z)#P|P]] |q=[[Articlename (N–Z)#Q|Q]] |r=[[Articlename (N–Z)#R|R]] |s=[[Articlename (N–Z)#S|S]] |t=[[Articlename (N–Z)#T|T]] |u=[[Articlename (N–Z)#U|U]] |v=[[Articlename (N–Z)#V|V]] |w=[[Articlename (N–Z)#W|W]] |x=[[Articlename (N–Z)#X|X]] |y=[[Articlename (N–Z)#Y|Y]] |z=[[Articlename (N–Z)#Z|Z]]}}
-->{{#ifeq:{{{refs|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes |
+
|}
* [[#References|References]] }}<!--
+
{{tlx|Compact ToC&#32;|<nowiki>side=yes |n=[[</nowiki><var>Articlename</var><nowiki> (N–Z)|&nbsp;N–Z {{small|(next page)}}]] |o=|p=|...|z=</nowiki>}}
-->{{#ifeq:{{{notes}}}|yes |
+
{| style="margin-left:3.0em"
* [[#Notes|Notes]] }}<!--
+
| {{Compact ToC |side=yes |n=[[Articlename (N–Z)|&nbsp;N–Z {{small|(next page)}}]] |o=|p=|q=|r=|s=|t=|u=|v=|w=|x=|y=|z=}}
-->{{#ifeq:{{{further}}}|yes |
+
|}
* [[#Further reading|Further reading]] }}<!--
 
-->{{#ifeq:{{{extlinks}}}|yes |
 
* [[#External links|External links]] <!--
 
-->}}
 
<!-- --></div><!--
 
  
End contents box
+
== Listing custom headers ==
  
--></div><!--
+
The optional parameters ''pre1'', ''pre2'', ...''pre8'' and ''custom1'', ''custom2'', ...''custom8'' allow up to 16 other section headers to be listed before or after the "ABCDEF" list:
  
-->{{#ifeq:{{{center|{{#ifeq:{{{1}}}|short1|yes}}}}}|yes |
+
{{tlx|Compact ToC&#32;|<nowiki>name=no |center=yes |top=yes |custom1=New section |custom2=Additional section |seealso=yes|notes=yes</nowiki>}}
</div><!--
+
{{Compact ToC
-->}}<noinclude>
+
|name=no |center=yes |top=yes
 +
|custom1=New section |custom2=Additional section
 +
|seealso=yes |notes=yes
 +
}}
  
{{Documentation}}
+
{{tlx|Compact ToC&#32;|<nowiki>name=no |center=yes |top=yes |custom1=New section|custom1name=Custom section name |custom2=Outside page|custom2link=Main Page |seealso=yes|notes=yes</nowiki>}}
</noinclude>
+
{{Compact ToC
 +
|name=no |center=yes |top=yes
 +
|custom1=New section |custom1name=Custom section name
 +
|custom2=Outside page |custom2link=Main Page
 +
|seealso=yes |notes=yes
 +
}}
 +
 
 +
Headers can be listed before & after "ABCDEF" using ''pre1'' and ''custom1''&nbsp;:<br/>
 +
{{tlx|Compact ToC&#32;|<nowiki>center=yes |top=yes |pre1=Scope of list |pre2=Abbreviations used |prebreak=yes |custom1=Popular entries |custom2=Excluded entries |notes=yes|seealso=yes</nowiki>}}
 +
{{Compact ToC
 +
|center=yes |top=yes
 +
|pre1=Scope of list |pre2=Abbreviations used |prebreak=yes
 +
|custom1=Popular entries |custom2=Excluded entries
 +
|notes=yes |seealso=yes
 +
}}
 +
 
 +
==="short1"===
 +
<code><nowiki>{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}}</nowiki></code> is a common configuration whose parameters may be replaced by the shortcut
 +
: {{tlx|Compact ToC&#32;|short1}}
 +
i.e. by making <code>{{!}}short1</code> the very first parameter.
 +
 
 +
== Examples ==
 +
 
 +
{{tlx|Compact ToC&#32;|<nowiki>top=yes</nowiki>}}
 +
{| style="margin-left:2.0em"
 +
| {{Compact ToC |top=yes}}
 +
|}
 +
 
 +
{{tlx|Compact ToC&#32;|<nowiki>side=yes |sym=yes|num=yes |custom1=Other |seealso=yes |refs=yes</nowiki>}}
 +
{| style="margin-left:2.0em"
 +
| {{Compact ToC |side=yes |sym=yes|num=yes |custom1=Other |seealso=yes |refs=yes}}
 +
|}
 +
 
 +
{{tlx|Compact ToC&#32;|<nowiki>name=Directory |top=no |refs=yes|notes=yes|extlinks=yes</nowiki>}}
 +
{| style="margin-left:2.0em"
 +
|{{Compact ToC |name=Directory |top=no |refs=yes|notes=yes|extlinks=yes}}
 +
|}
 +
 
 +
{{tlx|Compact ToC&#32;|<nowiki>side=yes|right=yes |name=no |symnum=yes |seealso=yes</nowiki>}}
 +
{{Compact ToC |side=yes|right=yes |name=no |symnum=yes |seealso=yes}}<br style="clear:right;"/>
 +
 
 +
{{tlx|Compact ToC&#32;|<nowiki>short1 |sym=yes|num=yes|seealso=yes|notesfirst=yes|further=yes|extlinks=yes</nowiki>}}
 +
{{Compact ToC |short1 |sym=yes|num=yes|seealso=yes|notesfirst=yes|further=yes|extlinks=yes}}
 +
 
 +
== Limitations ==
 +
Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in [[MediaWiki:Common.css]].
 +
 
 +
== See also ==
 +
* [[Help:TOC]]
 +
* [[Template:Horizontal TOC]]
 +
* [[Template:Category TOC]]
 +
* [[Template:TOC limit]]
 +
* [[Help:Magic words#Behavior switches]] for more help on:
 +
** <nowiki>__NOTOC__</nowiki>
 +
** <nowiki>__TOC__</nowiki>
 +
 
 +
<includeonly>{{Sandbox other|
 +
| <!--Categories below this line, please; interwikis at Wikidata-->
 +
[[Category:Exclude in print]]
 +
[[Category:Wikipedia table of contents templates]]
 +
[[Category:Templates that add a tracking category]]
 +
}}</includeonly>

Revision as of 18:24, 29 June 2020

Template:Documentation subpage Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.

Contents

Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Template:Tlx

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template:Documentation subpage Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Template:Tlx Template:Documentation subpage Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template:Documentation subpage Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Template:Tlx

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Template:Tlx

Template:Documentation subpage

Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Template:Tlx Template:Documentation subpage Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Template:Tlx Template:Documentation subpage Template:High-use Template:Intricate template Template:Tsh

This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.


Usage

Features

  • 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).
    • Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
    • Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
  • 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 
{{Compact ToC |symnum=yes}}
Alphabetic (i.e. "A", "B", … "Z") links only 
{{Compact ToC}}
Common applications 
{{Compact ToC |center=yes |seealso=yes|refs=yes|further=yes}}

Full blank syntax

{{Compact ToC
 |side=|center=|right=
 |name=
 |top=

 |pre1=|pre1name=|pre1link=
 |pre2=|pre2name=|pre2link=
 <!--(etc, to:)-->
 |pre8=|pre8name=|pre8link=
 |prebreak=<!--yes-->

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

 |custom1=|custom1name=|custom1link=
 |custom2=|custom2name=|custom2link=
 <!--(etc, to:)-->
 |custom8=|custom8name=|custom8link=

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

Parameters

  • name=: change the heading to an alternative name instead of "Contents", or hide it completely by entering name=no
  • side=yes: put the "Contents" heading on the left side with a colon, instead of the top without one
  • center=yes: float ToC centered in the horizontal middle of the page, instead of floated left
  • right=yes: align the ToC horizontally to the right of the page (may require <br style="clear:right;" /> 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)
  • nobreak=yes: no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use side= for that)
  • top=yes: 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 <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)
  • num=yes: enable the "0–9" link for numeric entries section (create a heading of ==0&ndash;9== for the link to work)
  • sym=yes: enable the "!$@" link for symbolic entries section
  • symnum=yes: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!&ndash;9== for the link to work)
  • letters=no: suppresses the "A", "B", ..., "Z" entries.
  • pre1 to pre8: list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].
  • pre1name to pre8name: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]
  • pre1link to pre8link: modifies the targets of the pre-list headers: [[pre1link|pre1]].
  • prebreak=yes: set break-line after all pre-list headers
  • custom1 to custom8: add up to 8 extra "custom" sections after the "ABCDEF" list. These appear as [[#custom1|custom1]].
  • custom1name to custom8name: modifies the way the custom section headers appear: [[#custom1|custom1name]]
  • custom1link to custom8link: modifies the targets of the custom sections: [[custom1link|custom1]]. 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.
  • seealso=yes: enable link to the "See also" section
  • notesfirst=yes: enable link to the "Notes" section, but placed before "References"; do not use with notes (and do observe that it is plural)
  • refs=yes: enable link to the "References" section (observe that it is plural)
  • notes=yes: enable link to the "Notes" section (observe that it is plural)
  • further=yes: enable link to the "Further reading" section
  • extlinks=yes: enable link to the "External links" section
  • a= through z=: 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.)
  • allowtoc=yes: disables the hiding of the automatically-generated table of contents that __NOTOC__ 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.)

Letters

Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lowercase blank parameter, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Or it can be replaced with an unlinked letter by using that letter (in uppercase), e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.

The letter-assignment feature can also be used to create range links, e.g. Template:Tlx:

Template loop detected: Template:Compact ToC

The feature can also be used (very tediously) for linking to sub-articles (e.g. long lists that have been split into multiple pages):
Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Listing custom headers

The optional parameters pre1, pre2, ...pre8 and custom1, custom2, ...custom8 allow up to 16 other section headers to be listed before or after the "ABCDEF" list:

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Headers can be listed before & after "ABCDEF" using pre1 and custom1 :
Template:Tlx Template loop detected: Template:Compact ToC

"short1"

{{Compact ToC |side=yes |center=yes |nobreak=yes |refs=yes}} is a common configuration whose parameters may be replaced by the shortcut

Template:Tlx

i.e. by making |short1 the very first parameter.

Examples

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx

Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Template:Tlx Template loop detected: Template:Compact ToC

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also

Template:Sandbox other

Limitations

Unfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.

See also