پرش به محتوا

الگو:نمونه نام پارامترها

از ویکی‌پدیا، دانشنامهٔ آزاد
توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

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

نمونه

[ویرایش]

یک ویکی‌متن نمونه برای تولید دمویی از {{جعبه اطلاعات}} (نمایش‌یافته در سمت چپ):

{{{عنوان}}}
{{{بالا}}}
{{{تصویر}}}
{{{عنوان تصویر}}}
{{{سرآیند۱}}}
{{{برچسب۲}}}{{{داده۲}}}
{{{برچسب۳}}}{{{داده۳}}}
{{{سرآیند۴}}}
{{{داده۵}}}
{{{داده۶}}}
{{{پایین}}}
{{نمونه نام پارامترها
|_template = جعبه اطلاعات
| عنوان   | بالا    | تصویر | عنوان تصویر
| سرآیند۱ | برچسب۲ | داده۲ | برچسب۳ | داده۳ | سرآیند۴
| داده۵   | داده۶  | پایین
}}

نکات استفاده

[ویرایش]

هرگاه {{نمونه نام پارامترها}} در زیرصفحهٔ سطح اول الگوی هدف خود به‌کار رود – برای مثال در زیرصفحهٔ /توضیحات الگوی هدف – پارامتر |_template= که برای تعریف الگوی هدف به‌کار رفته، می‌تواند حذف شود. به بیان دیگر، دستور فوق، اگر در صفحه‌ای با عنوانی مشابه الگو:جعبه اطلاعات/صفحه (که صفحه در آن می‌تواند «توضیحات»، «آزمایشی» و غیره باشد)، می‌تواند چنین باشد:

{{نمونه نام پارامترها
| عنوان   | بالا    | تصویر | عنوان تصویر
| سرآیند۱ | برچسب۲ | داده۲ | برچسب۳ | داده۳ | سرآیند۴
| داده۵   | داده۶  | پایین
}}

یک استثناء که برای این قاعده وجود دارد، زیرصفحهٔ «تمرین» است. اگر پودمان از صفحه‌ای فراخوانی شود که با عبارت «/تمرین» پایان می‌یابد، از آن صفحه برای تولید خروجی الگو استفاده خواهد کرد، و نه از صفحهٔ مبنا. برای غیرفعال‌سازی این عملکرد می‌توانید به‌شکل صریح پارامتر |_template= را مقداردهی کنید.

قالب‌بندی نام پارامترها را می‌توان با استفاده از پارامتر |_display= تغییر داد. به‌طور پیش‌فرض، نام پارامترها با سه آکولاد (استاندارد پارامترها، برای مثال {{{نام}}}) نمایش داده می‌شود، اما در صورتی که |_display=کج یا |_display=italic وارد شده باشد، پارامترها به‌شکل کج نمایش داده می‌شوند.

با استفاده از دستور |[نام پارامتر]=[مقدار] به‌جای |[نام پارامتر]، می‌توان مقداری سفارشی را برای یک پارامتر مشخص کرد. هرگونه قالب‌بندی برای چنین مقدارهایی – از جمله ایتالیک – باید به‌عنوان بخشی از آن مقدار وارد شود (برای مثال |پارامتر=''مقدار''<br/>). مقدارهای سفارشی را نمی‌توان در پارامترهایی که نام آن‌ها با زیرخط («_») آغاز می‌شود، استفاده کرد.

صفحه‌های وابسته

[ویرایش]