Шаблон:Ombox/doc: различия между версиями

Материал из wikixw
Перейти к навигации Перейти к поиску
(Перенаправление на Шаблон:Стили шаблона/doc)
Метка: новое перенаправление
 
Нет описания правки
 
(не показаны 2 промежуточные версии этого же участника)
Строка 1: Строка 1:
#перенаправление [[Шаблон:Стили шаблона/doc]]
{{docpage}}
{{СИШ}}
{{Используйте песочницу}}
{{onLua|Message box}}
{{Mbox templates|nocat=1}}
'''{{t|Ombox}}''', название сокращенно от '''''o'''ther pages '''m'''essage '''box''''' — меташаблон различных шаблонов-сообщений в пространствах «Участник», «Википедия», «Шаблон», «Справка», и других, которые не покрываются шаблонами {{t|ambox}}, {{t|tmbox}}, {{t|imbox}} или {{t|cmbox}}. Поэтому он '''не должен''' использоваться в статьях, страницах обсуждения, файлах и категориях.
 
Похож на шаблон {{tl|Ambox}} и использует такие же параметры.
 
== Параметры ==
 
=== ''type'' ===
Типы меняют внешний вид шаблона:
{{ombox
| type = speedy
| text = {{code|type{{=}}speedy}} — предупреждение о выставлении на быстрое удаление.
}}
{{ombox
| type = delete
| text = {{code|type{{=}}delete}} — предупреждение о выставлении на удаление.
}}
{{ombox
| type = content
| text = {{code|type{{=}}content}} — важное предупреждение или предостережение.
}}
{{ombox
| type = style
| text = {{code|type{{=}}style}} — обычное предупреждение или предостережение.
}}
{{ombox
| type = notice
| text = {{code|type{{=}}notice}} — информационное сообщение.
}}
{{ombox
| type = move
| text = {{code|type{{=}}move}} — сообщение о перемещении, слиянии или разделении.
}}
{{ombox
| type = protection
| text = {{code|type{{=}}protection}} — сообщение о защите страницы.
}}
 
 
 
=== Комбинация параметров ===
Этот параметр позволяет изменить картинку шаблона:
 
{{ombox
| text  = Не заданы параметры type и image.
}}
{{ombox
| image = none
| text  =  Не заданы параметр type и '''image=none'''.
}}
{{ombox
| image = [[Файл:Gnome globe current event.svg|42px]]
| imageright = [[Файл:Nuvola apps bookcase.svg|40px]]
| text  = image = <nowiki>[[Файл:Gnome globe current event.svg|42px]]</nowiki> <br> imageright = <nowiki>[[Файл:Nuvola apps bookcase.svg|40px]]</nowiki>
}}
{{ombox
| type      = notice
| image      = [[Файл:Yes_check.svg|30px]]
| imageright =
| text      = '''Эта страница является частью [[:Категория:Википедия:Правила и руководства|правил и руководств]] русской Википедии.'''<br>
Изложенному здесь должны следовать все участники. Прежде чем редактировать, убедитесь, что вносимые изменения соответствуют [[Википедия:Консенсус|консенсусу]]. Если есть сомнения, обсудите на [[Википедия:Форум/Правила|форуме]] или [[{{TALKPAGENAME}}|странице обсуждения]].
}}
{{ombox
| type      = notice
| image      = [[Файл:Nutshell.png|30px]]
| text      =
'''В двух словах:''' Этот шаблон используется для отображения информационного сообщения на страницах, '''не являющихся''' статьёй, страницей обсуждения, файлом или категорией.
}}
 
=== ''image'' ===
Вы можете выбрать уникальное изображение для шаблона, использую параметр ''image''. Значение параметра {{para|image}} должно иметь тот же синтаксис, как и при вставке изображения в статью ([[Википедия:Иллюстрирование#Вставка файла в статью]]). В стандарте, ширина — 40-50px. Например:
 
* Для {{Tl|Правило}} указано изображение {{Para|image|<nowiki>[[Файл:OOjs UI icon check-constructive.svg|40px|alt=✔|link=]]</nowiki>}}:
{{Правило|date={{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY}}|nocat=1}}
 
Пожалуйста, учтите:
* Если изображение не указано, то оно будет зависеть от параметра ''type''. (Смотрите о параметре [[#type]] выше.)
* Если указано {{para|image|none}}, то никакое изображение выводится не будет, и текст займет всю площадь шаблона.
* Если изображение выполняет чисто декоративную функцию, '''а также''' находится в [[Википедия:Правила использования изображений#Лицензия|общественном достоянии]], удобство и [[:en:Wikipedia:Manual of Style/Accessibility|доступность]] использования шаблоны может быть улучшена с помощью подавления ссылки на файл с помощью добавления параметров {{para|link}} и {{para|alt}}, как показано выше.
 
=== ''text'', и ''text-small'' ===
Параметр ''text'' передает основной текст в шаблон. Постарайтесь сделать его как можно более кратким и понятным.
 
Параметр ''text-small'' показывает текст маленьким шрифт, не рекомендуем его использовать для файлов.
 
=== ''talk'' ===
Некоторые шаблоны-сообщения содержат ссылку на страницу обсуждения, и позволяют редактору уточнить заголовок необходимой секции для ссылки. Чтобы добиться такой функциональности, просто укажите при создании шаблона {{para|talk|<nowiki>{{{talk|}}}</nowiki>}}.
 
Примеры использования параметра редакторами:
* {{para|talk|ЗАГОЛОВОК СЕКЦИИ}} — ссылка отправит читателя в необходимую секцию на странице обсуждения статьи. Пример — {{para|talk|Foo}}.
* {{para|talk|ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ}} — шаблон выдаст ссылку на указанную страницу обсуждения (может содержать [[Википедия:Как править статьи#Ссылки, URL|ссылку на секцию]]), например {{para|talk|Обсуждение:Banana#Foo}}.
 
Примечания:
* При использовании этого параметра при создании шаблона, то ссылка на страницу обсуждения будет появляться и в самом шаблоне (для того, чтобы продемонстрировать функциональность), но на страницах она будет отображаться, только если параметр фактически указан.
* Чтобы быть уверенным, что ссылка на страницу обсуждения постоянно показывается, вы можете использовать следующую конструкцию: {{para|talk|<nowiki>{{{talk|#}}}</nowiki>}}.
* Строка не будет отображаться если ''страницы обсуждения статьи'', или ''указанной страницы обсуждения'' не существует, и неважно что вы укажете в параметре.
 
=== ''date'' ===
Установка параметра ''date'' сообщает мета-шаблону, что в шаблон-сообщение был установлен в этот день: устанавливается как редакторами, так и [[ВП:Боты|ботами]]. Отображается мелким шрифтов в конце дополнительного сообщения.
 
'''Обратите внимание''', возможны только следующие виды дат:
* 2022-05-14 (предпочтительно)
* 1 мая 2015
* 01 мая 2015
* [[mw:Help:Extension:ParserFunctions#.23time|Стандартные англоязычные даты]] для обработки <code><nowiki>{{#time: }}</nowiki></code>
 
Также указание этого параметра включает категоризацию по времени, если параметр ''[[#cat]]'' определен.
 
=== ''cat'' ===
Этот параметр определяет по-месячную категорию для статей. Если {{para|cat|КАТЕГОРИЯ}} тогда:
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ с ДАТЫ''' если {{para|date|ДАТА}} указан.
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ''' если дата не указана.
 
Например, для шаблона {{Tl|Маргинальные теории}} указана категория {{Para|cat|Википедия:Статьи, подозреваемые в наличии оригинальных исследований}}, и поэтому статья с шаблоном {{Tlx|Маргинальные теории|2=date=12 января 2013}} будет помещена в категорию [[:Категория:Википедия:Статьи, подозреваемые в наличии оригинальных исследований с января 2013 года]].
 
В параметре ''cat'' не должно быть ссылок, и префикса <code>Category:</code> или <code>Категория:</code>.
 
=== ''all'' ===
Параметр ''all'' определяет категорию, в которую должны быть включены все статьи не зависимо от даты.
 
В параметре ''all'' не должно быть ссылок, и префикса <code>Category:</code> или <code>Категория:</code>.
 
== Дополнительные параметры ==
 
=== Параметры ===
Список всех параметров:
 
=== ''imageright'' ===
С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра {{para|image}}, за исключением того, что по умолчанию изображение отсутствует.
 
=== ''class'' ===
Пользовательские классы [[Каскадные таблицы стилей|CSS]] для применения к сообщению. Если вы добавляете несколько классов, они должны быть разделены пробелом.
 
=== ''style'' and ''textstyle'' ===
Дополнительные значения CSS могут быть определены без кавычек <code>" "</code>, но с завершающими точками с запятой <code>;</code>.
* {{para|style}} — определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна.
* {{para|textstyle}} — относится к текстовой ячейке.
 
=== ''issue'' and ''fix'' ===
Вместо указания {{para|text}} и {{para|text-small}} можно использовать параметр {{para|issue}}.
 
Индивидуальный текст для малого формата может быть определен с помощью {{para|fix}}.
 
=== Параметры миниатюризации ===
 
{{ombox
| small = yes
| text = small = yes
}}
{{ombox
| type = style
| small = yes
| text = type = style <br> small = yes
}}
==== small ====
: '''yes''' = Создаёт маленькое окно сообщения, прикрепляющееся к правому краю страницы. Этот параметр также уменьшает значок по умолчанию. Обратите внимание, что данные, переданные в параметрах '''smallimage''', '''smallimageright''' и '''smalltext''', используются, только если «small=yes». Чтобы производный шаблон понимал параметр small, используйте следующий код:
:: <code><nowiki>small = {{{small|}}}</nowiki></code>
 
{{ombox
| small = yes
| image      = [[Файл:Nuvola apps bookcase.png|40px]]
| smallimage = [[Файл:Nuvola apps bookcase.png|30px]]
| text =
small = yes <br> image = <nowiki>[[Файл:Nuvola apps bookcase.png|40px]]</nowiki> <br> smallimage = <nowiki>[[Файл:Nuvola apps bookcase.png|30px]]</nowiki>
}}
==== smallimage ====
: '''нет параметра''' = если параметр '''smallimage''' не задан, то опять используется параметр '''image'''. Если параметр '''image''' также пустой, то используется маленький значок по умолчанию.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Обычно около 20px для сообщений в одну строку и до 25px в ширину для двух строк текста. Например:
:: <code><nowiki>smallimage = [[Файл:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]</nowiki></code>
: '''none''' = обозначает, что не нужно отображать значок. Переопределяет заданное в параметре '''image''', когда «small=left».
 
{{ombox
| small = yes
| imageright = [[Файл:Nuvola apps bookcase.png|40px]]
| text =
small = yes <br> imageright = <nowiki>[[Файл:Nuvola apps bookcase.png|40px]]</nowiki>
}}
{{ombox
| small = yes
| imageright = [[Файл:Nuvola apps bookcase.png|30px]]
| smallimageright = none
| text =
small = yes <br> imageright = <nowiki>[[Файл:Nuvola apps bookcase.png|40px]]</nowiki> <br> smallimageright = none
}}
==== smallimageright ====
: '''нет параметра''' = если параметр '''smallimageright''' не задан, то опять используется параметр '''imageright'''. Если параметр '''imageright''' также пустой, то используется значок справа не показывается.
: '''файл изображения''' = ссылка на файл, использующая вики разметку. Около 30px в ширину. Например:
:: <code><nowiki>smallimageright = [[Файл:Nuvola apps bookcase.png|30px|alt=Three stacked books]]</nowiki></code>
: '''одругое''' = всё, что вы хотите отобразить справа.
: '''none''' = обозначает, что не нужно отображать значок справа. Переопределяет заданное в параметре '''imageright''', когда «small=yes».
 
==== smalltext ====
: Краткий вариант текста сообщения. Если параметр '''smalltext''' не задан, то используется параметр '''text'''.
 
=== ''plainlinks'' ===
Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например: [http://www.example.com Example.com]. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например: <span class="plainlinks">[http://www.example.com Example.com]</span>. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте {{para|plainlinks|no}}.
 
=== ''cat2'', ''cat3'', ''all2'', and ''all3'' ===
* {{para|cat2}} и {{para|cat3}} предусматривают дополнительные помесячные категории; см. [[#cat]].
* {{para|all2}} и {{para|all3}} предусматривают дополнительные категории, в которые помещаются все статьи, как и в [[#all]].
 
== Технические детали ==
Если вам необходимо использовать специальные символы внутри параметра {{para|text}}, то вам необходимо заменять их ESC-последовательностями:
 
<syntaxhighlight lang="wikitext">
{{ombox
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. 
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>.
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
</syntaxhighlight>
 
{{ombox
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
А здесь знак разделения параметров {{!}} и две фигурные скобки <nowiki>}}</nowiki>.
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
 
* Этот шаблон использует <code>ombox</code> [[CSS]]-классы в [[MediaWiki:Common.css]] влияющие на его внешний вид, то есть он полностью перенастраиваемый.
 
* Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование [[ВП:ПАРС|функций парсера]] и специальных символов в параметрах.
 
* Теги <code><nowiki><div></nowiki></code>, окружающие текст в приведенном выше примере, обычно не нужны. Но если текст содержит разрыв строки или строк, то иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных списков. Используйте теги <code><nowiki><div></nowiki></code>, чтобы исправить такое поведение.
 
== Семейство Mbox ==
{{Mbox/doc/номенклатура}}
 
<includeonly>
[[Категория:Шаблоны-сообщения семейства Mbox]]
</includeonly>

Текущая версия от 22:06, 28 июня 2023

Мета-шаблоны
блоков сообщений

{{Ombox}}, название сокращенно от other pages message box — меташаблон различных шаблонов-сообщений в пространствах «Участник», «Википедия», «Шаблон», «Справка», и других, которые не покрываются шаблонами {{ambox}}, {{tmbox}}, {{imbox}} или {{cmbox}}. Поэтому он не должен использоваться в статьях, страницах обсуждения, файлах и категориях.

Похож на шаблон {{Ambox}} и использует такие же параметры.

Параметры[править]

type[править]

Типы меняют внешний вид шаблона:


Комбинация параметров[править]

Этот параметр позволяет изменить картинку шаблона:

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

Обратите внимание, возможны только следующие виды дат:

Также указание этого параметра включает категоризацию по времени, если параметр #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 = Создаёт маленькое окно сообщения, прикрепляющееся к правому краю страницы. Этот параметр также уменьшает значок по умолчанию. Обратите внимание, что данные, переданные в параметрах smallimage, smallimageright и smalltext, используются, только если «small=yes». Чтобы производный шаблон понимал параметр small, используйте следующий код:
small = {{{small|}}}

smallimage[править]

нет параметра = если параметр smallimage не задан, то опять используется параметр image. Если параметр image также пустой, то используется маленький значок по умолчанию.
файл изображения = ссылка на файл использующая вики разметку. Обычно около 20px для сообщений в одну строку и до 25px в ширину для двух строк текста. Например:
smallimage = [[Файл:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]
none = обозначает, что не нужно отображать значок. Переопределяет заданное в параметре image, когда «small=left».

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}} для сообщений в заготовках статей.
  • {{Неоднозначность}}, для сообщений на страницах устранения неоднозначности.