TOC – Template

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Fixed documentation)
(Add subTOC, made 'mode' case-insensitive)
Line 1: Line 1:
<includeonly><div class="{{#if:{{{3|}}}|toclimit-{{{3|}}}}} {{#if:{{{4|}}}|toc-nonum}}" {{#if:{{{2|}}}|style="font-size: {{{2}}}em"}}>{{#switch:{{{1|}}}
<includeonly><div class="{{#if:{{{3|}}}|toclimit-{{{3|}}}}} {{#if:{{{4|}}}|toc-nonum}}" {{#if:{{{2|}}}|style="font-size: {{{2}}}em"}}>{{#switch:{{lc:{{{1|}}}}}
|abc=
|abc=
__NOTOC__
__NOTOC__
Line 9: Line 9:
|side=
|side=
<div class="toc-side">__TOC__</div>
<div class="toc-side">__TOC__</div>
|subtoc=
{{#if:{{{content|}}}
|
<div class="toc" style="font-size: .9em">
<div class="toctitle"><h2>{{{title|Contents}}}</h2></div>
{{{content}}}
</div>
|
__TOC__
}}
|
|
__TOC__
def __TOC__
}}</div></includeonly><noinclude>
}}</div></includeonly><noinclude>
{{Feature | important | Only '''one''' TOC (Table of Contents) is possible per page, with the exception of the ''abc'' one.}}
{{Feature | important | Only '''one''' TOC (Table of Contents) is possible per page, with the exception of the ''abc'' one.}}


== Usage ==
== Usage ==
{{<nowiki/>TOC|'''''mode'''''|'''''size'''''|'''''limit'''''|'''''nonum'''''}}
{{<nowiki/>TOC|'''''mode'''''|'''''size'''''|'''''limit'''''|'''''nonum'''''|'''''title='''''|'''''content='''''}}
* mode: (Optional, default: "normal"; case-sensitive) one of:
* mode: (Optional, default: "normal"; case-insensitive) one of:
** abc - a horizontal A..Z TOC (more of an ''index'')
** abc - a horizontal A..Z TOC (more of an ''index'')
** horizontal - a horizontal TOC, where full titles are kept
** horizontal - a horizontal TOC, where full titles are kept
Line 22: Line 32:
** none - no TOC on the page (similar to <tt><nowiki>__NOTOC__</nowiki></tt>)
** none - no TOC on the page (similar to <tt><nowiki>__NOTOC__</nowiki></tt>)
** side - sets the TOC to the right
** side - sets the TOC to the right
** subtoc - creates a TOC-like box. Additional parameters:
*** title: (Optional, default empty) subTOC title
*** content: subTOC content, usually a list of [[Template:HashLink|HashLink]] internal links in format:<syntaxhighlight lang="html">
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
</syntaxhighlight>
* size: (Optional, default 1) size in em (e.g <tt>.9</tt> for 90%)
* size: (Optional, default 1) size in em (e.g <tt>.9</tt> for 90%)
* limit: (Optional, default empty) sub-level limit (e.g <tt>2</tt>)
* limit: (Optional, default empty) sub-level limit (e.g <tt>2</tt>)
* nonum: (Optional, default empty) <tt>y</tt> to hide numbers
* nonum: (Optional, default empty) <tt>y</tt> to hide numbers


{| style="width: 100%"
|+ Examples
|- style="background-color: #EEE"
! Code
! Result
|-
| <pre>{{TOC|abc}}</pre>
| {{TOC|abc}}
|-
| <pre>{{TOC|subtoc
|content=
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
}}</pre>
| style="padding-left: 2.5em" |
{{TOC|subtoc
|content=
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
}}
|-
| <pre>{{TOC|subtoc
|title= The sub-TOC title
|content=
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
}}</pre>
| style="padding-left: 2.5em" |
{{TOC|subtoc
|title= The sub-TOC title
|content=
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
}}
|}
<!--
<!--
{| class="wikitable" style="width: 100%"
{| class="wikitable" style="width: 100%"

Revision as of 02:30, 6 August 2021

Only one TOC (Table of Contents) is possible per page, with the exception of the abc one.

Usage

{{TOC|mode|size|limit|nonum|title=|content=}}

  • mode: (Optional, default: "normal"; case-insensitive) one of:
    • abc - a horizontal A..Z TOC (more of an index)
    • horizontal - a horizontal TOC, where full titles are kept
    • normal - the normal TOC - can be placed at the wanted position with this
    • none - no TOC on the page (similar to __NOTOC__)
    • side - sets the TOC to the right
    • subtoc - creates a TOC-like box. Additional parameters:
      • title: (Optional, default empty) subTOC title
      • content: subTOC content, usually a list of HashLink internal links in format:
        * 1. {{HashLink|#Title 1}}
        * 2. {{HashLink|#Title 2}}
        * 3. {{HashLink|#Title 3}}
        
  • size: (Optional, default 1) size in em (e.g .9 for 90%)
  • limit: (Optional, default empty) sub-level limit (e.g 2)
  • nonum: (Optional, default empty) y to hide numbers
Examples
Code Result
{{TOC|abc}}
{{TOC|subtoc
|content=
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
}}

Contents

{{TOC|subtoc
|title= The sub-TOC title
|content=
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
}}

The sub-TOC title