TOC – Template

Revision as of 11:34, 16 November 2021

⚠

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 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}}

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z #

{{TOC|subtoc
|content=
* 1. {{HashLink|#Title 1}}
* 2. {{HashLink|#Title 2}}
* 3. {{HashLink|#Title 3}}
}}

Contents

1. Title 1
2. Title 2
3. Title 3

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

The sub-TOC title

1. Title 1
2. Title 2
3. Title 3

@@ 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=
+	__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=
@@ Line 8: / Line 9: @@
 |side=
 	<div class="toc-side">__TOC__</div>
+|subtoc=
+	{{#if:{{{content|}}}
+	|
+		<div class="toc" style="font-size: .9em">
+		<div class="toctitle">'''{{{title|Contents}}}'''</div>
+{{{content}}}
+		</div>
+	|
+		__TOC__
+	}}
 |
-	__TOC__
+	def __TOC__
 }}</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 ==
-{{<nowiki/>TOC|'''''mode'''''|'''''size'''''|'''''limit'''''}}
+{{<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'')
 ** 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 <tt>__NOTOC__</tt>)
+** none - no TOC on the page (similar to {{hl|<nowiki>__NOTOC__</nowiki>}})
 ** 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
-* nonum: (Optional, default empty) <tt>y</tt> to hide numbers
+*** 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 {{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|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%"

TOC – Template

Revision as of 11:34, 16 November 2021

Usage

Navigation menu

Search