TOC – Template

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Add arguments)
m (New TOC format after 1.35 → 1.39 update)
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<includeonly><div class="{{#if:{{{3|}}}|toclimit-{{{3|}}}; {{#if:{{{4|}}}|ht-{{#replace:{{{4}}}| |&#32;ht-}}|ht-1 ht-2 ht-3 ht-4 ht-5 ht-6}}}}">{{#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=
<div class="toc-horizontal">[[#A|A]][[#B|B]][[#C|C]][[#D|D]][[#E|E]][[#F|F]][[#G|G]][[#H|H]][[#I|I]][[#J|J]][[#K|K]][[#L|L]][[#M|M]][[#N|N]][[#O|O]][[#P|P]][[#Q|Q]][[#R|R]][[#S|S]][[#T|T]][[#U|U]][[#V|V]][[#W|W]][[#X|X]][[#Y|Y]][[#Z|Z]][[##|#]]</div>
__NOTOC__
<div class="toc-abc">[[#A|A]][[#B|B]][[#C|C]][[#D|D]][[#E|E]][[#F|F]][[#G|G]][[#H|H]][[#I|I]][[#J|J]][[#K|K]][[#L|L]][[#M|M]][[#N|N]][[#O|O]][[#P|P]][[#Q|Q]][[#R|R]][[#S|S]][[#T|T]][[#U|U]][[#V|V]][[#W|W]][[#X|X]][[#Y|Y]][[#Z|Z]][[##|#]]</div>
|horizontal=
|horizontal=
<div class="toc-horizontal">__TOC__</div>
<div class="toc-horizontal">__TOC__</div>
Line 7: Line 8:
__NOTOC__
__NOTOC__
|side=
|side=
<div class="toc-side" style="font-size: {{{1|1}}}em">__TOC__</div>
<div class="toc-side">__TOC__</div>
|subtoc=
{{#if:{{{content|}}}
|
<div class="toc" style="font-size: .9em">
{{#if:{{{title|a}}}|<div class="toctitle">'''{{{title|Contents}}}'''</div>}}
{{{content}}}
</div>
|
{{TemplateCase||[[Category:TOC template usage error]]}}
}}
|
|
__TOC__
__TOC__
}}</div></includeonly><noinclude>
}}</div></includeonly><noinclude>
{{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 ''abc'' and ''subtoc''.}}


== Usage ==
== Usage ==
{{<nowiki/>TOC|'''''mode'''''|'''''size'''''|'''''limit'''''|'''''levels'''''}}
{{<nowiki/>TOC|'''''mode'''''|'''''size'''''|'''''limit'''''|'''''nonum'''''|'''''title='''''|'''''content='''''}}
* mode: (Optional, default "normal" - case-insensitive) 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
** normal - the normal TOC - can be placed at the wanted position with this
** normal - the normal TOC - can be placed at the wanted position with this
** none - no TOC on the page (similar to <tt>__NOTOC__</tt>)
** none - no TOC on the page (similar to {{hl|<nowiki>__NOTOC__</nowiki>}})
** side - sets the TOC to the right
** side - sets the TOC to the right
* size: (Optional, default 1) size in em (e.g <tt>.9</tt> for 90%)
** subtoc - creates a TOC-like box. Additional parameters:
* limit: (Optional, default empty) sub-level limit (e.g <tt>2</tt>
*** title: (Optional, default empty) subTOC title
* levels: (Optional, default empty) wanted sub-levels (e.g <tt>2 4</tt>
*** content: subTOC content, usually a list of {{Template|Link}} internal links in format:<syntaxhighlight lang="handlebars">
* 1 {{Link|#Title 1}}
* 2 {{Link|#Title 2}}
* 3 {{Link|#Title 3}}
</syntaxhighlight>
* size: (Optional, default 1) size in em (e.g {{hl|.9}} for 90%)
* limit: (Optional, default empty) sub-level limit (e.g {{hl|2}})
* nonum: (Optional, default empty) {{hl|y}} to hide numbers


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


[[Category:Templates|{{uc:{{PAGENAME}}}}]]
[[Category:Templates|{{uc:{{PAGENAME}}}}]]</noinclude>
</noinclude>

Latest revision as of 18:43, 5 August 2024

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

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 {{Link}} internal links in format:
        * 1 {{Link|#Title 1}}
        * 2 {{Link|#Title 2}}
        * 3 {{Link|#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}}
{{TOC|abc}}
{{TOC|subtoc
|content=
* 1 {{Link|#Title 1}}
* 2 {{Link|#Title 2}}
* 3 {{Link|#Title 3}}
}}
Contents
{{TOC|subtoc
|title= The sub-TOC title
|content=
* 1 {{Link|#Title 1}}
* 2 {{Link|#Title 2}}
* 3 {{Link|#Title 3}}
}}
The sub-TOC title
{{TOC|subtoc
|title=
|content=
* 1 {{Link|#Title 1}}
* 2 {{Link|#Title 2}}
* 3 {{Link|#Title 3}}
}}