Шаблон:Fmbox/doc: различия между версиями
Andras (обсуждение | вклад) Нет описания правки |
Andras (обсуждение | вклад) Нет описания правки |
||
Строка 44: | Строка 44: | ||
=== ''image'' === | === ''image'' === | ||
Вы можете выбрать уникальное изображение для шаблона, используя параметр ''image''. Значение параметра {{ | Вы можете выбрать уникальное изображение для шаблона, используя параметр ''image''. Значение параметра {{Para|image}} должно иметь тот же синтаксис, как и при вставке изображения в статью ([[Википедия:Иллюстрирование#Вставка файла в статью]]). В стандарте, ширина — 40-50px. Например: | ||
* Для [[MediaWiki:Linkshere]] указано изображение {{Para|image|<nowiki>[[File:OOjs_UI_icon_information.svg|20px|link=|alt=]]</nowiki>}}: | * Для [[MediaWiki:Linkshere]] указано изображение {{Para|image|<nowiki>[[File:OOjs_UI_icon_information.svg|20px|link=|alt=]]</nowiki>}}: | ||
Строка 56: | Строка 56: | ||
Пожалуйста, учтите: | Пожалуйста, учтите: | ||
* Если изображение не указано, то оно будет зависеть от параметра ''type''. (Смотрите о параметре [[#type]] выше.) | * Если изображение не указано, то оно будет зависеть от параметра ''type''. (Смотрите о параметре [[#type]] выше.) | ||
* Если указано {{ | * Если указано {{Para|image|none}}, то никакое изображение выводится не будет, и текст займет всю площадь шаблона. | ||
* Если изображение выполняет чисто декоративную функцию, '''а также''' находится в [[Википедия:Правила использования изображений#Лицензия|общественном достоянии]], удобство и [[:en:Wikipedia:Manual of Style/Accessibility|доступность]] использования шаблоны может быть улучшена с помощью подавления ссылки на файл с помощью добавления параметров {{ | * Если изображение выполняет чисто декоративную функцию, '''а также''' находится в [[Википедия:Правила использования изображений#Лицензия|общественном достоянии]], удобство и [[:en:Wikipedia:Manual of Style/Accessibility|доступность]] использования шаблоны может быть улучшена с помощью подавления ссылки на файл с помощью добавления параметров {{Para|link}} и {{Para|alt}}, как показано выше. | ||
=== ''text'', и ''text-small'' === | === ''text'', и ''text-small'' === | ||
Строка 65: | Строка 65: | ||
=== ''talk'' === | === ''talk'' === | ||
Некоторые шаблоны-сообщения содержат ссылку на страницу обсуждения и позволяют редактору уточнить заголовок необходимой секции для ссылки. Чтобы добиться такой функциональности, просто укажите при создании шаблона {{ | Некоторые шаблоны-сообщения содержат ссылку на страницу обсуждения и позволяют редактору уточнить заголовок необходимой секции для ссылки. Чтобы добиться такой функциональности, просто укажите при создании шаблона {{Para|talk|<nowiki>{{{talk|}}}</nowiki>}}. | ||
Примеры использования параметра редакторами: | Примеры использования параметра редакторами: | ||
* {{ | * {{Para|talk|ЗАГОЛОВОК СЕКЦИИ}} — ссылка отправит читателя в необходимую секцию на странице обсуждения статьи. Пример — {{Para|talk|Foo}}. | ||
* {{ | * {{Para|talk|ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ}} — шаблон выдаст ссылку на указанную страницу обсуждения (может содержать [[Википедия:Как править статьи#Ссылки, URL|ссылку на секцию]]), например {{Para|talk|Обсуждение:Banana#Foo}}. | ||
Примечания: | Примечания: | ||
* При использовании этого параметра при создании шаблона, то ссылка на страницу обсуждения будет появляться и в самом шаблоне (для того, чтобы продемонстрировать функциональность), но на страницах она будет отображаться, только если параметр фактически указан. | * При использовании этого параметра при создании шаблона, то ссылка на страницу обсуждения будет появляться и в самом шаблоне (для того, чтобы продемонстрировать функциональность), но на страницах она будет отображаться, только если параметр фактически указан. | ||
* Чтобы быть уверенным, что ссылка на страницу обсуждения постоянно показывается, вы можете использовать следующую конструкцию: {{ | * Чтобы быть уверенным, что ссылка на страницу обсуждения постоянно показывается, вы можете использовать следующую конструкцию: {{Para|talk|<nowiki>{{{talk|#}}}</nowiki>}}. | ||
* Строка не будет отображаться, если ''страницы обсуждения статьи'' или ''указанной страницы обсуждения'' не существует, и не важно, что вы укажете в параметре. | * Строка не будет отображаться, если ''страницы обсуждения статьи'' или ''указанной страницы обсуждения'' не существует, и не важно, что вы укажете в параметре. | ||
Строка 88: | Строка 88: | ||
=== ''cat'' === | === ''cat'' === | ||
Этот параметр определяет помесячную категорию для статей. Если {{ | Этот параметр определяет помесячную категорию для статей. Если {{Para|cat|КАТЕГОРИЯ}} тогда: | ||
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ с ДАТЫ''' если {{ | * статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ с ДАТЫ''' если {{Para|date|ДАТА}} указан. | ||
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ''' если дата не указана. | * статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ''' если дата не указана. | ||
Строка 107: | Строка 107: | ||
=== ''imageright'' === | === ''imageright'' === | ||
С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра {{ | С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра {{Para|image}}, за исключением того, что по умолчанию изображение отсутствует. | ||
=== ''class'' === | === ''class'' === | ||
Строка 114: | Строка 114: | ||
=== ''style'' and ''textstyle'' === | === ''style'' and ''textstyle'' === | ||
Дополнительные значения CSS могут быть определены без кавычек <code>" "</code>, но с завершающими точками с запятой <code>;</code>. | Дополнительные значения CSS могут быть определены без кавычек <code>" "</code>, но с завершающими точками с запятой <code>;</code>. | ||
* {{ | * {{Para|style}} — определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна. | ||
* {{ | * {{Para|textstyle}} — относится к текстовой ячейке. | ||
=== ''issue'' and ''fix'' === | === ''issue'' and ''fix'' === | ||
Вместо указания {{ | Вместо указания {{Para|text}} и {{Para|text-small}} можно использовать параметр {{Para|issue}}. | ||
Индивидуальный текст для малого формата может быть определён с помощью {{ | Индивидуальный текст для малого формата может быть определён с помощью {{Para|fix}}. | ||
=== ''plainlinks'' === | === ''plainlinks'' === | ||
Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например: [http://www.example.com Example.com]. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например: <span class="plainlinks">[http://www.example.com Example.com]</span>. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте {{ | Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например: [http://www.example.com Example.com]. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например: <span class="plainlinks">[http://www.example.com Example.com]</span>. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте {{Para|plainlinks|no}}. | ||
=== ''cat2'', ''cat3'', ''all2'', and ''all3'' === | === ''cat2'', ''cat3'', ''all2'', and ''all3'' === | ||
* {{ | * {{Para|cat2}} и {{Para|cat3}} предусматривают дополнительные помесячные категории; см. [[#cat]]. | ||
* {{ | * {{Para|all2}} и {{Para|all3}} предусматривают дополнительные категории, в которые помещаются все статьи, как и в [[#all]]. | ||
== Технические детали == | == Технические детали == | ||
Если вам необходимо использовать специальные символы внутри параметра {{ | Если вам необходимо использовать специальные символы внутри параметра {{Para|text}}, то вам необходимо заменять их ESC-последовательностями: | ||
<syntaxhighlight lang="wikitext"> | <syntaxhighlight lang="wikitext"> | ||
{{ | {{Fmbox | ||
| text = <div> | | text = <div> | ||
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. | Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. |
Версия от 22:25, 13 мая 2023
![]() |
![]() | Внимание! Это один из самых используемых шаблонов. |
![]() | Прежде чем вносить какие-либо изменения в данный шаблон, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. Изменения могут быть внесены после этого в данный шаблон всего одной правкой. |
![]() | Этот шаблон реализован на основе Lua с использованием модуля Message box. |
{{Fmbox}}, название сокращено от footer and header message box — меташаблон различных шаблонов-сообщений для формирования системных сообщений, например, MediaWiki:Sp-contributions-footer-anon и эдитнотисов.
Похож на шаблон {{Ambox}} и использует такие же параметры. Основное его отличие в том, что его ширина равна 100 % ширины страницы, на которой он помещён.
Параметры
type
Типы меняют внешний вид шаблона: Шаблон:fmbox
Комбинация параметров
Этот параметр позволяет изменить картинку шаблона:
Шаблон:fmbox Шаблон:fmbox Шаблон:fmbox
image
Вы можете выбрать уникальное изображение для шаблона, используя параметр image. Значение параметра |image =
должно иметь тот же синтаксис, как и при вставке изображения в статью (Википедия:Иллюстрирование#Вставка файла в статью). В стандарте, ширина — 40-50px. Например:
- Для MediaWiki:Linkshere указано изображение
|image = [[File:OOjs_UI_icon_information.svg|20px|link=|alt=]]
:
Файл:OOjs UI icon information.svg | Помните, что при определении статей-сирот учитываются не все ссылки, ведущие на статью. |
Пожалуйста, учтите:
- Если изображение не указано, то оно будет зависеть от параметра 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 = Википедия:Статьи, подозреваемые в наличии оригинальных исследований
, и поэтому статья с шаблоном Шаблон:Tlx будет помещена в категорию Категория:Википедия:Статьи, подозреваемые в наличии оригинальных исследований с января 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 =
.
plainlinks
Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например: Example.com. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например: Example.com. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте |plainlinks = no
.
cat2, cat3, all2, and all3
|cat2 =
и|cat3 =
предусматривают дополнительные помесячные категории; см. #cat.|all2 =
и|all3 =
предусматривают дополнительные категории, в которые помещаются все статьи, как и в #all.
Технические детали
Если вам необходимо использовать специальные символы внутри параметра |text =
, то вам необходимо заменять их ESC-последовательностями:
{{Fmbox
| text = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>.
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
- Этот шаблон использует
fmbox
CSS-классы в MediaWiki:Common.css влияющие на его внешний вид, то есть он полностью перенастраиваемый.
- Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.
- Теги
<div>
, окружающие текст в приведённом выше примере, обычно не нужны. Но если текст содержит разрыв строки или строк, то иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных списков. Используйте теги<div>
, чтобы исправить такое поведение.
Семейство Mbox
В семействе Module:Message box есть семь меташаблонов:
- {{Ambox}} для сообщений на страницах статей.
- {{Cmbox}} для сообщений на страницах категорий.
- {{Imbox}} для сообщений на страницах файлов (изображений).
- {{Tmbox}} для сообщений на страницах обсуждения.
- {{Fmbox}} для сообщений верхнего и нижнего интерфейса сайта.
- {{Ombox}} для сообщений на других типах страниц.
- {{Mbox}}, для сообщений, которые используются в разных пространствах имён и соответствующим образом изменяют их дизайн.
Тесно связанные меташаблоны:
- {{Stub-meta}} для сообщений в заготовках статей.
- {{Неоднозначность}}, для сообщений на страницах устранения неоднозначности.