شابلون:CatAutoTOC/بلگه

Adds a Table of Contents (TOC) to a category page if the category's size warrants it.

The size thresholds are:

1. >= ۱۰۰ صفحه → موحتوا جدولی (TOC) لازیم دییر
2. ۱۰۱–۱۲۰۰ صفحه → {{Category TOC}}
3. < ۱۲۰۰ صفحه → {{Large category TOC}}

ایستیفاده‌سی

{{CatAutoTOC}}

On category pages, {{CatAutoTOC}} can be placed wherever you want the TOC to be displayed.

On a category header template, it is best placed outside any <includeonly></includeonly> tags, so that the template is categorised as using CatAutoTOC.

پارامترلر

No parameters are needed.

However, the parameters available {{Category TOC}} may be supplied, and if CatAutoTOC calls {{Category TOC}}, those parameters will be passed on to {{Category TOC}}.

So e.g. {{CatAutoTOC|align=center}} will:

1. Have no effect if no TOC is generated
2. Align to the center if {{Category TOC}} is used
3. Have no effect if {{Large category TOC}} is used, because {{Large category TOC}} accepts no parameters

Tracking

CatAutoToc effect	Pages	%
No TOC	۱۶۵	7001782000000000000♠۷۸٫۲۰‏٪
Standard {{Category TOC}}	۳۳	7001156400000000000♠۱۵٫۶۴‏٪
{{Large category TOC}}	۱۳	7000616000000000000♠۶٫۱۶‏٪
Total	۲۱۱

Each page using this template is categorised in one of three tracking categories:

• Category:CatAutoTOC generates no TOC
• Category:CatAutoTOC generates standard Category TOC
• Category:CatAutoTOC generates Large category TOC

Templates which transclude {{CatAutoTOC}} are categorised in

• بؤلمه:اوتومات بؤلمه موحتوا جدولی ایستیفاده ائدن شابلونلار (population: ۰)

... but only if the transclusion is outside any <noinclude></noinclude> tags

Bugs

This template uses the magic word {{PAGESINCATEGORY}} to count the number of pages in the category. Unfortunately, this function can return wildly erroneous results on some categories which have had many pages added and removed.

This bug is well-known, and has been documented in several places since 2010, including:

• phab:T18036
• phab:T221795
• phab:T69196

In the overwhelming majority of categories, the count is recorded accurately enough to support use of this template. However, there seemed to be some issue with {{PAGESINCATEGORY}} falsely returning zero in some cases. This is tracked in:

• Category:CatAutoTOC on pages where PAGESINCATEGORY returns zero (population: ۱۸)

As of 19 April 2020, that problem seems to have been fixed by a small but cunning tweak[۱] to how {{PAGESINCATEGORY}} is called.

The category should contain only pages labelled as "empty".

همچئنین باخ

• {{CatAutoTOC}} — auto-selects no TOC, {{Category TOC}}, or {{Large category TOC}}
• {{Category TOC}}
• {{Category TOC ATC}}
• {{Category TOC (Hebrew)}}
• {{Category TOC (non-Latin)}}
• {{Category TOC Unicode}}
• {{Collapsible large category TOC}}
• {{Large category TOC}}
• {{Large category TOC numeric}}
• {{Large category TOC years only}}
• {{Compact TOC}} — for articles