Karaby: Новая страница: «Этот модуль может быть добавлен в шаблоны для проверки использования неизвестных парам...»

2021-12-24T09:08:33Z

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

Новая страница

Этот модуль может быть добавлен в шаблоны для проверки использования неизвестных параметров. Самый простой способ использовать его — поставить в начало шаблона {{t|cfup|s}}{{переход|#Упрощённое задание}}. Обратите внимание, что статьи добавятся в категорию не сразу из-за [[ВП:Кэш|кэширования]].

== Использование ==

=== Базовое использование ===
<pre>
{{#invoke:check for unknown parameters|check
|unknown=[[Категория:Какая-то отслеживающая категория]]
|arg1|arg2|...|argN}}
</pre>
или, для того, чтобы отсортировать страницы в категории по параметру и отображать ошибку в режиме предпросмотра:
<pre>
{{#invoke:check for unknown parameters|check
|unknown=[[Категория:Какая-то отслеживающая категория|_VALUE_]]
|preview=Неизвестный параметр «_VALUE_»
|arg1|arg2|...|argN}}
</pre>
или, для заметного красного сообщения об ошибке:
<pre>
{{#invoke:check for unknown parameters|check
|unknown=<span class="error">Извините, я не распознал _VALUE_</span>
|arg1|arg2|...|argN}}
</pre>
Здесь <code>arg1</code>, <code>arg2</code>, …, <code>argN</code> — известные параметры. Неименованные параметры также могут быть перечислены: <code><nowiki>|1|2|argname1|argname2|...</nowiki></code>. Любой используемый параметр, не входящий в этот список, заставит модуль вернуть то, что передано в параметре <code>unknown</code>. Ключевое слово <code>_VALUE_</code> будет заменено на название параметра. Это может быть полезным как для сортировки страниц в категории, так и для отображения более полнятной информации.

По умолчанию модуль не различает объявленные пустые параметры и непустые параметры. Поэтому модуль сообщит как о {{para|foo|x}}, так и о {{para|foo}}, если их нет в списке. Для того, чтобы отслеживать только непустые параметры, используйте {{para|ignoreblank|1}}.

По умолчанию модуль игнорирует пустые неименованные параметры. То есть {{para|2}} будет проигнорирован, даже если его нет в списке. Для включения пустых неименованных параметров используйте {{para|showblankpositional|1}}.

=== Паттерны Lua ===
Модуль поддерживает [[:mw:Extension:Scribunto/Lua reference manual#Patterns|паттерны Lua]] (схожие с [[регулярные выражения|регулярными выражениями]]), которые могут быть полезными, когда есть много известных параметров, названных по одной системе. Например, код
<pre>
| regexp1 = header[%d][%d]*
| regexp2 = label[%d][%d]*
| regexp3 = data[%d][%d]*[abc]?
| regexp4 = class[%d][%d]*[abc]?
| regexp5 = rowclass[%d][%d]*
| regexp6 = rowstyle[%d][%d]*
| regexp7 = rowcellstyle[%d][%d]*
</pre>
сработает на всех параметрах из <code>headerNUM</code>, <code>labelNUM</code>, <code>dataNUM</code>, <code>dataNUMa</code>, <code>dataNUMb</code>, <code>dataNUMc</code>, …, <code>rowcellstyleNUM</code>, где NUM — строка цифр.

=== Генератор параметров ===
<pre>
{{subst:#invoke:check for unknown parameters|generate
|unknown=[[Категория:Какая-то отслеживающая категория]]
|{{subst:NAMESPACE}}|{{subst:PAGENAME}}}}
</pre>

Автоматически перечисляет параметры, находя в коде страницы, на которую подставляется, фрагменты вида <code><nowiki>{{{param</nowiki></code> (в том числе закомментированные). Параметры {{para|ignoreblank}}, {{para|preview}}, {{para|showblankpositional}} можно указать тут же, они перекинутся при подстановке. 

=== Шаблоны-предупреждения ===
{{установлена проверка на неизвестные параметры|nocat=1}}
Существует шаблон-предупреждение {{t|установлена проверка на неизвестные параметры}}, показывающий категорию, в которую включаются статьи с неизвестными параметрами (задаётся параметром {{para|категория}}, по умолчанию - ''Страницы с неизвестными параметрами шаблона {{t|PAGENAME}}'').

Шаблон-предупреждение также добавляет шаблон в категорию [[Категория:Википедия:Неизвестные параметры шаблонов|Википедия:Неизвестные параметры шаблонов]]. 

{{категория с неизвестными параметрами|nocat=1}}
Также существует шаблон {{tp|категория с неизвестными параметрами|''имя порождающего шаблона''}}, который можно поставить на автоматически добавляемую категорию.

Шаблон-предупреждение также добавляет шаблон в надкатегорию [[Категория:Википедия:Неизвестные параметры шаблонов|Википедия:Неизвестные параметры шаблонов]]

=== Упрощённое задание ===
Генератор параметров{{переход|#Генератор параметров}} и шаблон-предупреждение{{переход|#Шаблон-предупреждение}} можно вставить в статью одной правкой, добавив в начало шаблона подстановочный шаблон {{t|cfup|s}}. 

В результате в коде шаблона появится что-то вроде
<pre>
<noinclude>{{Установлена проверка на неизвестные параметры}}</noinclude><includeonly>{{#invoke:check for unknown parameters|check
|unknown=[[Категория:Страницы с неизвестными параметрами шаблона Что-то непонятное с бантиком|_VALUE_]]
|ignoreblank=
|preview=<span class="error">Неизвестный параметр «_VALUE_» шаблона Что-то непонятное с бантиком</span>
|showblankpositional=
|nocat|что-то|непонятное|бантик|котик|пёсик}}</includeonly>
</pre>

Параметр {{para|noambox|1}} подставит только вторую часть, без шаблона-предупреждения. 

== Пример ==
<pre>
{{Карточка
| вверху = {{{name|}}}

| метка1 = Height
| текст = {{{height|}}}

| метка2 = Weight
| текст2 = {{{weight|}}}

| метка3 = Website
| текст3 = {{{website|}}}
}}{{#invoke:Check for unknown parameters|check
| unknown = {{#if:{{NAMESPACE}}||[[Категория:Какая-то отслеживающая категория|_VALUE_]]}}
| preview = Неизвестный параметр «_VALUE_»
| name
| height | weight
| website
}}
</pre>

<includeonly>[[Категория:Википедия:Модули]]</includeonly>

Модуль:Check for unknown parameters/doc - История изменений

Karaby: Новая страница: «Этот модуль может быть добавлен в шаблоны для проверки использования неизвестных парам...»