Difference between revisions of "Module:Check for unknown parameters/doc"
m |
m |
||
Line 2: | Line 2: | ||
== Usage == | == Usage == | ||
+ | |||
=== Basic usage === | === Basic usage === | ||
+ | |||
<pre> | <pre> | ||
{{#invoke:check for unknown parameters|check | {{#invoke:check for unknown parameters|check | ||
− | |unknown=[[Category:Some tracking category]] | + | | unknown=[[Category:Some tracking category]] |
− | |arg1|arg2|...|argN}} | + | | arg1|arg2|...|argN}} |
</pre> | </pre> | ||
− | + | ||
+ | Or to sort the entries in the tracking category by parameter with a preview error message: | ||
+ | |||
<pre> | <pre> | ||
{{#invoke:check for unknown parameters|check | {{#invoke:check for unknown parameters|check | ||
− | |unknown=[[Category:Some tracking category|_VALUE_]] | + | | unknown=[[Category:Some tracking category|_VALUE_]] |
− | |preview=unknown parameter "_VALUE_" | + | | preview=unknown parameter "_VALUE_" |
− | |arg1|arg2|...|argN}} | + | | arg1|arg2|...|argN}} |
</pre> | </pre> | ||
− | + | ||
+ | Or for an explicit red error message: | ||
+ | |||
<pre> | <pre> | ||
{{#invoke:check for unknown parameters|check | {{#invoke:check for unknown parameters|check | ||
− | |unknown=<span class="error">Sorry, I | + | | unknown=<span class="error">Sorry, I don’t recognize _VALUE_</span> |
− | |arg1|arg2|...|argN}} | + | | arg1|arg2|...|argN}} |
</pre> | </pre> | ||
− | |||
− | By default, the module makes no distinction between a | + | Here, {{code|arg1}}, {{code|arg2}}, ..., {{code|argN}}, 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}} parameter. The {{code|_VALUE_}} 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. |
+ | |||
+ | 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}}. | ||
− | By default, the module ignores blank positional parameters. That is, an unlisted {{para|2}} is ignored. To | + | 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}}. |
=== Lua patterns === | === Lua patterns === | ||
+ | |||
This module supports [[:mw:Extension:Scribunto/Lua reference manual#Patterns|Lua patterns]] (similar to [[wikipedia:regular expression|regular expression]]s), which are useful when there are many known parameters which use a systematic pattern. | This module supports [[:mw:Extension:Scribunto/Lua reference manual#Patterns|Lua patterns]] (similar to [[wikipedia:regular expression|regular expression]]s), which are useful when there are many known parameters which use a systematic pattern. | ||
== Example == | == Example == | ||
+ | |||
<pre> | <pre> | ||
{{Infobox | {{Infobox | ||
Line 54: | Line 63: | ||
</pre> | </pre> | ||
− | [[Category:Modules]] | + | [[Category:Modules]][[Category:Modules documentation]] |
Revision as of 17:33, 11 July 2020
This module may be appended to a template to check for uses of unknown parameters.
Contents
Usage
Basic usage
{{#invoke:check for unknown parameters|check | unknown=[[Category:Some tracking category]] | arg1|arg2|...|argN}}
Or to sort the entries in the tracking category by parameter with a preview error message:
{{#invoke:check for unknown parameters|check | unknown=[[Category:Some tracking category|_VALUE_]] | preview=unknown parameter "_VALUE_" | arg1|arg2|...|argN}}
Or for an explicit red error message:
{{#invoke:check for unknown parameters|check | unknown=<span class="error">Sorry, I don’t recognize _VALUE_</span> | arg1|arg2|...|argN}}
Here, arg1
, arg2
, ..., argN
, are the known parameters. Unnamed (positional) parameters can be added too: |1|2|argname1|argname2|...
. Any parameter which is used, but not on this list, will cause the module to return whatever is passed with the unknown
parameter. The _VALUE_
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.
By default, the module makes no distinction between a defined‐but‐blank parameter and a non‐blank parameter. That is, both unlisted |foo=x
and |foo=
are reported. To only track non‐blank parameters use |ignoreblank=1
.
By default, the module ignores blank positional parameters. That is, an unlisted |2=
is ignored. To include blank positional parameters in the tracking use |showblankpositional=1
.
Lua patterns
This module supports Lua patterns (similar to regular expressions), which are useful when there are many known parameters which use a systematic pattern.
Example
{{Infobox | above = {{{name|}}} | label1 = Height | data1 = {{{height|}}} | label2 = Weight | data2 = {{{weight|}}} | label3 = Website | data3 = {{{website|}}} }}<!-- end infobox, start tracking -->{{#invoke:Check for unknown parameters|check | unknown = {{main other|[[Category:Some tracking category|_VALUE_]]}} | preview = unknown parameter "_VALUE_" | name | height | weight | website }}