الگو:فهرست خودکار محتویات رده

(تغییرمسیر از الگو:CatAutoTOC)
توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

در صورتی که تعداد اعضای یک رده نشان‌دهندهٔ نیاز آن به یک فهرست محتوات (TOC) باشد، این الگو بسته به تعداد اعضا، الگوی فهرست محتویات مناسب را به صفحه اضافه می‌کند.

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

  1. <= ۱۰۰ صفحه ← بدون فهرست محتویات
  2. ۱۰۱–۱۲۰۰ صفحه ← {{فهرست محتویات رده}}
  3. > ۱۲۰۰ صفحه ← {{فهرست بزرگ محتویات رده}}

استفاده

{{فهرست خودکار محتویات رده}}

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

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

پارامترها

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

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

بنابراین مثلاً {{فهرست خودکار محتویات رده|تراز=وسط}}:

  1. در صورت عدم تولید فهرست محتویات، تغییری ایجاد نمی‌کند
  2. در صورت تولید {{فهرست محتویات رده}} فهرست را در وسط صفحه نمایش می‌دهد
  3. در صورت تولید {{فهرست بزرگ محتویات رده}} تغییری ایجاد نمی‌کند؛ چرا که {{فهرست بزرگ محتویات رده}} هیچ پارامتری نمی‌پذیرد

ردیابی

حالت صفحه‌ها ٪
بدون فهرست محتویات ۷۶٬۲۴۸ ۹۸٫۱۶٪
{{فهرست محتویات رده}} استاندارد ۱٬۱۹۴ ۱٫۵۴٪
{{فهرست بزرگ محتویات رده}} ۲۳۹ ۰٫۳۱٪
مجموع ۷۷٬۶۸۱
برای بروزرسانی مجموع، میانگیر این صفحه را خالی کنید.

هر صفحه‌ای که از این الگو استفاده کند، در یکی از سه ردهٔ ردیابی زیر قرار می‌گیرد:

الگوهایی که {{فهرست خودکار محتویات رده}} را تراگنجانش می‌کنند، به ردهٔ زیر افزوده می‌شوند:

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

پاکسازی این صفحه برای به‌روزرسانی مجموع صفحه‌ها

مشکلات

این الگو برای شمارش تعداد صفحه‌های موجود در رده‌ها از واژهٔ جادویی {{صفحه‌دررده}} استفاده می‌کند. متأسفانه این واژهٔ جادویی در رده‌هایی که تعداد زیادی صفحه از آن‌ها حذف و به آن‌ها اضافه می‌شوند، ممکن است نتایج بسیار اشتباهی را نشان دهد.

این مشکل به‌خوبی شناسایی شده است و از سال ۲۰۱۰ تاکنون در چند جای مختلف مستندسازی شده است. از جمله:

در اکثریت قریب به اتفاق رده‌ها، تعداد صفحه‌ها به‌اندازه‌ای دقیق هست که کاربرد صحیح این الگو را تضمین کند. با این حال، پر برخی موارد این مشکل وجود داشته است که {{صفحه‌دررده}} به‌طور نادرست عدد صفر را برگرداند. این مشکل در ردهٔ زیر قابل ردیابی است:

تا تاریخ ۱۹ آوریل ۲۰۲۰، به‌نظر می‌رسد که این مشکل با یک ترفند کوچک اما زیرکانه در نحوهٔ فراخوانی {{صفحه‌دررده}} برطرف شده باشد.[۱]

ردهٔ مزبور باید تنها حاوی صفحه‌هایی باشد که به‌عنوان «خالی» برچسب خورده‌اند. پاکسازی این صفحه برای به‌روزرسانی مجموع صفحه‌ها