Interested Article - Cmbox

Документация
Мета-шаблоны
блоков сообщений

{{ 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>

Параметры

type

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

image

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

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

Более сложные варианты использования шаблона:

image

Вы можете выбрать уникальное изображение для шаблона, использую параметр image . Значение параметра | image = должно иметь тот же синтаксис, как и при вставке изображения в статью ( Википедия:Иллюстрирование#Вставка файла в статью ). В стандарте, ширина — 40-50px. Например:

Пожалуйста, учтите:

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

Same as Cmbox