پرش به محتوا

الگو:Cmbox

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

این یک فراالگو (en) است. Cmbox کوته‌نوشت C در Category و m در message و box است.

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

این الگو تقریبا شبیه {{Ambox}} عمل می‌کند و پارامترهایی همانند آن دارد.

استفاده

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

{{cmbox | text = متن دلخواه.}}

نمونه استفاده پیچیده:

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

گونه‌های جعبه پیامی رده

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

تصاویر دیگر

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

ویژه

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

پارامترها

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

{{cmbox
| name = نام الگو
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[پرونده:Some image.svg|40px]]
| imageright = [[پرونده:Some image.svg|40px]]
| class = یک کلاس [[سی‌اس‌اس]] دلخواه برای اعمال به جعبه
| style = مقادیر سی‌اس‌اس
| textstyle = مقادیر سی‌اس‌اس
| plainlinks = no
| text = متن مورد نظر برای جعبه.
}}

name

(پارامتر اختیاری) نام الگو. این پارامتر یک کلاس سی‌اس‌اس را با نام box-name به المان HTML می‌افزاید.

type

اگر پارامتر type استفاده نشود، نوع الگو با پیش‌فرض notice (هشدار) آن نمایش داده می‌شود که به معنی پس‌زمینه آبی است.

image

اگر استفاده نشود = اگر استفاده نشود پارامتر image الگو از تصویر پیش‌فرض استفاده می‌کند که نوع تصویر پیش‌فرض به پارامتر type بستگی دارد.
اگر استفاده بشود = اگر استفاده بشود باید تصویری مطابق با ویکی‌نماد معمول باشد. بسته به نسبت ارتفاع به عرض تصویر، عرض 40px تا 50px مناسب است. (اگرچه جعبه پیام می‌تواند هر اندازه‌ای را بپذیرد).
برای نمونه: image = [[file:Sub-arrows.svg|40px]]
none = یعنی هیچ تصویری استفاده نمی‌شود.

imageright

اگر استفاده نشود = اگر استفاده نشود هیچ تصویری در سمت راست جعبه استفاده نمی‌شود.
اگر استفاده بشود = اگر استفاده بشود باید تصویری مطابق با ویکی‌نماد معمول باشد. بسته به نسبت ارتفاع به عرض تصویر، عرض 40px تا 50px مناسب است. (اگرچه جعبه پیام می‌تواند هر اندازه‌ای را بپذیرد).
برای نمونه: imageright = [[file:Nuvola apps bookcase.png|40px]]
هر چیز = هر چیز دیگری که می‌خواهید در سمت راست جعبه نمایش داده شود.

style

یک سی‌اس‌اس اختیاری برای استفاده در کل جدول جعبه پیام، بدون استفاده از نماد گفتاورد " ".
برای نمونه: style = margin-bottom: 0.5em;

textstyle

یک سی‌اس‌اس اختیاری برای استفاده در سلول متن.
برای نمونه: textstyle = text-align: center;

plainlinks

در ویکی‌پدیا معمولا در کنار پیوند به بیرون، نماد یک پیکان دیده می‌شود (مانند Example.com). اما در جعبه‌های پیامی به صورت پیش‌فرض، این نماد پیکان نمایش داده نمی‌شود مانند: Example.com. برای نمایش سبک معمولی پیوند به بیرون با نماد پیکان از |plainlinks=no استفاده کنید.

text

متن پیام.

جزئیات فنی

اگر باید از پارامترهای ویژه در پارامتر text استفاده کنید باید اینگونه باشد:

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

این الگو برای بیشتر ظاهر خود از کلاس‌های سی‌اس‌اس cmbox در MediaWiki:Common.css استفاده می‌کند. بنابراین ظاهر آن کاملا انعطاف‌پذیر است.

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

تصاویر پیش‌فرض برای این فراالگو بجای قالب SVG دارای قالب PNG هستند. زیرا مرورگرهای وب قدیمی‌تر با پس‌زمینه شفافی که مدیاویکی برای تصاویر SVG ارائه می‌کند، مشکل دارند. تصاویر با قالب PNG در اینجا دارای رنگ پس‌زمینه شفاف بهینه‌سازی شده‌اند، بنابراین در همه مرورگرها خوب به نظر می‌رسند. توجه داشته باشید که آیکون‌های SVG تنها در مرورگرهای قدیمی تا حدودی بد به نظر می‌رسند. بنابراین چنین بهینه‌سازی دستی فقط برای آیکون‌های بسیار پرکاربرد ارزش دردسر دارد.

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

الگوهای مرتبط

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.