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

Этот мета-шаблон используется для формирования информационных сообщений на страницах пространства файлов. Шаблон позволяет задать различные цвета окна сообщения, вид значка и прочее.

Использование

Простое использование:

{{imbox | text = Some text.}}

Some text.

Сложное использование:

{{imbox
| type      = style
| image     = [[Image:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = The message body text.
}}

The message body text.

Типы информационных сообщений для пространства файлов

Следующие примеры используют различные значения параметра type, но не меняют параметры отображения значка (иконки), поэтому везде отображается картинка по умолчанию.

type=speedy – в шаблонах быстрого удаления категории.

type=delete – в шаблонах удаления категории.

type=content – Важные предупреждения о предостережения.

type=style – Обычные предупреждения о предостережения.

type=notice – Информационные сообщения, постоянные и временные.

type=move – Сообщения о перемещении, слиянии и разделении.

type=protection – Сообщения о защите страницы.

type=license – Сообщения о лицензии.

type=featured – Избранные изображения.

Другие значки

Значок по умолчанию добавлен для удобства. В большинстве случаев целесообразнее более конкретно указывать вид значка. Ниже показаны несколько примеров, поясняющих как использовать параметр image для отображения других значков.

type = style image = [[Image:Gnome-dev-camera.svg|42px]] Требует обработки.

type = move image = [[Image:To Commons.svg|52px]] Нужно скопировать на Викисклад.

type = license image = [[Image:Heckert GNU white.svg|48px]] Изображение передается по GFDL лицензии.

Дополнительно

Примеры использования других параметров и их комбинаций.

Не заданы параметры type и image (по умолчанию)

Не заданы параметр type и image=none – Значок не показывается и текст занимает всю ширину окна сообщения.

type = license image = [[Image:PD-icon.svg|40px]] <br> [[Image:Ambox warning yellow.svg|40px]] imageright = [[Image:Shuttle.svg|30px]]

Это произведение является общественным достоянием, так как оно создано Национальным управлением США по аэронавтике и исследованию космического пространства. Note that use of NASA logos, insignia and emblems are restricted per US law.

	type = license image = [[Image:PD-icon.svg|40px]] below = {{imbox | type = content | text = '''Этот шаблон устарел!''' }}
Этот шаблон лицензии устарел!

Параметры

Список всех параметров:

{{imbox
| type  = speedy / delete / content / style / notice / 
          move / protection / license / featured
| image = none / [[Image:Some image.svg|40px]]
| imageright = [[Image:Some image.svg|40px]]
| style = CSS value
| textstyle = CSS value
| text  = The message body text.
| below = More text or another imbox.
}}

type

нет параметра = если параметр type не задан, то используется значение по умолчанию notice (голубая рамка).

image

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

файл изображения = ссылка на файл использующая вики разметку. Размер подгоняется под 40px - 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:

image = [[Image:Sub-arrows.svg|40px]]

none = обозначает, что не нужно отображать значок.

imageright

нет параметра = если параметр imageright не задан, то значок справа не показывается.

файл изображения = ссылка на файл использующая вики разметку. Размер подгоняется под 40px - 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:

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

одругое = все что вы хотите отобразить справа.

style

Дополнительный параметр стиля CSS для всей таблицы. Например:

style = margin-bottom: 0.5em;

textstyle

Дополнительный параметр стиля CSS для текстовой ячейки. Например:

textstyle = text-align: center;

text

Текст сообщения.

below

Поде на всю ширину окна сообщения ниже теста и значка. Может содержать тест или другое окно сообщения, например:

below = {{imbox | type = content | text = Этот шаблон лицензии устарел. }}

Технические детали

Если вам необходимо использовать специальные символы внутри параметра text, то вам необходимо заменять их ESC-последовательностями :

{{imbox
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.  
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>. 
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}

Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. А здесь знак разделения параметров | и две угловые скобки }}. А здесь знак разделения параметров перед двумя закрывающими фигурными скобками |}}.

Этот шаблон использует imbox CSS классы в MediaWiki:Common.css влияющие на его внешний вид, т.е. он полностью перенастраиваемый.

Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, т.к. у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.

Файлы значков по умолчанию для этого мета-шаблона имеют формат png, а не svg. Основная причина в том, что у некоторых старых браузеров есть проблемы с отображением прозрачного фона, который подставляет MediaWiki движок для svg изображений. Все png изображение оптимизированы вручную и имеют прозрачный фон чтобы одинаково хорошо отображаться во всех браузерах. Обратите внимание, что svg значки выглядят плохо только в старых браузерах, поэтому такая ​​ручная оптимизация сделана только для наиболее часто использующихся иконок.