Просмотр кода страницы Ашаблон:CatAutoTOC/doc

{{lua|Амодуль:HTMLDecode}}
{{Аиҭагара}}
Adds a Table of Contents (TOC) to a category page if the category's size warrants it.

The size thresholds are:

# <= 100 pages → no TOC
# 101–1200 pages → {{tl|TOC акатегориа}}
# > 1200 pages → {{tl|TOC акатегориа ду}}

==Usage==
<code><nowiki>{{CatAutoTOC}}</nowiki></code>

On category pages, <code><nowiki>{{CatAutoTOC}}</nowiki></code> can be placed wherever you want the TOC to be displayed.

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

=== Parameters ===
No parameters are needed.

However, the parameters available {{tl|TOC акатегориа}} may be supplied, and if CatAutoTOC calls {{tl|TOC акатегориа}}, those parameters will be passed on to {{tl|TOC акатегориа}}.

So e.g. <code><nowiki>{{CatAutoTOC|align=center}}</nowiki></code> will:
# Have no effect if no TOC is generated
# Align to the center if {{tl|TOC акатегориа}} is used
# Have no effect if {{tl|TOC акатегориа ду}} is used, because {{tl|Large category TOC}} accepts no parameters

== Tracking ==
<div style="display:block; float:right">{{CatAutoTOC stats}}</div>
Each page using this template is categorised in one of three tracking categories:
* [[:Акатегориа:CatAutoTOC TOC агенерациа изутәым]]
* [[:Акатегориа:CatAutoTOC истандарту TOC акатегориа агенерациа азутәуп]]
* [[:Акатегориа:CatAutoTOC TOC акатегориа ду агенерациа азутәуп]]

Templates which transclude {{tl|CatAutoTOC}} are categorised in
* [[:Акатегориа:Ашаблонқәа:Ахархәара зуа CatAutoTOC]]  (population: {{PAGESINCATEGORY:Ашаблонқәа:Ахархәара зуа CatAutoTOC}})

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

<small>{{Purge|''Purge this page to update the totals''}}</small>

== Bugs ==
This template uses the [[Help:Magic words|magic word]] <code><nowiki>{{PAGESINCATEGORY}}</nowiki></code> 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 <code><nowiki>{{PAGESINCATEGORY}}</nowiki></code> falsely returning zero in some cases.  This is tracked in:
* [[:Акатегориа:PAGESINCATEGORY ахыԥхьаӡара аноль CatAutoTOC адаҟьақәа рахь ауп]] (population: {{PAGESINCATEGORY:PAGESINCATEGORY ахыԥхьаӡара аноль CatAutoTOC адаҟьақәа рахь ауп}})

As of 19 April 2020, that problem seems to have been fixed by a small but cunning tweak[https://en.wikipedia.org/w/index.php?title=Template%3ACatAutoTOC&type=revision&diff=951919806&oldid=950933704] to how <code><nowiki>{{PAGESINCATEGORY}}</nowiki></code> is called.

The category ''should'' contain only pages labelled as "empty".
<small>{{Purge page|''Purge page to update totals''}}</small>

==Шәахә. иара убас==
{{Category TOC see also}}

<includeonly>
[[Акатегориа:Ашаблонқәа:Акатегориа ахқәа]]
[[Акатегориа:Ашаблонқәа:Авикипедиа «table of contents» акатегориақәа]]
</includeonly>