编辑“︁Template:CatAutoTOC/doc”︁

{{NoteTA|G1=MediaWiki}}{{Documentation subpage}}
{{lua|Module:HTMLDecode}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
當某一分類包含超過一定數量的頁面時，本模板會自動增加分類目錄：
# <= 100個頁面 → 沒有分類目錄
# 101–1200個頁面 → {{tl|CategoryTOC}}
# > 1200個頁面 → {{tl|LargeCategoryTOC}}

==用法==
<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.

===參數===
本模板沒有必填參數。

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

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|CategoryTOC}} is used
# Have no effect if {{tl|LargeCategoryTOC}} is used, because {{tl|LargeCategoryTOC}} accepts no parameters

==追蹤==
<div style="display:block; float:right">{{CatAutoTOC stats}}</div>
每個有放置本模板的頁面，將會被歸類於以下三個分類之一：
* [[:Category:CatAutoTOC generates no TOC]]
* [[:Category:CatAutoTOC generates standard Category TOC]]
* [[:Category:CatAutoTOC generates Large category TOC]]

Templates which transclude {{tl|CatAutoTOC}} are categorised in
* [[:Category:Templates using CatAutoTOC]]  (population: {{PAGESINCATEGORY|Templates using 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>

==缺陷==
This template uses the [[Help:魔术字|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:
* [[:Category:CatAutoTOC on pages where PAGESINCATEGORY returns zero]] (population: {{PAGESINCATEGORY:CatAutoTOC on pages where PAGESINCATEGORY returns zero}})

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>

==參見==
* [[Template:CategoryTOC]]
* [[Template:LargeCategoryTOC]]

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:分類頁眉模板]]
[[Category:維基百科分類目錄模板]]
}}</includeonly>