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

Материал из Народные сказки
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
 
(не показаны 3 промежуточные версии этого же участника)
Строка 3: Строка 3:
{{Используйте песочницу}}
{{Используйте песочницу}}
{{OnLua|Message box}}
{{OnLua|Message box}}
{{Mbox templates|nocat=1}}
{{Список шаблонов семейства Mbox|nocat=1}}
'''{{T|Fmbox}}''', название сокращено от '''''f'''ooter and header '''m'''essage '''box''''' — меташаблон различных шаблонов-сообщений для формирования системных сообщений, например, [[MediaWiki:Sp-contributions-footer-anon]] и [[Википедия:Editnotice|эдитнотисов]].
'''{{T|Fmbox}}''', название сокращено от '''''f'''ooter and header '''m'''essage '''box''''' — меташаблон различных шаблонов-сообщений для формирования системных сообщений, например, [[MediaWiki:Sp-contributions-footer-anon]] и [[Википедия:Editnotice|эдитнотисов]].


Строка 12: Строка 12:
=== ''type'' ===
=== ''type'' ===
Типы меняют внешний вид шаблона:
Типы меняют внешний вид шаблона:
{{fmbox
{{Fmbox
| type = warning
| type = warning
| text = type=<u>warning</u> — предупреждения.
| text = type=<u>warning</u> — предупреждения.
}}
}}


{{fmbox
{{Fmbox
| type = editnotice
| type = editnotice
| text = type=<u>editnotice</u> — информационные сообщения с прозрачным фоном.
| text = type=<u>editnotice</u> — информационные сообщения с прозрачным фоном.
}}
}}


{{fmbox
{{Fmbox
| type = system
| type = system
| text = type=<u>system</u> — информационные сообщения на светло-сером фоне (по умолчанию).
| text = type=<u>system</u> — информационные сообщения на светло-сером фоне (по умолчанию).
Строка 30: Строка 30:
Этот параметр позволяет изменить картинку шаблона:
Этот параметр позволяет изменить картинку шаблона:


{{fmbox
{{Fmbox
| text = Не заданы параметры type и image (по умолчанию)
| text = Не заданы параметры type и image (по умолчанию)
}}
}}
{{fmbox
{{Fmbox
| image = none
| image = none
| text  = Не заданы параметр type и '''image=none''' — значок не показывается и текст занимает всю ширину окна сообщения.
| text  = Не заданы параметр type и '''image=none''' — значок не показывается и текст занимает всю ширину окна сообщения.
}}
}}
{{fmbox
{{Fmbox
| image      = [[Файл:User-info.svg|40px]]
| image      = [[Файл:User-info.svg|40px]]
| imageright = [[Файл:Nuvola apps bookcase.svg|40px]]
| imageright = [[Файл:Nuvola apps bookcase.svg|40px]]
Строка 44: Строка 44:


=== ''image'' ===
=== ''image'' ===
Вы можете выбрать уникальное изображение для шаблона, используя параметр ''image''. Значение параметра {{para|image}} должно иметь тот же синтаксис, как и при вставке изображения в статью ([[Википедия:Иллюстрирование#Вставка файла в статью]]). В стандарте, ширина — 40-50px. Например:
Вы можете выбрать уникальное изображение для шаблона, используя параметр ''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}}, то никакое изображение выводится не будет, и текст займет всю площадь шаблона.
* Если указано {{Para|image|none}}, то никакое изображение выводится не будет, и текст займет всю площадь шаблона.
* Если изображение выполняет чисто декоративную функцию, '''а также''' находится в [[Википедия:Правила использования изображений#Лицензия|общественном достоянии]], удобство и [[:en:Wikipedia:Manual of Style/Accessibility|доступность]] использования шаблоны может быть улучшена с помощью подавления ссылки на файл с помощью добавления параметров {{para|link}} и {{para|alt}}, как показано выше.
* Если изображение выполняет чисто декоративную функцию, '''а также''' находится в [[Википедия:Правила использования изображений#Лицензия|общественном достоянии]], удобство и [[: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|<nowiki>{{{talk|}}}</nowiki>}}.


Примеры использования параметра редакторами:
Примеры использования параметра редакторами:
* {{para|talk|ЗАГОЛОВОК СЕКЦИИ}} — ссылка отправит читателя в необходимую секцию на странице обсуждения статьи. Пример — {{para|talk|Foo}}.
* {{Para|talk|ЗАГОЛОВОК СЕКЦИИ}} — ссылка отправит читателя в необходимую секцию на странице обсуждения статьи. Пример — {{Para|talk|Foo}}.
* {{para|talk|ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ}} — шаблон выдаст ссылку на указанную страницу обсуждения (может содержать [[Википедия:Как править статьи#Ссылки, URL|ссылку на секцию]]), например {{para|talk|Обсуждение:Banana#Foo}}.
* {{Para|talk|ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ}} — шаблон выдаст ссылку на указанную страницу обсуждения (может содержать [[Википедия:Как править статьи#Ссылки, URL|ссылку на секцию]]), например {{Para|talk|Обсуждение:Banana#Foo}}.


Примечания:
Примечания:
* При использовании этого параметра при создании шаблона, то ссылка на страницу обсуждения будет появляться и в самом шаблоне (для того, чтобы продемонстрировать функциональность), но на страницах она будет отображаться, только если параметр фактически указан.
* При использовании этого параметра при создании шаблона, то ссылка на страницу обсуждения будет появляться и в самом шаблоне (для того, чтобы продемонстрировать функциональность), но на страницах она будет отображаться, только если параметр фактически указан.
* Чтобы быть уверенным, что ссылка на страницу обсуждения постоянно показывается, вы можете использовать следующую конструкцию: {{para|talk|<nowiki>{{{talk|#}}}</nowiki>}}.
* Чтобы быть уверенным, что ссылка на страницу обсуждения постоянно показывается, вы можете использовать следующую конструкцию: {{Para|talk|<nowiki>{{{talk|#}}}</nowiki>}}.
* Строка не будет отображаться, если ''страницы обсуждения статьи'' или ''указанной страницы обсуждения'' не существует, и не важно, что вы укажете в параметре.
* Строка не будет отображаться, если ''страницы обсуждения статьи'' или ''указанной страницы обсуждения'' не существует, и не важно, что вы укажете в параметре.


Строка 88: Строка 88:


=== ''cat'' ===
=== ''cat'' ===
Этот параметр определяет помесячную категорию для статей. Если {{para|cat|КАТЕГОРИЯ}} тогда:
Этот параметр определяет помесячную категорию для статей. Если {{Para|cat|КАТЕГОРИЯ}} тогда:
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ с ДАТЫ''' если {{para|date|ДАТА}} указан.
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ с ДАТЫ''' если {{Para|date|ДАТА}} указан.
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ''' если дата не указана.
* статьи будут помещены в категорию '''Категория: КАТЕГОРИЯ''' если дата не указана.


Например, для шаблона {{Tl|Маргинальные теории}} указана категория {{Para|cat|Википедия:Статьи, подозреваемые в наличии оригинальных исследований}}, и поэтому статья с шаблоном {{Tlx|Маргинальные теории|2=date=12 января 2013}} будет помещена в категорию [[:Категория:Википедия:Статьи, подозреваемые в наличии оригинальных исследований с января 2013 года]].
Например, для шаблона {{Tl|Маргинальные теории}} указана категория {{Para|cat|Википедия:Статьи, подозреваемые в наличии оригинальных исследований}}, и поэтому статья с шаблоном {{Tcl|Маргинальные теории|2=date=12 января 2013}} будет помещена в категорию [[:Категория:Википедия:Статьи, подозреваемые в наличии оригинальных исследований с января 2013 года]].


В параметре ''cat'' не должно быть ссылок, и префикса <code>Category:</code> или <code>Категория:</code>.
В параметре ''cat'' не должно быть ссылок, и префикса <code>Category:</code> или <code>Категория:</code>.
Строка 107: Строка 107:


=== ''imageright'' ===
=== ''imageright'' ===
С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра {{para|image}}, за исключением того, что по умолчанию изображение отсутствует.
С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра {{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|style}} — определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна.
* {{para|textstyle}} — относится к текстовой ячейке.
* {{Para|textstyle}} — относится к текстовой ячейке.


=== ''issue'' and ''fix'' ===
=== ''issue'' and ''fix'' ===
Вместо указания {{para|text}} и {{para|text-small}} можно использовать параметр {{para|issue}}.
Вместо указания {{Para|text}} и {{Para|text-small}} можно использовать параметр {{Para|issue}}.


Индивидуальный текст для малого формата может быть определён с помощью {{para|fix}}.
Индивидуальный текст для малого формата может быть определён с помощью {{Para|fix}}.


=== ''plainlinks'' ===
=== ''plainlinks'' ===
Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например: [http://www.example.com Example.com]. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например: <span class="plainlinks">[http://www.example.com Example.com]</span>. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте {{para|plainlinks|no}}.
Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например: [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|cat2}} и {{Para|cat3}} предусматривают дополнительные помесячные категории; см. [[#cat]].
* {{para|all2}} и {{para|all3}} предусматривают дополнительные категории, в которые помещаются все статьи, как и в [[#all]].
* {{Para|all2}} и {{Para|all3}} предусматривают дополнительные категории, в которые помещаются все статьи, как и в [[#all]].


== Технические детали ==
== Технические детали ==
Если вам необходимо использовать специальные символы внутри параметра {{para|text}}, то вам необходимо заменять их ESC-последовательностями:
Если вам необходимо использовать специальные символы внутри параметра {{Para|text}}, то вам необходимо заменять их ESC-последовательностями:


<syntaxhighlight lang="wikitext">
<syntaxhighlight lang="wikitext">
{{fmbox
{{Fmbox
| text  = <div>
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.   
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.   
Строка 142: Строка 142:
</syntaxhighlight>
</syntaxhighlight>


{{fmbox
{{Fmbox
| text = <div>
| text = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
Строка 150: Строка 150:
}}
}}


* Этот шаблон использует <code>fmbox</code> [[CSS]]-классы в [[MediaWiki:Common.css]] влияющие на его внешний вид, то есть он полностью перенастраиваемый.
* Этот шаблон использует <code>Fmbox</code> [[CSS]]-классы в [[MediaWiki:Common.css]] влияющие на его внешний вид, то есть он полностью перенастраиваемый.


* Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование [[ВП:ПАРС|функций парсера]] и специальных символов в параметрах.
* Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование [[ВП:ПАРС|функций парсера]] и специальных символов в параметрах.

Текущая версия от 18:00, 15 мая 2023

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

{{Fmbox}}, название сокращено от footer and header message box — меташаблон различных шаблонов-сообщений для формирования системных сообщений, например, MediaWiki:Sp-contributions-footer-anon и эдитнотисов.

Похож на шаблон {{Ambox}} и использует такие же параметры. Основное его отличие в том, что его ширина равна 100 % ширины страницы, на которой он помещён.

Параметры

type

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

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

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

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

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

Также указание этого параметра включает категоризацию по времени, если параметр #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}}, для сообщений, которые используются в разных пространствах имён и соответствующим образом изменяют их дизайн.

Тесно связанные меташаблоны:

  • {{Stub-meta}} для сообщений в заготовках статей.
  • {{Неоднозначность}}, для сообщений на страницах устранения неоднозначности.