Шаблон:Ombox/doc: различия между версиями
(Удалено перенаправление на Шаблон:Стили шаблона/doc) Метка: удалено перенаправление |
Нет описания правки |
||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 4: | Строка 4: | ||
{{onLua|Message box}} | {{onLua|Message box}} | ||
{{Mbox templates|nocat=1}} | {{Mbox templates|nocat=1}} | ||
'''{{t|Ombox}}''', название сокращенно от '''''o'''ther pages '''m'''essage '''box''''' | '''{{t|Ombox}}''', название сокращенно от '''''o'''ther pages '''m'''essage '''box''''' — меташаблон различных шаблонов-сообщений в пространствах «Участник», «Википедия», «Шаблон», «Справка», и других, которые не покрываются шаблонами {{t|ambox}}, {{t|tmbox}}, {{t|imbox}} или {{t|cmbox}}. Поэтому он '''не должен''' использоваться в статьях, страницах обсуждения, файлах и категориях. | ||
Похож на шаблон {{tl|Ambox}} и использует такие же параметры. | Похож на шаблон {{tl|Ambox}} и использует такие же параметры. | ||
Строка 73: | Строка 73: | ||
=== ''image'' === | === ''image'' === | ||
Вы можете выбрать уникальное изображение для шаблона, использую параметр ''image''. Значение параметра {{para|image}} должно иметь тот же синтаксис, как и при вставке изображения в статью ([[Википедия:Иллюстрирование#Вставка файла в статью]]). В стандарте, | Вы можете выбрать уникальное изображение для шаблона, использую параметр ''image''. Значение параметра {{para|image}} должно иметь тот же синтаксис, как и при вставке изображения в статью ([[Википедия:Иллюстрирование#Вставка файла в статью]]). В стандарте, ширина — 40-50px. Например: | ||
* Для {{Tl|Правило}} указано изображение {{Para|image|<nowiki>[[Файл:OOjs UI icon check-constructive.svg|40px|alt=✔|link=]]</nowiki>}}: | * Для {{Tl|Правило}} указано изображение {{Para|image|<nowiki>[[Файл:OOjs UI icon check-constructive.svg|40px|alt=✔|link=]]</nowiki>}}: | ||
Строка 92: | Строка 92: | ||
Примеры использования параметра редакторами: | Примеры использования параметра редакторами: | ||
* {{para|talk|ЗАГОЛОВОК СЕКЦИИ}} | * {{para|talk|ЗАГОЛОВОК СЕКЦИИ}} — ссылка отправит читателя в необходимую секцию на странице обсуждения статьи. Пример — {{para|talk|Foo}}. | ||
* {{para|talk|ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ}} | * {{para|talk|ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ}} — шаблон выдаст ссылку на указанную страницу обсуждения (может содержать [[Википедия:Как править статьи#Ссылки, URL|ссылку на секцию]]), например {{para|talk|Обсуждение:Banana#Foo}}. | ||
Примечания: | Примечания: | ||
Строка 138: | Строка 138: | ||
=== ''style'' and ''textstyle'' === | === ''style'' and ''textstyle'' === | ||
Дополнительные значения CSS могут быть определены без кавычек <code>" "</code>, но с завершающими точками с запятой <code>;</code>. | Дополнительные значения CSS могут быть определены без кавычек <code>" "</code>, но с завершающими точками с запятой <code>;</code>. | ||
* {{para|style}} | * {{para|style}} — определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна. | ||
* {{para|textstyle}} | * {{para|textstyle}} — относится к текстовой ячейке. | ||
=== ''issue'' and ''fix'' === | === ''issue'' and ''fix'' === | ||
Строка 207: | Строка 207: | ||
Если вам необходимо использовать специальные символы внутри параметра {{para|text}}, то вам необходимо заменять их ESC-последовательностями: | Если вам необходимо использовать специальные символы внутри параметра {{para|text}}, то вам необходимо заменять их ESC-последовательностями: | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="wikitext"> | ||
{{ombox | {{ombox | ||
| text = <div> | | text = <div> | ||
Строка 232: | Строка 232: | ||
== Семейство Mbox == | == Семейство Mbox == | ||
{{ | {{Mbox/doc/номенклатура}} | ||
<includeonly> | <includeonly> | ||
[[Категория:Шаблоны-сообщения семейства Mbox]] | [[Категория:Шаблоны-сообщения семейства Mbox]] | ||
</includeonly> | </includeonly> | ||
Текущая версия от 22:06, 28 июня 2023
Внимание! Это один из самых используемых шаблонов. |
Прежде чем вносить какие-либо изменения в этот шаблон, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. Вносить тестированные изменения в этот шаблон следует ровно одной правкой. |
Этот шаблон реализован на основе Lua с использованием модуля Message box. |
{{Ombox}}, название сокращенно от other pages message box — меташаблон различных шаблонов-сообщений в пространствах «Участник», «Википедия», «Шаблон», «Справка», и других, которые не покрываются шаблонами {{ambox}}, {{tmbox}}, {{imbox}} или {{cmbox}}. Поэтому он не должен использоваться в статьях, страницах обсуждения, файлах и категориях.
Похож на шаблон {{Ambox}} и использует такие же параметры.
Параметры[править]
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]] |
Эта страница является частью правил и руководств русской Википедии. Изложенному здесь должны следовать все участники. Прежде чем редактировать, убедитесь, что вносимые изменения соответствуют консенсусу. Если есть сомнения, обсудите на форуме или странице обсуждения. |
В двух словах: Этот шаблон используется для отображения информационного сообщения на страницах, не являющихся статьёй, страницей обсуждения, файлом или категорией. |
image[править]
Вы можете выбрать уникальное изображение для шаблона, использую параметр image. Значение параметра |image=
должно иметь тот же синтаксис, как и при вставке изображения в статью (Википедия:Иллюстрирование#Вставка файла в статью). В стандарте, ширина — 40-50px. Например:
- Для {{Правило}} указано изображение
|image=[[Файл:OOjs UI icon check-constructive.svg|40px|alt=✔|link=]]
:
Эта страница относится к правилам русской Википедии. |
Пожалуйста, учтите:
- Если изображение не указано, то оно будет зависеть от параметра type. (Смотрите о параметре #type выше.)
- Если указано
|image=none
, то никакое изображение выводится не будет, и текст займет всю площадь шаблона. - Если изображение выполняет чисто декоративную функцию, а также находится в общественном достоянии, удобство и доступность использования шаблоны может быть улучшена с помощью подавления ссылки на файл с помощью добавления параметров
|link=
и|alt=
, как показано выше.
text, и text-small[править]
Параметр text передает основной текст в шаблон. Постарайтесь сделать его как можно более кратким и понятным.
Параметр text-small показывает текст маленьким шрифт, не рекомендуем его использовать для файлов.
talk[править]
Некоторые шаблоны-сообщения содержат ссылку на страницу обсуждения, и позволяют редактору уточнить заголовок необходимой секции для ссылки. Чтобы добиться такой функциональности, просто укажите при создании шаблона |talk={{{talk|}}}
.
Примеры использования параметра редакторами:
|talk=ЗАГОЛОВОК СЕКЦИИ
— ссылка отправит читателя в необходимую секцию на странице обсуждения статьи. Пример —|talk=Foo
.|talk=ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ
— шаблон выдаст ссылку на указанную страницу обсуждения (может содержать ссылку на секцию), например|talk=Обсуждение:Banana#Foo
.
Примечания:
- При использовании этого параметра при создании шаблона, то ссылка на страницу обсуждения будет появляться и в самом шаблоне (для того, чтобы продемонстрировать функциональность), но на страницах она будет отображаться, только если параметр фактически указан.
- Чтобы быть уверенным, что ссылка на страницу обсуждения постоянно показывается, вы можете использовать следующую конструкцию:
|talk={{{talk|#}}}
. - Строка не будет отображаться если страницы обсуждения статьи, или указанной страницы обсуждения не существует, и неважно что вы укажете в параметре.
date[править]
Установка параметра date сообщает мета-шаблону, что в шаблон-сообщение был установлен в этот день: устанавливается как редакторами, так и ботами. Отображается мелким шрифтов в конце дополнительного сообщения.
Обратите внимание, возможны только следующие виды дат:
- 2022-05-14 (предпочтительно)
- 1 мая 2015
- 01 мая 2015
- Стандартные англоязычные даты для обработки
{{#time: }}
Также указание этого параметра включает категоризацию по времени, если параметр #cat определен.
cat[править]
Этот параметр определяет по-месячную категорию для статей. Если |cat=КАТЕГОРИЯ
тогда:
- статьи будут помещены в категорию Категория: КАТЕГОРИЯ с ДАТЫ если
|date=ДАТА
указан. - статьи будут помещены в категорию Категория: КАТЕГОРИЯ если дата не указана.
Например, для шаблона {{Маргинальные теории}} указана категория |cat=Википедия:Статьи, подозреваемые в наличии оригинальных исследований
, и поэтому статья с шаблоном {{Маргинальные теории|date=12 января 2013}}
будет помещена в категорию Категория:Википедия:Статьи, подозреваемые в наличии оригинальных исследований с января 2013 года.
В параметре cat не должно быть ссылок, и префикса Category:
или Категория:
.
all[править]
Параметр all определяет категорию, в которую должны быть включены все статьи не зависимо от даты.
В параметре all не должно быть ссылок, и префикса Category:
или Категория:
.
Дополнительные параметры[править]
Параметры[править]
Список всех параметров:
imageright[править]
С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра |image=
, за исключением того, что по умолчанию изображение отсутствует.
class[править]
Пользовательские классы CSS для применения к сообщению. Если вы добавляете несколько классов, они должны быть разделены пробелом.
style and textstyle[править]
Дополнительные значения CSS могут быть определены без кавычек " "
, но с завершающими точками с запятой ;
.
|style=
— определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна.|textstyle=
— относится к текстовой ячейке.
issue and fix[править]
Вместо указания |text=
и |text-small=
можно использовать параметр |issue=
.
Индивидуальный текст для малого формата может быть определен с помощью |fix=
.
Параметры миниатюризации[править]
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.
plainlinks[править]
Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например: Example.com. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например: Example.com. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте |plainlinks=no
.
cat2, cat3, all2, and all3[править]
|cat2=
и|cat3=
предусматривают дополнительные помесячные категории; см. #cat.|all2=
и|all3=
предусматривают дополнительные категории, в которые помещаются все статьи, как и в #all.
Технические детали[править]
Если вам необходимо использовать специальные символы внутри параметра |text=
, то вам необходимо заменять их ESC-последовательностями:
{{ombox
| text = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>.
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
- Этот шаблон использует
ombox
CSS-классы в MediaWiki:Common.css влияющие на его внешний вид, то есть он полностью перенастраиваемый.
- Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.
- Теги
<div>
, окружающие текст в приведенном выше примере, обычно не нужны. Но если текст содержит разрыв строки или строк, то иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных списков. Используйте теги<div>
, чтобы исправить такое поведение.
Семейство Mbox[править]
В семействе Module:Message box есть семь меташаблонов:
- {{Ambox}} для сообщений на страницах статей.
- {{Cmbox}} для сообщений на страницах категорий.
- {{Imbox}} для сообщений на страницах файлов (изображений).
- {{Tmbox}} для сообщений на страницах обсуждения.
- {{Fmbox}} для сообщений верхнего и нижнего интерфейса сайта.
- {{Ombox}} для сообщений на других типах страниц.
- {{Mbox}}, для сообщений, которые используются в разных пространствах имен и соответствующим образом изменяют их дизайн.
Тесно связанные меташаблоны:
- {{Asbox}} для сообщений в заготовках статей.
- {{Неоднозначность}}, для сообщений на страницах устранения неоднозначности.