Edge Rewrite
Jump to content

Template:Category TOC/doc

From Wikipedia, the free encyclopedia

Usage

[edit]

This template adds a table of contents (TOC) to a category page. Typically, {{Automatic category TOC}} should be used instead of this template. {{Automatic category TOC}} automatically picks whether to display no table of contents, this template, or {{Large category TOC}} depending on the size of the category.

If necessary, {{Category TOC}} can also be called directly with the following syntax:

{{Category TOC
 | align     = <!-- left (default) / center / right -->
 | top       = <!-- yes (default) / no -->
 | numerals  = <!-- group (default) / separate / no -->
 | uppercase = <!-- yes (default) / group / no -->
 | lowercase = <!-- yes / group / no (default) -->
}}

Parameters

[edit]
  • align – specifies the position. Default is left.
  • top – specifies whether a link to the top of the category is included. Default is yes.
  • numerals – specifies whether numerals are included:
    • group (default): there is one link for 0–9.
    • separate: each numeral 0,1,...,9 has a separate link.
    • no: no link.
  • uppercase – specifies whether uppercase letters are included:
    • yes (default): each letter A,B,...,Z has a separate link.
    • group: there is one link for A-Z.
    • no: there is no link for uppercase letters.
  • lowercase – specifies whether lowercase letters are included:
    • yes: each letter a,b,...,z has a separate link.
    • group: there is one link for a-z.
    • no (default): there is no link for lowercase letters.

Examples

[edit]
Examples
{{Category TOC}}
{{Category TOC|align=center}}
{{Category TOC|align=right}}
{{Category TOC|top=no}}
{{Category TOC|numerals=separate}}
{{Category TOC|numerals=no}}
{{Category TOC|uppercase=group}}
{{Category TOC|uppercase=no}}
{{Category TOC|lowercase=yes}}
{{Category TOC|lowercase=group}}

Monitoring

[edit]

Usage on small categories is discouraged. Use of category TOC templates is tracked as follows:

See also

[edit]

TemplateData

[edit]
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Category TOC in articles based on its TemplateData.

TemplateData for Category TOC

Displays a category table of contents. In most cases, you should call {{Automatic category TOC}} instead of this template.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
alignalign

Aligns {{Category TOC}} to either the left or center, depending on the value.

Suggested values
left center
Lineoptional
toptop

If true, displays a link to the "top" of the table of contents.

Booleanoptional
numeralsnumerals

Specifies how numbers are included. "group" (default) generates one link for 0–9. "separate" generates one link per number. "no" hides numbers entirely.

Suggested values
group separate no
Lineoptional
uppercaseuppercase

Specifies how uppercase letters are included. "yes" (default) generates generates one link per letter. "group" generates one link for all of A–Z. "no" hides uppercase letters entirely.

Suggested values
yes group no
Lineoptional
lowercaselowercase

Specifies how lowercase letters are included. "no" (default) hides lowercase letters entirely. "yes" generates generates one link per letter. "group" generates one link for all of a–z.

Suggested values
no yes group
Lineoptional