Шаблон: Cmbox

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон используется на более чем 336 000 страницах, или примерно на 1% всех страниц. Чтобы избежать серьезных сбоев и нагрузки на сервер, любые изменения следует тестировать на подстраницах шаблона / sandbox или / testcases , или на подстраницах вашего собственного пользователя . Протестированные изменения могут быть добавлены на эту страницу одним редактированием. Обсудите изменения на странице обсуждения, прежде чем внедрять их.

Этот шаблон использует Lua : Модуль: окно сообщения ( песочница )

Это метатемплейт {{ Cmbox }} ([ C ] ategory [ m ] essage [ box ]).

Он используется для создания шаблонов окон сообщений, таких как {{ Category diffuse }} для страниц категорий. Он предлагает несколько разных цветов, использует изображения по умолчанию, если не указан параметр изображения, и имеет некоторые другие функции.

Этот шаблон работает почти так же, как {{ Ambox }}, и использует те же параметры.

Применение

Простой пример использования:

{{cmbox | text = Некоторый текст.}}

Какой-то текст.

Сложный пример:

{{cmbox| type = style| image = [[Файл: Emblem-question-yellow.svg | 40px]]| style = width: 400 пикселей;| textstyle = цвет: красный; font-weight: жирный; стиль шрифта: курсив;| text = Текст сообщения.}}

Текст сообщения.

Типы окон сообщений категории

В следующих примерах используются различные параметры типа, но не используются параметры изображения, поэтому они используют изображения по умолчанию для каждого типа.

type = speedy - шаблоны быстрого удаления, такие как {{ db-c1 }}.

type = delete - шаблоны удаления, такие как {{ cfd }}.

type = content - Основные предупреждения и проблемы, такие как {{ Категоризация оспариваемых людей }}.

type = style - Незначительные предупреждения и проблемы, такие как {{ Overpopulated category }}.

type = notice - Уведомления и сообщения любого рода, как постоянные, так и временные.

type = move - перемещать, объединять и разделять сообщения и предложения, такие как {{ Category redirect }}.

type = protection - шаблоны защиты, такие как {{ pp }} при отображении на странице категории.

Другие изображения

Изображения по умолчанию, показанные выше, в основном предназначены для удобства. Во многих случаях более целесообразно использовать более конкретные изображения. В этих примерах параметр image используется для указания изображения, отличного от изображений по умолчанию.

type = style image = [[File: Sub-arrows.svg | 40px]] Это изображение используется для {{ перенаселенная категория }} и {{ диффузная категория }}.

type = move image = [[File: Redirect arrow.svg | 52px]] Это изображение используется для {{ Category redirect }}.

Специальный

Некоторые другие комбинации параметров.

Тип и изображение не указаны (по умолчанию )

image = [[Файл: текущее событие глобуса Gnome.svg | 42px]] imageright = [[Файл: Nuvola apps bookcase.svg | 40px]]

В этой категории перечислены статьи о текущих и недавних космических полетах . Он заполняется шаблоном {{ Current spaceflight }}.

Параметры

Список всех параметров:

{{cmbox| name = имя шаблона| тип = быстро / удалить / содержимое / стиль / уведомление / перемещение / защита| image = none / [[File: Some image.svg | 40px]]| imageright = [[Файл: Some image.svg | 40px]]| class = Пользовательский класс CSS для применения к блоку| style = значения CSS| textstyle = значения CSS| plainlinks = нет| text = Текст сообщения.}}

название

(Необязательно) Имя шаблона. Это добавляет класс CSS с именем к элементу HTML для использования ботами или скриптами.box-name

тип

Если параметр типа не указан, в шаблоне по умолчанию используется тип примечания . Это означает, что он получает синий фон.

изображение

Без параметра = Если параметр изображения не указан, в шаблоне используется изображение по умолчанию. Используемое изображение по умолчанию зависит от параметра типа .

Изображение = Должно быть изображение с обычной нотацией вики. Ширина 40–50 пикселей обычно примерно правая, в зависимости от отношения высоты изображения к ширине (но окно сообщения может обрабатывать изображения любого размера).

Например: image = [[File:Sub-arrows.svg|40px]]

none = Означает, что изображение не используется.

Imageright

Без параметра = Если параметр imageright не указан, изображение справа не отображается.

Изображение = Должно быть изображение с обычной нотацией вики. Ширина 40–50 пикселей обычно примерно правая, в зависимости от отношения высоты изображения к ширине (но окно сообщения может обрабатывать изображения любого размера).

Например: imageright = [[File:Nuvola apps bookcase.png|40px]]

Anything = Любой другой объект, который вы хотите показать справа.

стиль

Необязательное значение CSS, используемое всей таблицей окна сообщения. Без кавычек " ".

Например: style = margin-bottom: 0.5em;

стиль текста

Необязательное значение CSS, используемое текстовой ячейкой.

Например: textstyle = text-align: center;

простые ссылки

Обычно в Википедии рядом с внешними ссылками отображается значок стрелки, например: Example.com . Однако в окнах сообщений значок стрелки по умолчанию подавлен, например: Example.com . Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте |plainlinks=no.

текст

Текст сообщения.

Технические подробности

Если вам нужно использовать специальные символы в текстовом параметре, вам нужно экранировать их следующим образом:

{{cmbox| текст = <div>Знак равенства =, а также начальная и конечная фигурная скобка {} работают нормально, как есть. Но вот трубка {{!}} И две концевые скобки <nowiki>}} </nowiki>. А теперь трубка и концевые скобки <nowiki> |}} </nowiki>.</div>}}

Знак равенства =, а также начальная и конечная фигурная скобка {} работают нормально, как есть. Но вот трубка | и две концевые скобки}}. А теперь труба и концевые скобки |}}.

Этот шаблон использует классы CSS cmbox в MediaWiki: Common.css для большей части своего внешнего вида, поэтому для него можно полностью изменить скин .

Внутренне этот мета-шаблон использует разметку HTML вместо разметки wiki для кода таблицы. Это обычный способ создания мета-шаблонов, поскольку у вики-разметки есть несколько недостатков. Например, это затрудняет использование функций синтаксического анализатора и специальных символов в параметрах.

Изображения по умолчанию для этого мета-шаблона имеют формат PNG, а не формат SVG. Основная причина в том, что в некоторых старых браузерах возникают проблемы с прозрачным фоном, который MediaWiki отображает для изображений SVG. Изображения PNG имеют вручную оптимизированный прозрачный цвет фона, поэтому они хорошо выглядят во всех браузерах. Обратите внимание, что значки SVG выглядят плохо только в старых браузерах, поэтому такая ручная оптимизация стоит проблем только для очень широко используемых значков.

Для получения дополнительных технических сведений см. Страницу обсуждения . Поскольку этот шаблон работает почти так же, как и другие mboxes, их страницы обсуждения и связанные страницы могут также содержать более подробную информацию (см . Также раздел ниже).

Смотрите также

• {{ Ambox }} для ящиков сообщений на страницах статей.
• {{ Cmbox }} для ящиков сообщений на страницах категорий.
• {{ Imbox }} для ящиков сообщений на страницах файлов (изображений).
• {{ Tmbox }} для ящиков сообщений на страницах обсуждения.
• {{ Fmbox }} для окон сообщений верхнего и нижнего колонтитула.
• {{ Ombox }} для ящиков сообщений на других типах страниц.
• {{ Mbox }} для ящиков сообщений, которые используются в разных пространствах имен, и соответствующим образом изменяют их представление.

Тесно связанные метатемплиты:

• {{ Asbox }} для ящиков сообщений в корешках статей.
• {{ Dmbox }} для ящиков сообщений на страницах с определением неоднозначности или на страницах с индексом набора
• {{ Ivmbox }}, простое полноразмерное поле с фоном цвета слоновой кости по умолчанию, предназначенное для размещения важных сообщений или уведомлений.

Шаблоны, предназначенные для использования вместе с Mboxes:

• {{ Ombox / shortcut }}, альтернатива {{ Shortcut }} для использования в шаблонах Mbox