در حال ویرایش پودمان:Unsubst/توضیحات

{{زیرصفحه توضیحات}}
<!-- Categories where indicated at the bottom of this page, please. -->
{{ارزیابی پودمان|protected}}

پودمان کمکی برای آسان‌سازی تبدیل یک الگوی جایگزین‌شده به یک انتقال الگو.

الگوهای نگهداری، مانند {{tl|مدرک}} یا {{tl|بهبود منبع}} هرگز نباید جایگزین شوند. راه دورزدن این کار، استفاده از شکل منتقل‌شده یک الگوی جایگزین است.

مانند هر الگوی دیگر با پارامترهای فهرست‌شده در گروه قالب پیشفرض، جعبه اطلاعات باید از [[پودمان:Unsubst-infobox]] استفاده کند.

=== استفاده ===

برای تبدیل یک الگو به الگوی خودجایگزین، کد الگو را در دستور زیر بکار ببرید:
<pre>
{{SAFESUBST:<noinclude />#invoke:Unsubst||$B=

 [ ... کد الگو در اینجا ... ]

}}
</pre>

هنگامیکه wikitext to display وجود ندارد باید به صورت "$B" نشان داده شود. همه دیگر پارامترها که به #invoke فرستاده می‌شوند به عنوان مقادیر پیش‌فرض در فراخوان الگوی ساخته‌شده، کپی می‌شوند. اگر مقدار هریک از این پیش‌فرض‌ها <code>__DATE__</code> باشد آن مقدار، در فراخوان الگوی ساخته‌شده، برابر ماه و سال جاری خواهد بود.

برخی الگوها یک {{tag|noinclude|o}} دارند اما در انتهای الگو با {{tag|noinclude|c}} سازگار نیستند. در این موارد، {{tag|noinclude|c}} از دست رفته باید پیش از <code>{{))}}</code> آورده شوند.

==== پیشرفته ====

<pre>
{{SAFESUBST:<noinclude />#invoke:Unsubst||$params=[ parameters ]|$aliases=[ aliases ]|$flags=[ flags ]|$B=

 [ ... کد الگو در اینجا ... ]

}}
</pre>

به خاطر محدودیت‌های لوآ، هنگامی که الگو جایگزین شد پارامترها معمولا به صورت تصادفی، مرتب می‌شوند. از {{para|$params}} می‌توان در #invoke:Unsubst استفاده کرد تا پارامترهای الگو را به صورت منظم و جداشده با ویرگول "،" فهرست کرد (نمونه <code>egg,bacon,sausage,cheese,spam</code>). در این فهرست، پارامترهای عددی باید پیش از دیگر پارامترها آورده شوند. هر پارامتر باقیمانده‌ای به انتهای فراخوان ایجادشده فرستاده می‌شود.

نام‌های فرضی یا مستعار پارامترها می‌توانند در {{para|$aliases}} فهرست شده (نباید در {{para|$params}} فهرست شوند) و به صورت خودکار، جایگزین شوند. هر نام فرضی یا مستعار و جایگزین آن باید به صورت <code>alias>replacement</code> نوشته شود و هریک از جفت‌ها باید با ویرگول "،" از یکدیگر جدا شوند (مانند <code>œuf>egg,melt>cheese</code>). توجه کنید که این پارامترها می‌توانند با یا بدون {{para|$params}} نیز کار کنند.

می‌توان از {{para|$flags}} برای دستکاری دیگر بخش‌های رفتار پودمان استفاده کرد. مقادیر ورودی با ویرگول "،" از یکدیگر جدا شده‌اند. flagsهای درست <code>override</code> (به پارامترهای #invoke: اجازه می‌دهد که بر پارامترهای اصلی فراخوان الگو، اولویت پیدا کنند); <code>keep-whitespace</code> (از حذف فضای سفید از پارامترهای بی‌نام، جلوگیری می‌کند); and <code>remove-empty</code> (همه پارامترها را حذف می‌کند).

از این پارامترها می‌توان در [[راهنما:کلمات جادویی#دستورهای تجزیه‌کننده|دستورهای تجزیه‌کننده]] استفاده کرد تا گزینه‌های پیشرفته‌تری بدست آورد. توجه کنید که در پارامترها در هر دستور تجزیه‌کننده با الگو، یا پودمان فراخوان، باید از <code><nowiki>SAFESUBST:<noinclude /></nowiki></code> استفاده کنید.

=== نمونه ===

<pre>
{{SAFESUBST:<noinclude />#invoke:Unsubst||foo=bar |date=__DATE__ |$B=

 [ ... کد الگو در اینجا ... ]

}}
</pre>

{| class="wikitable"
! Original !! Result
|-
| {{tlsc|نمونه}} || {{tlc|نمونه|foo=bar|date{{=}}{{#time:F Y}}}}
|-
| {{tlsc|نمونه|foo{{=}}X}} || {{tlc|Example|foo{{=}}X|date{{=}}{{#time:F Y}}}}
|-
| {{tlsc|نمونه|baz{{=}}X}} || {{tlc|Example|foo=bar|baz{{=}}X|date{{=}}{{#time:F Y}}}}
|-
| {{tlsc|نمونه|تاریخ{{=}}ژانویه ۲۰۰۱}} || {{tlc|نمونه|foo{{=}}bar|تاریخ{{=}}ژانویه ۲۰۰۱}}
|}

<includeonly>{{sandbox other||
| <!-- Categories below this line, please; interwikis at Wikidata -->
[[رده:فراالگوهای ویکی‌پدیا]]
[[رده:پودمان‌های مرتبط با حفاظت صفحه]]
}}</includeonly>