الگو:فهرست خودکار محتویات رده/هسته
این الگو در تعداد زیادی صفحه صفحه بهکار رفته است و تغییر دادن آن میتواند تأثیرات گستردهای داشته باشد. لطفاً تغییرات را در زیرصفحههای /تمرین یا /آزمایشی الگو، یا در زیرصفحهٔ کاربری خودتان بیازمایید. توصیه میشود که ابتدا در خصوص تغییرات مورد نظر در صفحهٔ بحث گفتگو کرده و سپس آنها را پیادهسازی کنید. |
این الگو از لوآ استفاده میکند: |
در صورتی که تعداد اعضای یک رده نشاندهندهٔ نیاز آن به یک فهرست محتوات (TOC) باشد، این الگو بسته به تعداد اعضا، الگوی فهرست محتویات مناسب را به صفحه اضافه میکند.
آستانههای تعداد اعضا به شرح زیر است:
- <= ۱۰۰ صفحه ← بدون فهرست محتویات
- ۱۰۱–۱۲۰۰ صفحه ← {{فهرست محتویات رده}}
- > ۱۲۰۰ صفحه ← {{فهرست بزرگ محتویات رده}}
استفاده
{{فهرست خودکار محتویات رده}}
در صفحههای رده، {{فهرست خودکار محتویات رده}}
را میتوانید در هرکجای صفحه که ترجیح میدهید فهرست در آنجا نمایش یابد، قرار دهید.
در الگوهای سرساز رده، بهتر است که این الگو خارج برچسبهای <includeonly></includeonly>
قرار گیرد تا خودِ الگو بهعنوان الگویی که از این فهرست محتویات استفاده میکند، ردهبندی شود.
پارامترها
به هیچ پارامتری نیاز نیست.
با این حال، پارامترهایی وجود دارند که میتوان به {{فهرست محتویات رده}} وارد کرد و در صورتی که این الگو، {{فهرست محتویات رده}} را فرابخواند، آن پارامترها به {{فهرست محتویات رده}} فرستاده میشوند.
بنابراین مثلاً {{فهرست خودکار محتویات رده|تراز=وسط}}
:
- در صورت عدم تولید فهرست محتویات، تغییری ایجاد نمیکند
- در صورت تولید {{فهرست محتویات رده}} فهرست را در وسط صفحه نمایش میدهد
- در صورت تولید {{فهرست بزرگ محتویات رده}} تغییری ایجاد نمیکند؛ چرا که {{فهرست بزرگ محتویات رده}} هیچ پارامتری نمیپذیرد
ردیابی
حالت | صفحهها | ٪ |
---|---|---|
بدون فهرست محتویات | ۸۰٬۲۹۰ | ۹۸٫۰۷٪ |
{{فهرست محتویات رده}} استاندارد | ۱٬۳۲۹ | ۱٫۶۲٪ |
{{فهرست بزرگ محتویات رده}} | ۲۴۹ | ۰٫۳۰٪ |
مجموع | ۸۱٬۸۶۸ | |
هر صفحهای که از این الگو استفاده کند، در یکی از سه ردهٔ ردیابی زیر قرار میگیرد:
- رده:فهرست خودکار محتویات رده بدون تولید فهرست محتویات
- رده:فهرست خودکار محتویات رده با تولید فهرست محتویات استاندارد
- رده:فهرست خودکار محتویات رده تولیدکننده فهرست بزرگ محتویات رده
الگوهایی که {{فهرست خودکار محتویات رده}} را تراگنجانش میکنند، به ردهٔ زیر افزوده میشوند:
- رده:الگو:استفادهکننده از فهرست خودکار محتویات رده (صفحهها: ۴۳۹)
... اما تنها در صورتی که دستور تراگنجانش الگو خارج از برچسبهای <noinclude></noinclude>
قرار گرفته باشد
مشکلات
این الگو برای شمارش تعداد صفحههای موجود در ردهها از واژهٔ جادویی {{صفحهدررده}}
استفاده میکند. متأسفانه این واژهٔ جادویی در ردههایی که تعداد زیادی صفحه از آنها حذف و به آنها اضافه میشوند، ممکن است نتایج بسیار اشتباهی را نشان دهد.
این مشکل بهخوبی شناسایی شده است و از سال ۲۰۱۰ تاکنون در چند جای مختلف مستندسازی شده است. از جمله:
در اکثریت قریب به اتفاق ردهها، تعداد صفحهها بهاندازهای دقیق هست که کاربرد صحیح این الگو را تضمین کند. با این حال، پر برخی موارد این مشکل وجود داشته است که {{صفحهدررده}}
بهطور نادرست عدد صفر را برگرداند. این مشکل در ردهٔ زیر قابل ردیابی است:
تا تاریخ ۱۹ آوریل ۲۰۲۰، بهنظر میرسد که این مشکل با یک ترفند کوچک اما زیرکانه در نحوهٔ فراخوانی {{صفحهدررده}}
برطرف شده باشد.[۱]
ردهٔ مزبور باید تنها حاوی صفحههایی باشد که بهعنوان «خالی» برچسب خوردهاند. پاکسازی این صفحه برای بهروزرسانی مجموع صفحهها