Шаблон:Fmbox/Документация
Этот шаблон реализован на основе Lua с использованием модуля Message box. |
{{Fmbox}}, название сокращено от footer and header message box — меташаблон различных шаблонов-сообщений для формирования системных сообщений, например, MediaWiki:Sp-contributions-footer-anon и эдитнотисов.
Похож на шаблон {{Ambox}} и использует такие же параметры. Основное его отличие в том, что его ширина равна 100 % ширины страницы, на которой он помещён.
Параметры
правитьtype
правитьТипы меняют внешний вид шаблона:
type=warning — предупреждения. |
type=editnotice — информационные сообщения с прозрачным фоном. |
type=system — информационные сообщения на светло-сером фоне (по умолчанию). |
Комбинация параметров
правитьЭтот параметр позволяет изменить картинку шаблона:
Не заданы параметры type и image (по умолчанию) |
Не заданы параметр type и image=none — значок не показывается и текст занимает всю ширину окна сообщения. |
image = [[Файл:User-info.svg|40px]] imageright = [[Файл:Nuvola apps bookcase.svg|40px]] |
image
правитьВы можете выбрать уникальное изображение для шаблона, используя параметр image. Значение параметра |image=
должно иметь тот же синтаксис, как и при вставке изображения в статью (Википедия:Иллюстрирование#Вставка файла в статью). В стандарте, ширина — 40-50px. Например:
- Для MediaWiki:Linkshere указано изображение
|image=[[File:OOjs_UI_icon_information.svg|20px|link=|alt=]]
:
Помните, что при определении статей-сирот учитываются не все ссылки, ведущие на статью. |
Пожалуйста, учтите:
- Если изображение не указано, то оно будет зависеть от параметра 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=
.
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}} для сообщений, которые используются в разных пространствах имен и соответствующим образом изменяют их дизайн.
Тесно связанные меташаблоны:
- {{Asbox}} для сообщений в заготовках статей.
- {{Неоднозначность}}, для сообщений на страницах устранения неоднозначности.