Шаблон:ombox/Документация
Этот мета-шаблон (other pages message box) используется для формирования информационных сообщений в пространствах "Участник", "Викисловарь", "MediaWiki", "Шаблон", "Справка", и других, которые не покрываются шаблонами {{ambox}}, {{tmbox}}, {{imbox}} или {{cmbox}}. Поэтому он не должен использоваться на страницах словарных статей, страницах обсуждения, страницах изображений и страницах категорий.
Этот шаблон подобен шаблону {{ambox}} и использует большинство его параметров.
Использование[править]
Простое использование:
{{ombox | text = Some text.}}
Some text. |
Сложное использование:
{{ombox | 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 – Сообщения о защите страницы. |
Примеры использования[править]
Примеры использования в сообщениях типа "notice".
Не заданы параметры type и image (по умолчанию) |
Не заданы параметр type и image=none – Значок не показывается и текст занимает всю ширину окна сообщения. |
image = [[Image:Gnome globe current event.svg|42px]] imageright = [[Image:Nuvola apps bookcase.svg|40px]] |
Эта страница является частью правил и руководств Викисловаря. Изложенному здесь должны следовать все участники. Прежде чем редактировать, убедитесь, что вносимые изменения соответствуют консенсусу. Если есть сомнения, обсудите на странице обсуждения. |
Параметры[править]
Список всех параметров:
{{ombox | type = speedy / delete / content / style / notice / move / protection | image = none / [[Image:Some image.svg|40px]] | imageright = [[Image:Some image.svg|40px]] | style = CSS values | textstyle = CSS values | text = The message body text. | small = {{{small|}}} / yes | smallimage = none / [[Image:Some image.svg|30px]] | smallimageright = none / [[Image:Some image.svg|30px]] | smalltext = A shorter message body text. }}
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
- Текст сообщения.
Параметры миниатюризации[править]
small = yes |
type = style small = yes |
small
- yes = Создает маленькое окно сообщения прикрепляющееся к правому краю страницы. Этот параметр также уменьшает значок по умолчанию. Обратите внимание, что данные переданные в параметрах smallimage, smallimageright и smalltext используются только если "small=yes". Чтобы производный шаблон понимал параметр small используйте следующий код:
small = {{{small|}}}
small = yes image = [[Image:Replacement filing cabinet.svg|50px]] smallimage = [[Image:Replacement filing cabinet.svg|32px]] |
smallimage
- нет параметра = если параметр smallimage не задан, то опять используется параметр image. Если параметр image также пустой, то используется маленький значок по умолчанию.
- файл изображения = ссылка на файл использующая вики разметку. Обычно около 20px для сообщений в одну строку и до 25px в ширину для двух строк текста. Например:
smallimage = [[File:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]
- none = обозначает, что не нужно отображать значок. Переопределяет заданное в параметре image, когда "small=left".
small = yes imageright = [[Image:Nuvola apps bookcase.png|50px]] smallimageright = none |
smallimageright
- нет параметра = если параметр smallimageright не задан, то о пять используется параметр imageright. Если параметр imageright также пустой, то используется значок справа не показывается.
- файл изображения = ссылка на файл использующая вики разметку. Около 30px в ширину. Например:
smallimageright = [[File:Nuvola apps bookcase.png|30px|alt=Three stacked books]]
- одругое = все что вы хотите отобразить справа.
- none = обозначает, что не нужно отображать значок справа. Переопределяет заданное в параметре imageright, когда "small=yes".
smalltext
- Краткий вариант текста сообщения. Если параметр smalltext не задан, то пять используется параметр text.
Технические детали[править]
Если вам необходимо использовать специальные символы внутри параметра text, то вам необходимо заменять их ESC-последовательностями :
{{ombox | text = <div> Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>. А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>. </div> }}
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. А здесь знак разделения параметров | и две угловые скобки }}. А здесь знак разделения параметров перед двумя закрывающими фигурными скобками |}}. |
Этот шаблон использует ombox CSS классы в MediaWiki:Common.css влияющие на его внешний вид, т.е. он полностью перенастраиваемый.
Шаблон вызывает {{ombox/core}} содержит весь исполняемый код для {{ombox}}, когда как сам {{ombox}} занимается предварительной обработкой параметров, тем самым упрощая {{ombox/core}}.
Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, т.к. у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.
Файлы значков по умолчанию для этого мета-шаблона имеют формат png, а не svg. Основная причина в том, что у некоторых старых браузеров есть проблемы с отображением прозрачного фона, который подставляет MediaWiki движок для svg изображений. Все png изображение оптимизированы вручную и имеют прозрачный фон чтобы одинаково хорошо отображаться во всех браузерах. Обратите внимание, что svg значки выглядят плохо только в старых браузерах, поэтому такая ручная оптимизация сделана только для наиболее часто использующихся иконок.