Постоянно защищенный шаблон
Из Википедии, бесплатной энциклопедии
Перейти к навигации Перейти к поиску
Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Это мета-шаблон {{ category handler }}.

Это помогает другим шаблонам автоматизировать как категоризацию, так и подавление категорий .

Уже при использовании с настройками по умолчанию этот шаблон предотвращает автоматическую категоризацию в некоторых пространствах имен и на некоторых страницах, где мы обычно не хотим категоризации. Таким образом, даже самое простое использование, такое как " {{category handler|[[Category:Somecat]]}}", следит за тем, чтобы шаблоны не распределялись по категориям автоматически в неправильных местах.

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

Когда не использовать этот шаблон

Если шаблону нужно только категоризировать одно из основных пространств имен (статьи), файла (изображения) или категории, то использование этого шаблона является излишним. Тогда вместо этого используйте одно из {{ main other }}, {{ file other }} или {{ category other }}. Но если вашему шаблону необходимо категоризировать в любом другом пространстве имен, мы рекомендуем вам использовать этот шаблон, поскольку он обеспечивает надлежащее подавление категорий и упрощает выбор способа категоризации в различных пространствах имен.

Пространства имён

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

main = Main / article space, как в обычных статьях Википедии.
talk = Любое пространство для разговоров, например, имена страниц, начинающиеся с «Обсуждение:», «Обсуждение пользователя:», «Обсуждение файла:» и т. д.
пользователь, википедия, файл, медиа-вики, шаблон, справка, категория, портал и книга = другие пространства имен, кроме страниц обсуждения.
other = Любые пространства имен, которые не были указаны в качестве параметра для шаблона. См. Примеры ниже.

Основное использование

Этот шаблон принимает два или более параметра. Вот пример с полным кодом шаблона для окна сообщения статьи:

{{Ambox| text = Это поле используется в статьях.}} {{обработчик категории| [[Категория: Somecat]]| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает ->
}} <noinclude>{{Документация}}<! - Добавить категории на подстраницу / doc -> </noinclude>

В приведенном выше примере используются настройки по умолчанию для {{category handler}} . Это означает, что окно будет классифицироваться по страницам в следующих пространствах имен:

основной , файл , справка , категория , портал и книга

Но он не будет классифицироваться в следующих пространствах имен:

обсуждение , пользователь , википедия , медиа-вики и шаблон

И он не будет классифицироваться на страницах в черном списке. (См. Раздел черный список ниже.)

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

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

Расширенное использование

Этот шаблон принимает один или несколько параметров, названных в честь различных типов страниц, перечисленных в пространствах имен разделов выше. Используя эти параметры, вы можете точно указать, в какие пространства имен должен классифицироваться ваш шаблон. Как это:

{{mbox| text = Это поле для статей и страниц обсуждения.}} {{обработчик категории| main = [[Категория: Somecat1]] <! - Категоризация в основной области (статьи) ->
| talk = [[Категория: Somecat2]] <! - Категоризация в дискуссионном пространстве ->
| nocat = {{{nocat |}}} <! - Итак, "nocat = true" работает ->}}

Вышеупомянутое поле будет разделять только на основную и переговорную области. Но он не будет классифицировать страницы / архивировать, так как они занесены в черный список. (См. Раздел « черный список» ниже.) И если вам нужно продемонстрировать (обсудить) это поле на странице обсуждения, то вы можете использовать « nocat=true», чтобы предотвратить категоризацию этого шаблона. (См. Раздел «Параметр nocat» ниже.) Вот так:

== Мой новый шаблон ==Привет, ребята, вы видели мой новый шаблон?{{mytemp | nocat = true}}Красиво, не правда ли?- ~~~~

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

{{mbox| text = Это поле используется в нескольких пространствах имен.}} {{обработчик категории| main = [[Категория: Somecat1]]| 1 = [[Категория: Somecat2]] <! - За помощью и за пространство пользователя ->| help = 1| пользователь = 1| talk = <! - На страницах обсуждения нет категорий ->
| другое = [[Категория: Somecat3]] <! - Для всех других пространств имен ->
| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает ->}}

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

Этот шаблон понимает пронумерованные параметры от 1 до 10.

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

Обратите внимание на пустой, но определенный параметр разговора . Это мешает этому шаблону показывать, что было передано другому параметру, когда он находится в переговорном пространстве.

В этом шаблоне также есть параметр all . Это работает так:

{{mbox| text = Это поле используется во всех пространствах имен.}} {{обработчик категории| all = [[Категория: Somecat1]] <! - Категоризация во всех пространствах имен -> | nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает ->}}

В приведенном выше примере будут категоризированы все пространства имен, но не страницы из черного списка. Если вы хотите продемонстрировать это поле на странице, используйте " nocat=true", чтобы предотвратить категоризацию шаблона.

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

Параметр all также можно комбинировать с остальными параметрами. Как это:

{{mbox| text = Это поле используется во всех пространствах имен.}} {{обработчик категории| all = [[Категория: Somecat1]] <! - Категоризация во всех пространствах имен -> | main = [[Категория: Somecat2]] <! - И добавьте это в основное пространство ->
| other = [[Категория: Somecat3]] <! - И добавьте это во все другие пространства имен ->
| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает ->}}

Если указанное выше поле размещено на статье, тогда будут добавлены категории «Somecat1» и «Somecat2». Но на всех других типах страниц вместо этого добавляются «Somecat1» и «Somecat3». Как показывает пример, параметр all работает независимо от остальных параметров.

Подстраницы

Этот шаблон понимает параметр подстраницы . Как это:

{{обработчик категории | subpage = no <! - Не разделять подстраницы по категориям -> | wikipedia = [[Категория: Somecat]]| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает ->}}

Если " subpage=no", то этот шаблон не будет категоризировать подстраницы. Для тех редких случаев , вы только хотите , чтобы классифицировать на подстраницах, а затем использовать « subpage=only». Если подстраница пуста или не определена, то в этом шаблоне подразделяются как на базовые, так и на подстраницы.

Черный список

В этом шаблоне есть черный список страниц и типов страниц, для которых не следует автоматически категоризировать шаблоны. Таким образом, шаблоны, которые используют этот мета-шаблон, например, не будут категоризировать / архивировать страницы и подстраницы сообщений Wikipedia: Template .

Если вы хотите, чтобы шаблон классифицировался на странице, занесенной в черный список, подайте " nocat = false" в шаблон, когда вы размещаете его на странице, таким образом пропуская проверку черного списка. Обратите внимание, что этот шаблон классифицирует только в том случае, если в нем есть данные для пространства имен. Например, если используется базовый синтаксис (см. Базовое использование выше), то даже если вы установите " nocat = false", шаблон не будет категоризировать страницу обсуждения, поскольку у него нет данных для страниц обсуждения. Но у него есть данные для справочного пространства, поэтому на странице справки, занесенной в черный список, он будет классифицирован.

Черный список находится в подшаблоне {{ category handler / blacklist }}. Чтобы просмотреть или обновить черный список, перейдите туда.

Параметр "nocat"

Этот шаблон понимает параметр nocat :

  • Если " nocat = true", то этот шаблон не классифицирует.
  • Если nocat пуст или не определен, этот шаблон классифицируется как обычно.
  • Если " nocat = false" этот шаблон классифицируется даже на страницах из черного списка. (См. Раздел черный список выше.)

Шаблоны, использующие {{category handler}}, должны пересылать nocat , чтобы они тоже понимали nocat . Код " nocat = {{{nocat|}}}", показанный в примерах на этой странице, делает это.

Параметр "категории"

Для обратной совместимости этот шаблон также понимает параметр категорий . Работает так же, как nocat . Как это:

  • Если " categories = no", то этот шаблон не классифицирует.
  • Если категории пусты или не определены, этот шаблон классифицируется как обычно.
  • Если " categories = yes" этот шаблон классифицируется даже на страницах из черного списка.

При добавлении этого шаблона в шаблон, который уже использует " categories = no" логику, вы можете сделать следующее, чтобы не нарушить существующее использование:

{{обработчик категории| [[Категория: Somecat]]| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает -> | категории = {{{категории |}}} <! - Итак, "Categories = no" работает -> }}

Параметр "категория2"

Для обратной совместимости этот тип шаблона поддерживает старый параметр «category =». Но имя параметра «категория» уже используется в этом шаблоне для подачи данных категории, когда она находится в пространстве категории. Поэтому вместо этого в этом шаблоне используется категория 2, аналогичная nocat . Как это:

  • Если " category2 =" (пусто, но определено), или " category2 = no", или если в категорию 2 передаются какие-либо другие данные (кроме описанных в следующих двух пунктах), то этот шаблон не классифицирует.
  • Если category2 не определен или если " category2 = ¬", то этот шаблон классифицирует как обычно.
  • Если " category2 = yes" этот шаблон классифицируется даже на страницах из черного списка.

При добавлении этого шаблона в шаблон, который уже использует " category =" логику, вы можете сделать это, чтобы не нарушить существующее использование:

{{обработчик категории| [[Категория: Somecat]]| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает -> | category2 = {{{category | ¬}}} <! - Итак, "category =" работает -> }}

Обратите внимание, что знак " ¬" необходим, он помогает этому шаблону определить, определен ли параметр категории, но пуст или не определен.

Категории и текст

Помимо категорий, в этот шаблон можно добавить что угодно, например текст. Как это:

{{tmbox| text = Это окно сообщения на странице обсуждения.}} {{обработчик категории| talk = [[Категория: Somecat]]| other = ::::: Этот шаблон следует использовать только на страницах обсуждения.| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает ->}}

Когда указанный выше шаблон отображается не на странице обсуждения, он будет выглядеть следующим образом (обратите внимание на текст под полем):

Этот шаблон следует использовать только на страницах обсуждения.

Этот текст не будет отображаться на страницах в черном списке, поэтому не используйте этот метод для отображения какой-либо важной информации. При вводе " nocat = true" в шаблон текст скрывается, как и любые категории.

Параметр "страница"

В целях тестирования и демонстрации этот шаблон может принимать параметр с именем page . Как это:

{{обработчик категории| main = Категория: Какой-то кот| talk = Категория: Обсуждение кота| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает -> | page = Обсуждение пользователей: пример }}

В приведенном выше коде мы специально опустили скобки вокруг названий категорий, чтобы увидеть результат на странице. Независимо от того, на какой странице используется приведенный выше код, он вернет следующее:

Категория: Обсуждение кота

Параметр page заставляет этот шаблон вести себя точно так же, как если бы он был на этой странице. Даже черный список работает. Имя страницы не обязательно должно быть существующей страницей.

Если параметр страницы пуст или не определен, имя текущей страницы определяет результат.

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

{{обработчик категории| main = Категория: Какой-то кот| talk = Категория: Обсуждение кота| nocat = {{{nocat |}}} <! - Значит, "nocat = true / false" работает -> | page = {{{page |}}} <! - Для тестирования -> }}

Параметры

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

{{обработчик категории| [[Категория: Somecat]]| подстраница = нет / только| 1 =...| 10 =| all = [[Категория: Somecat]] / Текст| main = 1 / ... / 10 / [[Категория: Somecat]] / Текст...| другое = 1 / ... / 10 / [[Категория: Somecat]] / Текст| nocat = {{{ nocat | }}} / истина / ложь| категории = {{{ категории | }}} / нет / да| category2 = {{{ category | ¬ }}} / 'пусто' / нет / 'не определено' / ¬ / да| page = {{{ page | }}} / Пользователь: Пример}}

Обратите внимание, что пустые значения для параметров "main" ... "other" имеют особое значение (см. Примеры выше). Параметр "all" не поддерживает нумерованные параметры, так как в этом не должно быть необходимости.

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

Черный список централизованного подавления категорий находится в Модуле: Обработчик категорий / черный список . Чтобы просмотреть или обновить черный список, перейдите туда.

Для получения дополнительных технических сведений см. Страницу обсуждения .

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

  • Википедия: Подавление категорий - Практическое руководство.
  • Википедия: Подавление категорий WikiProject - WikiProject.
  • Википедия: Пространство имен - список всех пространств имен.
Выше документация будет включена через от Шаблона: обработчик Категории / документ . ( Редактировать | история )
Редакторы могут экспериментировать в этом шаблоне в песочнице ( редактировать | дифф ) и testcases ( редактировать ) страницы.
Добавьте категории на подстраницу / doc . Подстраницы этого шаблона .