Цей шаблон використовується на 96 000+ сторінках і його зміни будуть дуже помітними. Будь ласка, перевіряйте будь-які зміни на підсторінках /пісочниці та /тестів цього шаблону, або у вашому особистому просторі, та зважайте на обговорення змін на сторінці обговорення перед їхнім впровадженням.
Це меташаблон {{Imbox}} (англ.[I]mage [m]essage [box]).
Він використовується для створення шаблонів контейнерів повідомлень для сторінок файлів (зображень), таких як {{cleanup-image}} і т.д. Він пропонує декілька різних кольорів, використовує стандартні зображення, якщо параметром зображення не задано інакше та має деякі інші особливості.
Цей шаблон працює майже так само, як і {{Ambox}} та використовує такі ж параметри.
Використання
Простий приклад використання:
{{Imbox |text=Деякий текст.}}
Деякий текст.
Складний приклад:
{{Imbox
| type = style
| style = width:400пкс;
| image = [[Файл:Emblem-question-yellow.svg|40пкс]]
| textstyle = font-style:italic; font-weight:bold; color:red;
| text = Текст тіла повідомлення.
}}
Текст тіла повідомлення.
Типи контейнерів повідомлень файлів
Наступні приклади використовують різні параметри type, але не використовують параметри зображень, таким чином, вони використовують зображення за замовчуванням для кожного типу.
type=speedy – Шаблони швидкого вилучення, такі як {{isd}}.
type=content – Основні застереження та проблеми, такі як {{non-free reduce}}.
type=style – Незначні попередження і проблеми, такі як {{cleanup-image}}.
type=notice – Сповіщення і повідомлення будь-якого роду, як постійні так і тимчасові.
type=move – Повідомлення та пропозиції переміщення та перейменування, такі як {{Requested move}}.
type=protection – Шаблони захисту сторінок.
type=license – Шаблони ліцензій, такі як {{GFDL}}.
type=featured – Шаблони обраних зображень, такі як {{FeaturedPicture}}.
Інші зображення
Стандартні зображення, показані вище, в основному використовуються для зручності. У багатьох випадках зручніше використовувати конкретніші зображення. Ці приклади використовують параметр image для визначення зображення, відмінного від стандартного.
type = style image = [[Файл:Gnome-dev-camera.svg|42пкс]] Це зображення використовується для {{cleanup-image}}.
type = move image = [[Файл:To Commons.svg|52пкс]] Це зображення використовується для {{copy to Wikimedia Commons}}.
type = license image = [[Файл:Heckert GNU white.svg|48пкс]] Це зображення використовується для шаблонів ліцензій GFDL, таких як {{GFDL}}.
Спеціальні
Деякі інші комбінації параметрів.
Без заданого типу та зображення (стандарт)
Без заданого типу та image=none – Не використовується зображення, а text використовує весь простір контейнеру повідомлення.
Цей файл перебуває у суспільному надбанні, оскільки його було створено НАСА. Зауважте, що використання логотипів, знаків розрізнення та емблем НАСА обмежене за законодавством США.
type = license image = [[Файл:PD-icon.svg|40пкс]] below = {{Imbox |type=content |text='''Ця ліцензія не рекомендується!'''}}
Ця ліцензія не рекомендується!
Параметри
Перелік усіх параметрів:
{{Imbox
| type = speedy / delete / content / style / notice /
move / protection / license / featured
| image = none / [[Файл:Some image.svg|40пкс]]
| imageright = [[Файл:Some image.svg|40пкс]]
| style = CSS значення
| textstyle = CSS значення
| text = Тіло тексту повідомлення.
| below = Додатковий текст або інший imbox.
| plainlinks = no
}}
type
Якщо параметр type не задано, шаблон приймає тип notice. Це означає, що він матиме блакитний форн.
image
No parameter = Якщо параметр image не задано, шаблон використовує стандартне зображення. Яке стандартне зображення буде використано, залежить від параметру type.
An image = Повинно бути зображенням із звичайним описом вікі. Ширина у 40пкс - 50пкс зазвичай підходить, але залежить від співвідношення сторін зображення (але контейнер повідомлення може приймати зображення будь-якого розміру). Наприклад:
image = [[Файл:Gnome-dev-camera.svg|40пкс]]
none = Означає, що зображення не використовується.
imageright
No parameter = Якщо параметр imageright не задано, зображення з правого боку не буде.
An image = Повинно бути зображенням із звичайним описом вікі. Ширина у 40пкс - 50пкс зазвичай підходить, але залежить від співвідношення сторін зображення (але контейнер повідомлення може приймати зображення будь-якого розміру). Наприклад:
За замовчуванням приймає значення yes. Якщо бажаними є зовнішні посилання у вигляді стрілок - - визначте як:
plainlinks = no
Технічні подробиці
Простір назв "Файл:" було перейменовано у "Файл:" 11 грудня 2008 року. Цей шаблон було створено задовго до того, і саме тому він має назву "imbox" як "image message box".
Якщо вам необхідно використовувати спеціальні символи у тексті параметрів, вам необхідно робити це таким чином:
{{Imbox
| text = <div>
Знак рівності = та дужки початку та кінця { } чудово працюють і так.
Але якщо використовувати {{!}} та дві дужки закінчення <nowiki>}}</nowiki>.
А тепер пайп і дужки закінчення <nowiki>|}}</nowiki>.
</div>
}}
Знак рівності = та дужки початку та кінця { } чудово працюють і так.
Але якщо використовувати | та дві дужки закінчення }}.
А тепер пайп і дужки закінчення |}}.
Цей шаблон використовує класи imbox CSS у MediaWiki:Common.css для більшості свого оформлення, таким чином, він повністю підтримує скіни.
Внутрішньо цей меташаблон використовує для табличного коду розмітку HTML замість вікірозмітки. Це звичайний спосіб для створення меташаблонів, оскільки вікіпрозмітка має декілька недоліків. Наприклад, вона ускладнює використання парсерних функцій та спеціальних символів у параметрах.
Стандартні зображення цього меташаблону мають формат png замість svg. Основною причиною є те, що деякі старіші браузери мають проблеми із прозорим фоном, що утворює MediaWiki для svg зображень. Зображення png у цьому випадку мають гарну оптимізацію кольору прозорого фону, і таким чином вони добре виглядають у всіх браузерах. Зауважте, що svg іконки програють у рендері тільки у старих браузерах, таким чином, така ручна оптимізація потрібна тільки для іконок найширшого використання.
Задля більшої кількості технічних подробиць дивіться сторінку обговорення. Оскільки шаблон працює майже так само як й інші mboxes, їх сторінки обговорення також можуть містити корисну інформацію, дивіться розділ "Див. також" нижче.
{{Ambox}}, для контейнерів повідомлень на сторінках статей.
{{Cmbox}}, для контейнерів повідомлень на сторінках категорій.
{{Imbox}}, для контейнерів повідомлень на сторінках файлів (зображень).
{{Tmbox}}, для контейнерів повідомлень на сторінках обговорень.
{{Fmbox}}, для контейнерів повідомлень у верхньому/нижньому колонтитулі сторінки.
{{Ombox}}, для контейнерів повідомлень на сторінках інших типів.
{{Mbox}}, для контейнерів повідомлень, що використовуються у різних просторах назв та змінюють свій вигляд відповідно.
Тісно пов'язані меташаблони:
{{Asbox}}, для контейнерів повідомлень на сторінках стабів статей.
{{Dmbox}}, для контейнерів повідомлень на сторінках неоднозначностей або визначеного індексу.
{{Ivmbox}}, простий контейнер, повної ширини, із заданим фоном кольору слонової кістки, призначений для оформлення важливих повідомлень або нагадувань.