Шаблон:Tmbox: различия между версиями
Mansur700 (обсуждение | вклад) Нет описания правки |
Mansur700 (обсуждение | вклад) (Содержимое страницы заменено на «{{#invoke:Message box|tmbox}}<noinclude> {{doc}} </noinclude>») Метка: замена |
||
Строка 1: | Строка 1: | ||
{{# | {{#invoke:Message box|tmbox}}<noinclude> | ||
{{doc}} | |||
}}< | |||
</noinclude> | </noinclude> |
Текущая версия от 14:36, 31 января 2022
Внимание! Это один из самых используемых шаблонов. |
Прежде чем вносить какие-либо изменения в данный шаблон, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. Изменения могут быть внесены после этого в данный шаблон всего одной правкой. |
Этот шаблон реализован на основе Lua с использованием модуля Message box. |
Этот мета-шаблон (talk page message box) используется для формирования информационных сообщений на страницах обсуждения. Этот шаблон вызывается другими шаблонами и определяет общую структуру и внешний вид сообщений, используемых на страницах обсуждения проекта. Его можно использовать непосредственно на странице обсуждения, чтобы показать однократное сообщение в том же формате, что и другие шаблонные сообщения, но это скорее исключение (если сообщение является достаточно важным, чтобы отображаться в таком виде, лучше подумать о создании отдельного шаблона, чтобы он был легко доступен для других редакторов).
Этот шаблон подобен шаблону {{ambox}} и использует большинство его параметров.
Использование[править код]
Простое использование:
{{tmbox | text = Обычный текст. }}
Обычный текст. |
Сложное использование:
{{tmbox | type = style | 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 и image (по умолчанию) |
Не заданы параметр type и image=none – Значок не показывается и текст занимает всю ширину окна сообщения. |
image = [[Файл:Gnome globe current event.svg|42px]] imageright = [[Файл:Nuvola apps bookcase.svg|40px]] |
Параметры[править код]
Список всех параметров:
{{tmbox | type = speedy / delete / content / style / notice / move / protection | image = none / [[Файл:Картинка.svg|40px]] | imageright = [[Файл:Картинка.svg|40px]] | style = Дополнительные параметры оформления. | textstyle = Дополнительные параметры оформления сообщения. | text = Заголовок сообщения. | text-small = Текст меньшего шрифта под заголовком. | small = {{{small|}}} / yes | smallimage = none / [[Файл:Картинка.svg|30px]] | smallimageright = none / [[Файл:Картинка.svg|30px]] | smalltext = A shorter message body text. }}
type
- нет параметра = если параметр type не задан, то используется значение по умолчанию notice (голубой фон).
image
- нет параметра = если параметр image не задан, то используется значок по умолчанию в зависимости от значения параметра type.
- файл изображения = ссылка на файл, использующая Тептар разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
image = [[Файл:Sub-arrows.svg|40px]]
- none = обозначает, что не нужно отображать значок.
imageright
- нет параметра = если параметр imageright не задан, то значок справа не показывается.
- файл изображения = ссылка на файл, использующая Тептар разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
imageright = [[Файл:Nuvola apps bookcase.png|40px]]
- одругое = всё, что вы хотите отобразить справа.
style
- Дополнительный параметр стиля CSS для всей таблицы. Например:
style = margin-bottom: 0.5em;
textstyle
- Дополнительный параметр стиля CSS для текстовой ячейки. Например:
textstyle = text-align: center;
text
- Текст сообщения, можно использовать как заголовок сообщения при заданном параметре
text-small
text-small
- Текст сообщения.
Параметры миниатюризации[править код]
small = yes |
type = style small = yes |
small
- yes = Создаёт маленькое окно сообщения, прикрепляющееся к правому краю страницы. Этот параметр также уменьшает значок по умолчанию. Обратите внимание, что данные, переданные в параметрах smallimage, smallimageright и smalltext, используются, только если «small=yes». Чтобы производный шаблон понимал параметр small, используйте следующий код:
small = {{{small|}}}
small = yes image = [[Файл:Nuvola apps bookcase.png|40px]] smallimage = [[Файл:Nuvola apps bookcase.png|30px]] |
smallimage
- нет параметра = если параметр smallimage не задан, то опять используется параметр image. Если параметр image также пустой, то используется маленький значок по умолчанию.
- файл изображения = ссылка на файл использующая Тептар разметку. Обычно около 20px для сообщений в одну строку и до 25px в ширину для двух строк текста. Например:
smallimage = [[Файл:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]
- none = обозначает, что не нужно отображать значок. Переопределяет заданное в параметре image, когда «small=left».
small = yes imageright = [[Файл:Nuvola apps bookcase.png|40px]] |
small = yes imageright = [[Файл:Nuvola apps bookcase.png|40px]] smallimageright = none |
smallimageright
- нет параметра = если параметр smallimageright не задан, то опять используется параметр imageright. Если параметр imageright также пустой, то используется значок справа не показывается.
- файл изображения = ссылка на файл, использующая Тептар разметку. Около 30px в ширину. Например:
smallimageright = [[Файл:Nuvola apps bookcase.png|30px|alt=Three stacked books]]
- одругое = всё, что вы хотите отобразить справа.
- none = обозначает, что не нужно отображать значок справа. Переопределяет заданное в параметре imageright, когда «small=yes».
smalltext
- Краткий вариант текста сообщения. Если параметр smalltext не задан, то используется параметр text.
Технические детали[править код]
Если вам необходимо использовать специальные символы внутри параметра text, то вам необходимо заменять их ESC-последовательностями:
{{tmbox | text = <div> Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>. А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>. </div> }}
Этот шаблон использует tmbox
CSS-классы в MediaWiki:Common.css влияющие на его внешний вид, то есть он полностью перенастраиваемый.
Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка Тептар разметки. Так делается во всех мета-шаблонах, так как у Тептар-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.