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

Матеріал з Вікіпедії — вільної енциклопедії.
Перейти до навігації Перейти до пошуку
Меташаблони
контейнерів повідомлень
шаблон контекст
{{Ambox}} стаття
{{Cmbox}} категорія
{{Imbox}} зображення
{{Tmbox}} обговорення
{{Fmbox}} верхній/нижній
колонтитул
{{Ombox}} інші сторінки
{{Mbox}} автовизначення
{{Asbox}} стаб статті
{{Dmbox}} неоднозначність

Це меташаблон {{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, але не використовують параметри зображень, таким чином, вони використовують зображення за замовчуванням для кожного типу.

Інші зображення[ред. код]

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

Спеціальні[ред. код]

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

Параметри[ред. код]

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

{{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пкс зазвичай підходить, але залежить від співвідношення сторін зображення (але контейнер повідомлення може приймати зображення будь-якого розміру). Наприклад:
imageright = [[Файл:Nuvola apps bookcase.png|40пкс]]
Anything = Будь-який інший об'єкт, який ви бажаєте розмістити з правої сторони.

style

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

textstyle

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

text

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

below

Площа повної ширини, що розташована під зображенням та текстом. Може приймати текст або об'єкт будь-якого іншого виду, Для прикладу інший imbox:
below = {{Imbox |type=content |text=Цей тег ліцензії застарілий.}}

plainlinks

За замовчуванням приймає значення 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, їх сторінки обговорення також можуть містити корисну інформацію, дивіться розділ "Див. також" нижче.

Див. також[ред. код]

До сімейства меташаблонів Модуль:Message box входить сім шаблонів:

  • {{Ambox}}, для контейнерів повідомлень на сторінках статей.
  • {{Cmbox}}, для контейнерів повідомлень на сторінках категорій.
  • {{Imbox}}, для контейнерів повідомлень на сторінках файлів (зображень).
  • {{Tmbox}}, для контейнерів повідомлень на сторінках обговорень.
  • {{Fmbox}}, для контейнерів повідомлень у верхньому/нижньому колонтитулі сторінки.
  • {{Ombox}}, для контейнерів повідомлень на сторінках інших типів.
  • {{Mbox}}, для контейнерів повідомлень, що використовуються у різних просторах назв та змінюють свій вигляд відповідно.

Тісно пов'язані меташаблони:

  • {{Asbox}}, для контейнерів повідомлень на сторінках стабів статей.
  • {{Dmbox}}, для контейнерів повідомлень на сторінках неоднозначностей або визначеного індексу.
  • {{Ivmbox}}, простий контейнер, повної ширини, із заданим фоном кольору слонової кістки, призначений для оформлення важливих повідомлень або нагадувань.