الگو:Imbox

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

این {{Imbox}} ([I]mage [m]essage [box]) یک ابرالگو است.

از این الگو برای ساخت جعبه‌های پیام صفحات پرونده (تصویر) استفاده می‌شود، مانند {{تمیزکاری تصویر}} و غیره. این الگو چندین رنگ مختلف ارائه می‌دهد، اگر پارامتر تصویر داده نشود از تصاویر پیش‌فرض استفاده می‌کند و امکانات دیگری هم دارد.

این الگو تقریباً دقیقاً مشابه {{Ambox}} کار می‌کند و از همان پارامترها استفاده می‌کند.

استفاده

نمونه استفاده ساده:

{{Imbox |text=متنی نمونه.}}

متنی نمونه.

نمونه پیچیده:

{{Imbox
| type = style
| style = width:400px;
| image = [[File:Emblem-question-yellow.svg|40px]]
| textstyle = font-style:italic; font-weight:bold; color:red;
| text = متن بدنه پیام.
}}

متن بدنه پیام.

انواع جعبه پیام تصویر

نمونه‌های زیر از پارامتر type مختلف استفاده می‌کنند اما پارامتر تصویر ندارند، بنابراین از تصاویر پیش‌فرض برای هر نوع استفاده می‌شود.

type=speedy – الگوهای حذف سریع مانند {{حس-پ۱}}.

type=delete – الگوهای حذف مانند {{پیشنهاد حذف تصویر}}.

type=content – هشدارها و مشکلات عمده، مانند {{نیازمند نسخه کوچکتر}}.

type=style – هشدارها و مشکلات جزئی، مانند {{تمیزکاری تصویر}}.

type=notice – اطلاعیه‌ها و پیام‌ها از هر نوع، دائمی یا موقت.

type=move – پیام‌ها و پیشنهادهای انتقال و تغییر نام، مانند {{درخواست انتقال}}.

type=protection – الگوهای محافظت مانند {{حص}} زمانی که روی صفحه تصویر نمایش داده می‌شوند.

type=featured – الگوهای تصویر برگزیده مانند {{نگاره برگزیده}}.

تصاویر دیگر

تصاویر پیش‌فرض بالا عمدتاً برای راحتی قرار داده شده‌اند. در بسیاری از موارد مناسب‌تر است که از تصاویر خاص‌تر استفاده شود. این نمونه‌ها از پارامتر image برای مشخص کردن تصویری غیر از تصاویر پیش‌فرض استفاده می‌کنند.

type = style
image = [[File:Gnome-dev-camera.svg|42px]]
این تصویر برای {{تمیزکاری تصویر}} استفاده می‌شود.

type = move
image = [[File:To Commons.svg|52px]]
این تصویر برای {{انتقال به ویکی‌انبار}} استفاده می‌شود.

ویژه

برخی ترکیب‌های دیگر پارامترها.

بدون type و بدون تصویر (پیش‌فرض)

بدون type و image=none – تصویری نمایش داده نمی‌شود و text تمام فضای جعبه پیام را اشغال می‌کند.

پارامترها

فهرست همه پارامترها:

{{Imbox
| name = نام الگو
| type  = speedy / delete / content / style / notice /
          move / protection / license / featured
| image = none / [[File:Some image.svg|40px]]
| imageright = [[File:Some image.svg|40px]]
| style = مقدار CSS
| textstyle = مقدار CSS
| text  = متن بدنه پیام.
| below = متن بیشتر یا یک imbox دیگر.
| plainlinks = no
}}

name

(اختیاری) نام الگو. این یک کلاس CSS با نام box-name به عنصر HTML اضافه می‌کند که می‌تواند توسط ربات‌ها یا اسکریپت‌ها استفاده شود.

type

اگر پارامتر type داده نشود، الگو به‌طور پیش‌فرض از نوع notice خواهد بود؛ یعنی حاشیه آبی خواهد داشت.

image

بدون پارامتر = اگر پارامتر image داده نشود، الگو از تصویر پیش‌فرض استفاده می‌کند. اینکه کدام تصویر پیش‌فرض استفاده شود به پارامتر type بستگی دارد.

یک تصویر = باید تصویری با نگارش معمول ویکی باشد. عرض ۴۰ تا ۵۰ پیکسل معمولاً مناسب است، بسته به نسبت ارتفاع به عرض تصویر. (اما جعبه پیام می‌تواند تصاویر با هر ابعادی را مدیریت کند) برای مثال:

image = [[File:Gnome-dev-camera.svg|40px]]

none = یعنی هیچ تصویری استفاده نمی‌شود.

imageright

بدون پارامتر = اگر پارامتر imageright داده نشود، تصویری در سمت راست نمایش داده نمی‌شود.

یک تصویر = باید تصویری با نگارش معمول ویکی باشد. عرض ۴۰ تا ۵۰ پیکسل معمولاً مناسب است، بسته به نسبت ارتفاع به عرض تصویر. (اما جعبه پیام می‌تواند تصاویر با هر ابعادی را مدیریت کند) برای مثال:

imageright = [[File:Nuvola apps bookcase.png|40px]]

هر چیز دیگر = هر شیء دیگری که بخواهید در سمت راست نمایش داده شود.

style

یک مقدار اختیاری سی‌اس‌اس که برای کل جدول جعبه پیام استفاده می‌شود. بدون گیومه " ". برای مثال:

style = margin-bottom: 0.5em;

textstyle

یک مقدار اختیاری سی‌اس‌اس که برای سلول متن استفاده می‌شود. برای مثال:

textstyle = text-align: center;

text

متن بدنه پیام.

below

ناحیه‌ای با عرض کامل زیر بخش تصاویر و متن. می‌تواند متن یا هر شیء دیگری باشد، مثلاً یک imbox دیگر:

below = {{Imbox |type=content |text=این برچسب مجوز منسوخ شده است.}}

plainlinks

به‌طور پیش‌فرض yes است. اگر می‌خواهید پیکان لینک خارجی - - نمایش داده شود، این مقدار را مشخص کنید:

plainlinks = no

جزئیات فنی

فضای نام "Image:" در ۱۱ دسامبر ۲۰۰۸ به "File:" تغییر یافت. این الگو مدت‌ها پیش از آن ایجاد شده و به همین دلیل "imbox" (image message box) نام گرفته است.

اگر نیاز دارید از نویسه‌های خاص در پارامتر text استفاده کنید باید آن‌ها را این‌گونه escape کنید:

{{Imbox
| text = <div>
علامت مساوی = و آکولادهای باز و بسته { } به همین صورت قابل استفاده‌اند.
اما اینجا یک خط عمودی {{!}} و دو آکولاد بسته <nowiki>}}</nowiki>.
و حالا یک خط عمودی و آکولاد بسته <nowiki>|}}</nowiki>.
</div>
}}

علامت مساوی = و آکولادهای باز و بسته { } به همین صورت قابل استفاده‌اند. اما اینجا یک خط عمودی | و دو آکولاد بسته }}. و حالا یک خط عمودی و آکولاد بسته |}}.

این الگو برای اکثر ظاهرش از کلاس‌های سی‌اس‌اس imbox در MediaWiki:Common.css استفاده می‌کند، بنابراین کاملاً قابل سفارشی‌سازی با پوسته‌ها است.

درون این ابراالگو برای کد جدول به جای نشانه‌گذاری ویکی از نشانه‌گذاری HTML استفاده شده است. این روش معمول ما برای ساخت ابراالگوهاست زیرا نشانه‌گذاری ویکی چندین محدودیت دارد؛ مثلاً استفاده از توابع تجزیه‌گر و نویسه‌های خاص در پارامترها را دشوار می‌کند.

تصاویر پیش‌فرض این ابراالگو به فرمت png هستند، نه svg. دلیل اصلی این است که برخی مرورگرهای قدیمی‌تر با تصاویر شفاف png مشکل دارند. برای این مرورگرها این تصاویر png به گونه‌ای تغییر یافته‌اند که رنگ پس‌زمینه‌شان با رنگ پس‌زمینه قالب مطابقت داشته باشد. پس‌زمینه پیش‌فرضی که مدیاویکی برای تصاویر svg ایجاد می‌کند همیشه سفید است. این باعث می‌شود که در مرورگرهای قدیمی‌تر دور تصاویر یک جعبه سفید ایجاد شود.

برای جزئیات فنی بیشتر به صفحه بحث الگو مراجعه کنید. از آنجا که این الگو تقریباً مانند دیگر mboxها کار می‌کند، صفحه‌های بحث و صفحه‌های مرتبط دیگر هم ممکن است جزئیات بیشتری داشته باشند؛ به بخش «همچنین ببینید» در پایین مراجعه کنید.

جستارهای وابسته

There are several meta-templates in the mbox family:

• {{ambox}} – For article message boxes.
• {{cmbox}} – For category message boxes.
• {{imbox}} – For file (image) page message boxes.
• {{mbox}} – Has namespace detection, for message boxes that are used on several types of pages and thus need to change style depending on what page they are used on.
• {{ombox}} – For other pages message boxes.
• {{tmbox}} – For talk page message boxes.

Closely related meta-templates:

• {{asbox}} – For article stub message boxes.
• {{dmbox}} – For disambiguation and set index message boxes.
• {{fmbox}} – For header and footer message boxes.

توضیحات بالا تراگنجانده‌شده از الگو:Imbox/توضیحات است. (ویرایش | تاریخچه)
ویرایشگران می‌توانند در صفحات تمرین (ایجاد | آینه) و آزمایشی (ایجاد) این الگو را آزمایش کنند.
لطفاً رده‌ها را به زیرصفحهٔ /توضیحات بیفزایید. زیرصفحه‌های این الگو.