Перейти до вмісту

Шаблон:Cmbox/Документація

Матеріал з Вікіпідручника

Шаблон:Високий ризик

Шаблон:Mbox templates (small)

Це меташаблон {{Cmbox}} (англ. [C]ategory [m]essage [box]).

Він використовується для утворення контейнерів повідомлення на зразок {{Category diffuse}} для сторінок категорій. він пропонує декілька різних кольорів, використовує стандартні зображення, якщо не визначено параметра зображення та має деякі інші властивості.

Цей шаблон працює майже так само як і {{Ambox}} та використовує такі ж параметри.


Використання

[ред.]

Простий приклад використання:

{{cmbox | text = Деякий текст.}}


Складний приклад:

{{cmbox
| type      = style
| image     = [[Файл:Emblem-question-yellow.svg|40пкс]]
| style     = width: 400пкс;
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = Текст тіла повідомлення.
}}


Типи контейнерів повідомлень категорій

[ред.]

Наступні приклади використовують різні параметри type, але не використовують параметри зображень, таким чином, вони використовують зображення за замовчуванням для кожного типу.

Інші зображення

[ред.]

Стандартні зображення, показані вище, в основному використовуються для зручності. У багатьох випадках зручніше використовувати конкретніші зображення. Ці приклади використовують параметр image для визначення зображення, відмінного від стандартного.

Спеціальні

[ред.]

Деякі інші комбінації параметрів.

Параметри

[ред.]

Перелік усіх параметрів:

{{cmbox
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[Файл:Some image.svg|40пкс]]
| imageright = [[Файл:Some image.svg|40пкс]]
| class = Довільний клас CSS для застосування у контейнері
| style = CSS значення
| textstyle = CSS значення
| text  = Тіло тексту повідомлення.
}}

type

Якщо параметр type не задано, шаблон приймає тип notice. Це означає, що він матиме блакитний фон.

image

No parameter = Якщо параметр image не задано, шаблон використовує стандартне зображення. Яке стандартне зображення буде використано, залежить від параметру type.
An image = Повинно бути зображенням із звичайним описом вікі. Ширина у 40пкс - 50пкс зазвичай підходить, але залежить від співвідношення сторін зображення (але контейнер повідомлення може приймати зображення будь-якого розміру).
Наприклад: image = [[Файл:Sub-arrows.svg|40пкс]]
none = Означає, що зображення не використовується.

imageright

No parameter = Якщо параметр imageright не задано, зображення з правого боку не буде.
An image = Повинно бути зображенням із звичайним описом вікі. Ширина у 40пкс - 50пкс зазвичай підходить, але залежить від співвідношення сторін зображення (але контейнер повідомлення може приймати зображення будь-якого розміру).
Наприклад: imageright = [[Файл:Nuvola apps bookcase.png|40пкс]]
Anything = Будь-який інший об'єкт, який ви бажаєте розмістити з правої сторони.

style

Необов'язкове значення CSS, що використовується для усієї таблиці контейнера повідомлення. Без лапок " ".
Наприклад: style = margin-bottom: 0.5em;

textstyle

Необов'язкове значення CSS, що використовується для комірки тексту.
Наприклад: textstyle = text-align: center;

text

Тіло тексту повідомлення.

Технічні подробиці

[ред.]

Якщо вам необхідно використовувати спеціальні символи у тексті параметрів, вам необхідно робити це таким чином:

{{cmbox
| text  = <div>
Equal sign = and a start and end brace { } work fine as they are. 
But here is a pipe {{!}} and two end braces <nowiki>}}</nowiki>. 
And now a pipe and end braces <nowiki>|}}</nowiki>.
</div>
}}


Цей шаблон використовує класи cmbox CSS у MediaWiki:Common.css для більшості свого оформлення, таким чином, він повністю підтримує скіни.

Внутрішньо цей меташаблон використовує для табличного коду розмітку HTML замість вікірозмітки. Це звичайний спосіб для створення меташаблонів, оскільки вікіпрозмітка має декілька недоліків. Наприклад, вона ускладнює використання парсерних функцій та спеціальних символів у параметрах.

Стандартні зображення цього меташаблону мають формат png замість svg. Основною причиною є те, що деякі старіші браузери мають проблеми із прозорим фоном, що утворює MediaWiki для svg зображень. Зображення png у цьому випадку мають гарну оптимізацію кольору прозорого фону, і таким чином вони добре виглядають у всіх браузерах. Зауважте, що svg іконки програють у рендері тільки у старих браузерах, таким чином, така ручна оптимізація потрібна тільки для іконок найширшого використання.

Задля більшої кількості технічних подробиць дивіться сторінку обговорення. Оскільки шаблон працює майже так само як й інші mboxes, їх сторінки обговорення також можуть містити корисну інформацію (дивіться розділ Див. також нижче).

Див. також

[ред.]

Шаблон:Mbox шаблони дивись також