Module:Check for unknown parameters/doc: Difference between revisions

Revision as of 20:57, 6 February 2024

Revision as of 13:25, 23 June 2024

Line 3:

{{Lua|Module:If preview|noprotcat=yes}}

This'''Module:Check modulefor mayunknown beparameters''' appendedis to a templateused to check for uses of unknown parameters. Unlikein manya othertemplate modules, thisor module. isIt ''not''may implementedbe byappended to a template at the end or called directly from a module.

== Usage ==

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki>[</nowiki>[Category:Some tracking category]]|arg1|arg2|arg3|argN}}

=== Basic usage ===

<syntaxhighlight lang="wikitext">

{{#invoke:Check for unknown parameters|check

|unknown=[[Category:Some tracking category]]

|arg1|arg2|arg3|argN}}

</syntaxhighlight>

or to sort the entries in the tracking category by parameter with a preview error message

<syntaxhighlight lang="wikitext">

{{#invoke:Check for unknown parameters|check

|unknown=[[Category:Some tracking category|_VALUE_]]

|preview=unknown parameter "_VALUE_"

|arg1|arg2|...|argN}}

</syntaxhighlight>

or for an explicit red error message

<syntaxhighlight lang="wikitext">

{{#invoke:Check for unknown parameters|check

|unknown=<span class="error">Sorry, I don't recognize _VALUE_</span>

|arg1|arg2|...|argN}}

</syntaxhighlight>

Here, <code>arg1</code>, <code>arg2</code>, ..., <code>argN</code>, are the known parameters. Unnamed (positional) parameters can be added too: <code><nowiki>|1|2|argname1|argname2|...</nowiki></code>. Any parameter which is used, but not on this list, will cause the module to return whatever is passed with the <code>unknown</code> parameter. The <code>_VALUE_</code> keyword, if used, will be changed to the name of the parameter. This is useful for either sorting the entries in a tracking category, or for provide more explicit information.

or toTo sort the entries in the tracking category by parameter with a preview error message, use:

By default, the module makes no distinction between a defined-but-blank parameter and a non-blank parameter. That is, both unlisted {{Para|foo|x}} and {{Para|foo}} are reported. To only track non-blank parameters use {{Para|ignoreblank|1}}.

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki>[</nowiki>[Category:Some tracking category|_VALUE_]]|preview{{=}}unknown parameter "_VALUE_"|arg1|arg2|...|argN}}

or forFor an explicit red error message, use:

By default, the module ignores blank positional parameters. That is, an unlisted {{Para|2}} is ignored. To ''include'' blank positional parameters in the tracking use {{Para|showblankpositional|1}}.

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki><</nowiki>span class{{=}}"error">Sorry, I don't recognize _VALUE_</span>|arg1|arg2|...|argN}}

===With Lua patterns ===:

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki>[</nowiki>[Category:Some tracking category|_VALUE_]]|preview{{=}}unknown parameter "_VALUE_"|arg1|arg2|...|argN|regexp1{{=}}header[%d]+|regexp2{{=}}date[1-9]}}

This module supports [[:mw:Extension:Scribunto/Lua reference manual#Patterns|Lua patterns]] (similar to [[regular expression]]s), which are useful when there are many known parameters which use a systematic pattern. For example, <code>[[Module:Infobox3cols|Infobox3cols]]</code> uses

<syntaxhighlight lang="lua">

== Parameters ==

regexp1 = "header[%d]+",

* <code>arg1</code>, <code>arg2</code>, ..., <code>argN</code>, are the known parameters.

regexp2 = "label[%d]+",

* Unnamed (positional) parameters can be added too: <code>|1|2|arg1|arg2|...</code>.

regexp3 = "data[%d]+[abc]?",

This module supports* [[:mw:Extension:Scribunto/Lua reference manual#Patterns|Lua patterns]] (similar to [[regular expression]]s) usage with parameters is also supported. {{para|regexp1|header[%d]+}}, which{{para|regexp2|date[1-9]}}, are{{para|regexp3|data[%d]+[abc]?}}. This is useful when there are many known parameters which use a systematic pattern. For example, <code>[[Module:Infobox3cols|Infobox3cols]]</code> uses

regexp4 = "class[%d]+[abc]?",

* {{para|unknown}} – the tracking category to place pages that use uknown parameters.

regexp5 = "rowclass[%d]+",

* {{para|preview}} – the text to be displayed when in preview mode and an unknown parameter is used.

regexp6 = "rowstyle[%d]+",

* The <code>_VALUE_</code> keyword, if used, will be changed to the name of the parameter. This is useful for either sorting the entries in a tracking category, or for provide more explicit information.

regexp7 = "rowcellstyle[%d]+",

By* {{para|ignoreblank|1}} – by default, the module makes no distinction between a defined-but-blank parameter and a non-blank parameter. That is, both unlisted {{Para|foo|x}} and {{Para|foo}} are reported. To only track non-blank parameters use {{Parapara|ignoreblank|1}}.

</syntaxhighlight>

By* {{para|showblankpositional|1}} – by default, the module ignores blank positional parameters. That is, an unlisted {{Parapara|2}} is ignored. To ''{{em|include''}} blank positional parameters in the tracking use {{Parapara|showblankpositional|1}}.

to match all parameters of the form <code>headerNUM</code>, <code>labelNUM</code>, <code>dataNUM</code>, <code>dataNUMa</code>, <code>dataNUMb</code>, <code>dataNUMc</code>, ..., <code>rowcellstyleNUM</code>, where NUM is a string of digits.

== Example ==