Перейти к содержанию

Ашаблон:Cmbox/doc

Аматериал Авикипедиа аҟынтә - зхы иақәиҭу аенциклопедиа
Ацҳамҭақәа амета-шаблонқәа рыблок
Адаҟьақәа:{{Ambox}}
Акатегориақәа:{{Cmbox}}
Асахьақәа:{{Imbox}}
Ахцәажәарақәа:{{Tmbox}}
Асистематә:{{Fmbox}}
Даҽа адаҟьақәа:{{Ombox}}
Авто:{{Mbox}}
Адаҟьа цәыблақәа{{Asbox}}
Аҵакырацәарақәа{{Dmbox}}

{{Cmbox}}, название сокращенно от category message 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>

Ашаблон:Конец скрытого блока

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

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

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

[акод аредакциазура]

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

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

Ашаблон:Категория для распределения

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

  • Если изображение не указано, то оно будет зависеть от параметра type. (Смотрите о параметре #type выше.)
  • Если указано |image=none, то никакое изображение выводится не будет, и текст займет всю площадь шаблона.
  • Если изображение выполняет чисто декоративную функцию, а также находится в общественном достоянии, удобство и доступность использования шаблоны может быть улучшена с помощью подавления ссылки на файл с помощью добавления параметров |link= и |alt=, как показано выше.

Параметр text передает основной текст в шаблон. Постарайтесь сделать его как можно более кратким и понятным.

Параметр text-small показывает текст маленьким шрифт, не рекомендуем его использовать для файлов.

Некоторые шаблоны-сообщения содержат ссылку на страницу обсуждения, и позволяют редактору уточнить заголовок необходимой секции для ссылки. Чтобы добиться такой функциональности, просто укажите при создании шаблона |talk={{{talk|}}}.

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

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

Примечания:

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

Установка параметра date сообщает мета-шаблону, что в шаблон-сообщение был установлен в этот день: устанавливается как редакторами, так и ботами. Отображается мелким шрифтов в конце дополнительного сообщения.

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

Также указание этого параметра включает категоризацию по времени, если параметр #cat определен.

Этот параметр определяет по-месячную категорию для статей. Если |cat=КАТЕГОРИЯ тогда:

  • статьи будут помещены в категорию Категория: КАТЕГОРИЯ с ДАТЫ если |date=ДАТА указан.
  • статьи будут помещены в категорию Категория: КАТЕГОРИЯ если дата не указана.

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

В параметре cat не должно быть ссылок, и префикса Category: или Категория:.

Параметр all определяет категорию, в которую должны быть включены все статьи не зависимо от даты.

В параметре all не должно быть ссылок, и префикса Category: или Категория:.

Дополнительные параметры

[акод аредакциазура]

С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра |image=, за исключением того, что по умолчанию изображение отсутствует.

smallimage and smallimageright

[акод аредакциазура]

С помощью этих параметров можно указать изображения для блока малого формата. Они не будут иметь никакого эффекта, если не указано |small=left.

Пользовательские классы CSS для применения к сообщению. Если вы добавляете несколько классов, они должны быть разделены пробелом.

Дополнительные значения CSS могут быть определены без кавычек " ", но с завершающими точками с запятой ;.

  • |style= — определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна.
  • |textstyle= — относится к текстовой ячейке.

Вместо указания |text= и |text-small= можно использовать параметр |issue=.

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

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

cat2, cat3, all2, and all3

[акод аредакциазура]
  • |cat2= и |cat3= предусматривают дополнительные помесячные категории; см. #cat.
  • |all2= и |all3= предусматривают дополнительные категории, в которые помещаются все статьи, как и в #all.

Технические детали

[акод аредакциазура]

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

{{cmbox
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.  
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>. 
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
  • Этот шаблон использует cmbox CSS-классы в MediaWiki:Common.css влияющие на его внешний вид, то есть он полностью перенастраиваемый.
  • Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.
  • Теги <div>, окружающие текст в приведенном выше примере, обычно не нужны. Но если текст содержит разрыв строки или строк, то иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных списков. Используйте теги <div>, чтобы исправить такое поведение.

Семейство Mbox

[акод аредакциазура]

Ашаблон:Подробный список шаблонов семейства Mbox