نمایش مبدأ برای الگو:فهرست خودکار محتویات رده/توضیحات

{{زیرصفحه توضیحات}}
{{پراستفاده}}
{{لوآ|پودمان:HTMLDecode}}
<!-- لطفاً رده‌ها را در جای مشخص‌شده در پایین این صفحه، و میان‌ویکی‌ها را در ویکی‌داده قرار دهید ([[ویکی‌پدیا:ویکی‌داده]] را ببینید) -->
در صورتی که تعداد اعضای یک رده نشان‌دهندهٔ نیاز آن به یک فهرست محتوات (TOC) باشد، این الگو بسته به تعداد اعضا، الگوی فهرست محتویات مناسب را به صفحه اضافه می‌کند.

آستانه‌های تعداد اعضا به شرح زیر است:

# <= ۱۰۰ صفحه ← بدون فهرست محتویات
# ۱۰۱–۱۲۰۰ صفحه ← {{الگو|فهرست محتویات رده}}
# > ۱۲۰۰ صفحه ← {{الگو|فهرست بزرگ محتویات رده}}

== استفاده ==
<code><nowiki>{{فهرست خودکار محتویات رده}}</nowiki></code>

در صفحه‌های رده، <code><nowiki>{{فهرست خودکار محتویات رده}}</nowiki></code> را می‌توانید در هرکجای صفحه که ترجیح می‌دهید فهرست در آنجا نمایش یابد، قرار دهید.

در الگوهای سرساز رده، بهتر است که این الگو خارج برچسب‌های <code><nowiki><includeonly></includeonly></nowiki></code> قرار گیرد تا خودِ الگو به‌عنوان الگویی که از این فهرست محتویات استفاده می‌کند، رده‌بندی شود.

=== پارامترها ===
به هیچ پارامتری نیاز نیست.

با این حال، پارامترهایی وجود دارند که می‌توان به {{الگو|فهرست محتویات رده}} وارد کرد و در صورتی که این الگو، {{الگو|فهرست محتویات رده}} را فرابخواند، آن پارامترها به {{الگو|فهرست محتویات رده}} فرستاده می‌شوند.

بنابراین مثلاً <code><nowiki>{{فهرست خودکار محتویات رده|تراز=وسط}}</nowiki></code>:
# در صورت عدم تولید فهرست محتویات، تغییری ایجاد نمی‌کند
# در صورت تولید {{الگو|فهرست محتویات رده}} فهرست را در وسط صفحه نمایش می‌دهد
# در صورت تولید {{الگو|فهرست بزرگ محتویات رده}} تغییری ایجاد نمی‌کند؛ چرا که {{الگو|فهرست بزرگ محتویات رده}} هیچ پارامتری نمی‌پذیرد

== ردیابی ==
<div style="display:block; float:left">{{آمار فهرست خودکار محتویات رده}}</div>
هر صفحه‌ای که از این الگو استفاده کند، در یکی از سه ردهٔ ردیابی زیر قرار می‌گیرد:
* [[:رده:فهرست خودکار محتویات رده بدون تولید فهرست محتویات]]
* [[:رده:فهرست خودکار محتویات رده با تولید فهرست محتویات استاندارد]]
* [[:رده:فهرست خودکار محتویات رده تولیدکننده فهرست بزرگ محتویات رده]]

الگوهایی که {{الگو|فهرست خودکار محتویات رده}} را تراگنجانش می‌کنند، به ردهٔ زیر افزوده می‌شوند:
* [[:رده:الگو:استفاده‌کننده از فهرست خودکار محتویات رده]]  (صفحه‌ها: {{صفحه‌دررده:الگو:استفاده‌کننده از فهرست خودکار محتویات رده}})

... اما تنها در صورتی که دستور تراگنجانش الگو خارج از برچسب‌های <code><nowiki><noinclude></noinclude></nowiki></code> قرار گرفته باشد

<small>{{پاکسازی|''پاکسازی این صفحه برای به‌روزرسانی مجموع صفحه‌ها''}}</small>

== مشکلات ==
این الگو برای شمارش تعداد صفحه‌های موجود در رده‌ها از [[راهنما:واژه‌های جادویی|واژهٔ جادویی]] <code><nowiki>{{صفحه‌دررده}}</nowiki></code> استفاده می‌کند.  متأسفانه این واژهٔ جادویی در رده‌هایی که تعداد زیادی صفحه از آن‌ها حذف و به آن‌ها اضافه می‌شوند، ممکن است نتایج بسیار اشتباهی را نشان دهد.

این مشکل به‌خوبی شناسایی شده است و از سال ۲۰۱۰ تاکنون در چند جای مختلف مستندسازی شده است. از جمله:
* [[phab:T18036]]
* [[phab:T221795]]
* [[phab:T69196]]

در اکثریت قریب به اتفاق رده‌ها، تعداد صفحه‌ها به‌اندازه‌ای دقیق هست که کاربرد صحیح این الگو را تضمین کند.  با این حال، پر برخی موارد این مشکل وجود داشته است که <code><nowiki>{{صفحه‌دررده}}</nowiki></code> به‌طور نادرست عدد صفر را برگرداند.  این مشکل در ردهٔ زیر قابل ردیابی است:
* [[:رده:فهرست خودکار محتویات رده در صفحه‌هایی که صفحه‌دررده عدد صفر را برمی‌گرداند]] (صفحه‌ها: {{صفحه‌دررده:فهرست خودکار محتویات رده در صفحه‌هایی که صفحه‌دررده عدد صفر را برمی‌گرداند}})

تا تاریخ ۱۹ آوریل ۲۰۲۰، به‌نظر می‌رسد که این مشکل با یک ترفند کوچک اما زیرکانه در نحوهٔ فراخوانی <code><nowiki>{{صفحه‌دررده}}</nowiki></code> برطرف شده باشد.[https://en.wikipedia.org/w/index.php?title=Template%3ACatAutoTOC&type=revision&diff=951919806&oldid=950933704]

ردهٔ مزبور ''باید'' تنها حاوی صفحه‌هایی باشد که به‌عنوان «خالی» برچسب خورده‌اند.
<small>{{پاکسازی صفحه|''پاکسازی این صفحه برای به‌روزرسانی مجموع صفحه‌ها''}}</small>

<includeonly>{{sandbox other||
<!-- لطفاً رده‌ها را زیر این سطر، و میان‌ویکی‌ها را در ویکی‌داده قرار دهید -->
[[رده:الگو:سرساز رده]]
[[رده:الگو:رده فهرست محتویات ویکی‌پدیا]]
}}</includeonly>