Шаблон: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 значки выглядят плохо только в старых браузерах, поэтому такая ручная оптимизация сделана только для наиболее часто использующихся иконок.