模板:CatAutoTOC/core
 | 此模板使用Lua语言： |
当某一分类包含超过一定数量的页面时，本模板会自动增加分类目录：
- <= 100个页面 → 没有分类目录
- 101–1200个页面 → {{CategoryTOC}}
- > 1200个页面 → {{LargeCategoryTOC}}
用法
{{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.
参数
本模板没有必填参数。
However, the parameters available {{CategoryTOC}} may be supplied, and if CatAutoTOC calls {{CategoryTOC}}, those parameters will be passed on to {{CategoryTOC}}.
So e.g. {{CatAutoTOC|align=center}} will:
- Have no effect if no TOC is generated
- Align to the center if {{CategoryTOC}} is used
- Have no effect if {{LargeCategoryTOC}} is used, because {{LargeCategoryTOC}} accepts no parameters
追踪
| {{CatAutoTOC}} 生成的效果 |
页面数量 | 百分比 |
|---|---|---|
| 未生成目录 | 1,606 | 87.05% |
| 生成标准目录 | 151 | 8.18% |
| 生成大型目录 | 88 | 4.77% |
| 总计 | 1,845 | |
| 清除缓存以显示最新数据 | ||
每个有放置本模板的页面，将会被归类于以下三个分类之一：
- Category:CatAutoTOC generates no TOC
- Category:CatAutoTOC generates standard Category TOC
- Category:CatAutoTOC generates Large category TOC
Templates which transclude {{CatAutoTOC}} are categorised in
- Category:Templates using CatAutoTOC (population: 0)
... but only if the transclusion is outside any <noinclude></noinclude> tags
Purge this page to update the totals
缺陷
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:
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: 0)
As of 19 April 2020, that problem seems to have been fixed by a small but cunning tweak[1] to how {{PAGESINCATEGORY}} is called.
The category should contain only pages labelled as "empty". Purge page to update totals