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

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

برای تبدیل یک الگو به الگوی خودجایگزین، کد الگو را در دستور زیر بکار ببرید:
<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> استفاده کنید.