Interested Article - Cmbox
- 2021-12-12
- 1
|
Этот шаблон используется на многих страницах, поэтому изменения в нём будут заметны многим. Пожалуйста, протестируйте любые изменения в песочнице или на вашей личной подстранице. Рассмотрите возможность обсуждения изменений на
или
форуме
перед их внесением.
. |
Прежде чем вносить какие-либо изменения в этот шаблон, просьба
оттестировать
их в
/песочнице
и проверить результат на странице с
/контрольными примерами
. Вносить тестированные изменения в этот шаблон следует ровно одной правкой.
|
Этот шаблон реализован на основе
Lua
с использованием модуля
Message box
.
|
{{ Cmbox }} , название сокращенно от c ategory m essage box — меташаблон различных шаблонов-сообщений для категорий , таких как шаблон {{ Категория для распределения }} . Он предлагает несколько различных цветов, изображений и некоторых других функций.
Похож на шаблон {{ Ambox }} и использует такие же параметры.
Использование
{{Cmbox | name = | subst = <includeonly>{{subst:проверка подстановки}}</includeonly> | type = | image = | text = | talk = {{{talk|}}} | text-small = | date = {{{date|}}} | cat = | all = | data-label-1 = Название атрибута "data-???" для JavaScript | data-value-1 = Значение атрибута "data-???" для JavaScript | data-label-2 = Название атрибута "data-???" для JavaScript | data-value-2 = Значение атрибута "data-???" для JavaScript | data-label-3 = Название атрибута "data-???" для JavaScript | data-value-3 = Значение атрибута "data-???" для JavaScript }}<noinclude>{{doc}}</noinclude>
Не рекомендуется использовать данную заготовку, так как в обычном виде большинство параметров не используются.
{{Cmbox | name = | subst = <includeonly>{{subst:substcheck}}</includeonly> | small = {{{small|}}} | type = | image = | imageright = | smallimage = | smallimageright = | class = | style = | textstyle = | text = | text-small = | talk = {{{talk|}}} | date = {{{date|}}} | text = | smalltext = | plainlinks = no | removalnotice = | cat = | all = | cat2 = | all2 = | cat3 = | all3 = }}<noinclude>{{doc}}</noinclude>
Параметры
type
Типы меняют внешний вид шаблона:
type=
speedy
— в шаблонах быстрого удаления категории.
|
type=
delete
— в шаблонах удаления категории.
|
type=
content
— важные предупреждения и предостережения.
|
type=
style
— обычные предупреждения и предостережения.
|
type=
notice
— информационные сообщения, постоянные и временные.
|
type=
move
— сообщения о перемещении, слиянии и разделении.
|
type=
protection
— сообщения о защите страницы.
|
image
Этот параметр позволяет изменить картинку шаблона:
type = style
image = [[Файл:Sub-arrows.svg|40px]] Большой значок. |
type = move
image = [[Файл:Redirect arrow.svg|52px]] Ещё больше. |
Комбинации параметров
Более сложные варианты использования шаблона:
Не заданы параметры type и image (по умолчанию)
|
Не заданы параметр type и
image=none
– Значок не показывается и текст занимает всю ширину окна сообщения.
|
image = [[Файл:Gnome globe current event.svg|42px]]
imageright = [[Файл:Nuvola apps bookcase.svg|40px]] |
This category lists articles about current and recent
.
|
image
Вы можете выбрать уникальное изображение для шаблона, использую параметр
image
. Значение параметра
|
image
=
должно иметь тот же синтаксис, как и при вставке изображения в статью (
Википедия:Иллюстрирование#Вставка файла в статью
). В стандарте, ширина — 40-50px. Например:
-
Для
{{
Категория для распределения
}}
указано изображение
| image = [[Изображение:Sub-arrows.svg|40px|link=|alt=]]
:
Статьи и подкатегории данной категории следует по возможности перемещать в подходящие подкатегории.
|
Пожалуйста, учтите:
- Если изображение не указано, то оно будет зависеть от параметра 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
= КАТЕГОРИЯ
тогда:
-
статьи будут помещены в категорию
Категория: КАТЕГОРИЯ с ДАТЫ
если
| date = ДАТА
указан. - статьи будут помещены в категорию Категория: КАТЕГОРИЯ если дата не указана.
Например, для шаблона
{{
Маргинальные теории
}}
указана категория
|
cat
= Википедия:Статьи, подозреваемые в наличии оригинальных исследований
, и поэтому статья с шаблоном
{{
Маргинальные теории
|
date=12 января 2013
}}
будет помещена в категорию
Категория:Википедия:Статьи, подозреваемые в наличии оригинальных исследований с января 2013 года
.
В параметре
cat
не должно быть ссылок, и префикса
Category:
или
Категория:
.
all
Параметр all определяет категорию, в которую должны быть включены все статьи не зависимо от даты.
В параметре
all
не должно быть ссылок, и префикса
Category:
или
Категория:
.
Дополнительные параметры
imageright
С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра
|
image
=
, за исключением того, что по умолчанию изображение отсутствует.
smallimage and smallimageright
С помощью этих параметров можно указать изображения для блока малого формата. Они не будут иметь никакого эффекта, если не указано
|
small
= left
.
class
Пользовательские классы CSS для применения к сообщению. Если вы добавляете несколько классов, они должны быть разделены пробелом.
style and textstyle
Дополнительные значения CSS могут быть определены без кавычек
" "
, но с завершающими точками с запятой
;
.
-
| style =
— определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна. -
| textstyle =
— относится к текстовой ячейке.
issue and fix
Вместо указания
|
text
=
и
|
text-small
=
можно использовать параметр
|
issue
=
.
Индивидуальный текст для малого формата может быть определен с помощью
|
fix
=
.
plainlinks
Обычно в Википедии внешние ссылки отмечены значком стрелки рядом с ними, например:
. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например:
. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте
|
plainlinks
= no
.
cat2 , cat3 , all2 , and all3
-
| cat2 =
и| cat3 =
предусматривают дополнительные помесячные категории; см. . -
| all2 =
и| all3 =
предусматривают дополнительные категории, в которые помещаются все статьи, как и в .
Технические детали
Если вам необходимо использовать специальные символы внутри параметра
|
text
=
, то вам необходимо заменять их ESC-последовательностями:
{{cmbox
| text = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>.
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }. А здесь знак разделения параметров | и две фигурные скобки }}. А здесь знак разделения параметров перед двумя закрывающими фигурными скобками |}}. |
-
Этот шаблон использует
cmbox
CSS -классы в MediaWiki:Common.css влияющие на его внешний вид, то есть он полностью перенастраиваемый.
- Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.
-
Теги
<div>
, окружающие текст в приведенном выше примере, обычно не нужны. Но если текст содержит разрыв строки или строк, то иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных списков. Используйте теги<div>
, чтобы исправить такое поведение.
Семейство Mbox
В семействе Module:Message box есть семь меташаблонов:
- {{ Ambox }} для сообщений на страницах статей.
- {{ Cmbox }} для сообщений на страницах категорий.
- {{ Imbox }} для сообщений на страницах файлов (изображений).
- {{ Tmbox }} для сообщений на страницах обсуждения.
- {{ Fmbox }} для сообщений верхнего и нижнего интерфейса сайта.
- {{ Ombox }} для сообщений на других типах страниц.
- {{ Mbox }} , для сообщений, которые используются в разных пространствах имен и соответствующим образом изменяют их дизайн.
Тесно связанные меташаблоны:
- {{ Asbox }} для сообщений в заготовках статей.
- {{ Неоднозначность }} , для сообщений на страницах устранения неоднозначности.
- 2021-12-12
- 1