https://wiki.nebeshtar.com/index.php?action=history&feed=atom&title=%D9%BE%D9%88%D8%AF%D9%85%D8%A7%D9%86%3ALabelled_list_hatnote%2F%D8%AA%D9%88%D8%B6%DB%8C%D8%AD%D8%A7%D8%AAپودمان:Labelled list hatnote/توضیحات - تاریخچهٔ نسخهها2026-05-05T14:11:38Zتاریخچهٔ نسخهها برای این صفحه در ویکیMediaWiki 1.45.1https://wiki.nebeshtar.com/index.php?title=%D9%BE%D9%88%D8%AF%D9%85%D8%A7%D9%86:Labelled_list_hatnote/%D8%AA%D9%88%D8%B6%DB%8C%D8%AD%D8%A7%D8%AA&diff=337&oldid=prevمحمد: صفحهای تازه حاوی «{{زیرصفحه توضیحات}} {{ارزیابی پودمان|protected}} {{used in system|مدیاویکی:Wantedpages-summary}} {{لوآ|پودمان:Hatnote|پودمان:Hatnote list|پودمان:Arguments|پودمان:Numeral converter}} این پودمان چندین تابع کاربردی را فراهم میکند که کار پیادهسازی سرنویسهایی که از قالب یک برچسب پیش از...» ایجاد کرد2025-01-22T20:51:46Z<p>صفحهای تازه حاوی «{{زیرصفحه توضیحات}} {{ارزیابی پودمان|protected}} {{used in system|<a href="/wiki/%D9%85%D8%AF%DB%8C%D8%A7%D9%88%DB%8C%DA%A9%DB%8C:Wantedpages-summary" title="مدیاویکی:Wantedpages-summary">مدیاویکی:Wantedpages-summary</a>}} {{لوآ|پودمان:Hatnote|پودمان:Hatnote list|پودمان:Arguments|پودمان:Numeral converter}} این پودمان چندین تابع کاربردی را فراهم میکند که کار پیادهسازی سرنویسهایی که از قالب یک برچسب پیش از...» ایجاد کرد</p>
<p><b>صفحهٔ تازه</b></p><div>{{زیرصفحه توضیحات}}<br />
{{ارزیابی پودمان|protected}}<br />
{{used in system|[[مدیاویکی:Wantedpages-summary]]}}<br />
{{لوآ|پودمان:Hatnote|پودمان:Hatnote list|پودمان:Arguments|پودمان:Numeral converter}}<br />
<br />
این پودمان چندین تابع کاربردی را فراهم میکند که کار پیادهسازی سرنویسهایی که از قالب یک برچسب پیش از فهرستی از صفحهها برخوردار هستند را آسان میکنند. نمونهای از سرنویسهای مذکور: {{سرنویس|برچسب: [[الف]]، [[ب]]، و [[ج]]}}<br />
<br />
== استفاده ==<br />
<br />
=== labelledList ===<br />
برای پیادهسازی بیشتر الگوهایی از این دست، درخواست برای اجرای تابع <code>labelledList()</code> کفایت میکند:<br />
<br />
<code><nowiki>{{#درخواست:Labelled list hatnote|labelledList|برچسب سراسری}}</nowiki></code><br />
<br />
یا<br />
<br />
<code><nowiki>{{#درخواست:Labelled list hatnote|labelledList|برچسب مفرد|برچسب جمع}}</nowiki></code><br />
<br />
برای مثال، وارد کردن «همچنین ببینید» بهجای «برچسب سراسری» در نمونهٔ نخست، عملکردی یکسان با {{الگو|همچنین ببینید}} را ارائه میدهد، و وارد کردن «مقالهٔ اصلی» و «مقالههای اصلی» بهجای «برچسب مفرد» و «برچسب جمع» منجر به عملکردی یکسان با الگوی {{الگو|اصلی}} (در فضای نام مقاله) میشود.<br />
<br />
اگر برچسبهای سوم و چهارم نیز وارد شده باشند، در مواردی بهکار خواهند رفت که هریک از صفحههای هدف در خارج از فضای نام مقاله باشند؛ بنابراین، برای مثال {{الگو|اصلی}} میتواند به شکل زیر پیادهسازی شود:<br />
<br />
<code><nowiki>{{#درخواست:Labelled list hatnote|labelledList|مقالهٔ اصلی|مقالههای اصلی|صفحهٔ اصلی|صفحههای اصلی}}</nowiki></code><br />
<br />
=== preprocessDisplays ===<br />
تابع <code>preprocessDisplays()</code> فهرستی خام از آرگومانها را میپذیرد و هرگونه آرگومان نمایشی را با آن ترکیب میکند. برای مثال، {{الگوب|همچنین ببینید|۱|<nowiki>ب۱=یک</nowiki>}} در ابتدا فهرست آرگومانهای <code><nowiki>{'۱', ['ب۱'] = 'یک'}</nowiki></code> را دارد؛ این فهرست، در حالت ترکیب شده بهشکل <code><nowiki>{'1|یک'}</nowiki></code> در فهرست جدید قرار میگیرد. این تابع از نامپوشی دستی (یعنی {{الگوب|همچنین ببینید|<nowiki>۱{{!}}۲</nowiki>|<nowiki>ب۱=یک</nowiki>}} ← <code><nowiki>{'۱|یک'}</nowiki></code>) چشمپوشی میکند و در صورت صرف نظر از یک پارامتر یا خالی گذاشتن آن، آرایههای پراکنده را فشردهسازی میکند.<br />
<br />
نمونه: <syntaxhighlight lang="lua"><br />
local mLabelledList = require('Module:Labelled list hatnote')<br />
local pages = mLabelledList.preprocessDisplays(args)<br />
</syntaxhighlight><br />
<br />
=== _labelledList ===<br />
برای پودمانهایی که همزمان با استفاده از این پودمان، نیازمند اعمال تغییرات جزئی در عملکرد آن هستند، تابع <code>_labelledList()</code> تا حدودی انعطافپذیرتر است. این تابع سه پارامتر را میپذیرد:<br />
# فهرستی از صفحهها، ترجیحاً پیش-پردازششده و فشردهسازیشده توسط <code>preprocessDisplays</code><br />
# جدولی از برچسبها، که آیتم اول آن حاوی برچسب مفرد یا برچسب سراسری باشد، و پارامتر دوم آن نیز جاوی برچسب جمع یا رونوشتی از پارامتر اول باشد.<br />
# جدولی از گزینهها، ترجیحاً حاوی موارد زیر:<br />
#* یک رشتهٔ <code>template</code> حاوی عنوان کامل الگو. بهطور پیشفرض بر روی عنوان این پودمان تنظیم شدهاست.<br />
#* یک رشتهٔ <code>category</code> (یا nil) بهشکلی توسط <code>makeWikitextError</code> در [[پودمان:Hatnote]] پذیرفته میشود، برای غیرفعالسازی اختیاری ردههای خطا<br />
#* یک رشتهٔ <code>selfref</code> (یا nil) بهشکلی که توسط <code>_hatnote</code> برای فعالسازی گزینهٔ خودارجاع پذیرفته میشود<br />
<br />
نمونه: <syntaxhighlight lang="lua"><br />
local mLabelledList = require('Module:Labelled list hatnote')<br />
return mLabelledList._labelledList(pages, labels, options)<br />
</syntaxhighlight><br />
<br />
== خطاها ==<br />
در صورتی که نام هیچ صفحههای در قالب پارامترهای الگو وارد نشده باشد، این پودمان باعث میشود تا الگوهای مبتنی بر آن یک پیام خطا تولید کنند. در حالت عادی، این پیام باید به بخش «خطاها» در صفحهٔ مستندات الگوها هدایت شود. با این حال، اگر الگوهای مزبور از این پودمان با تابع <code>_labelledList()</code> استفاده کنند و در جدول گزینههای خود آیتم <code>template</code> را ارائه ندهند، ان پیام خطا بهطور پیشفرض به همین بخش که در حال مطالعهاش هستید، هدایت میشود. آن خطا را میتوان با وارد کردن نام دست کم یک صفحهٔ معتبر بهعنوان پارامتر الگوی مورد بحث، برطرف کرد؛ مشکل موجود در الگو را نیز میتوان با وارد کردن مقدار به آیتم <code>template</code> در جدول <code>options</code> تابع <code>_labelledList()</code> حل کرد.<br />
<br />
<includeonly>{{sandbox other||<br />
<br />
[[رده:پودمانهای سرنویس| ]]<br />
}}</includeonly></div>محمد