Difference between revisions of "Module:Check for unknown parameters/doc"
From Summertime Saga Wiki
(Created page with "This module may be appended to a template to check for uses of unknown parameters. == Usage == === Basic usage === <pre> {{#invoke:check for unknown parameters|check |unknown...") |
m |
||
| (2 intermediate revisions by the same user not shown) | |||
| 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> | ||
| − | |||
| − | + | 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 ignores blank positional parameters. That is, an unlisted {{para|2}} is ignored. To | + | 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 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 43: | Line 52: | ||
| label3 = Website | | label3 = Website | ||
| data3 = {{{website|}}} | | data3 = {{{website|}}} | ||
| − | }}<!-- | + | }}<!-- |
| − | + | end infobox, start tracking | |
-->{{#invoke:Check for unknown parameters|check | -->{{#invoke:Check for unknown parameters|check | ||
| unknown = {{main other|[[Category:Some tracking category|_VALUE_]]}} | | unknown = {{main other|[[Category:Some tracking category|_VALUE_]]}} | ||
| Line 53: | Line 62: | ||
}} | }} | ||
</pre> | </pre> | ||
| + | |||
| + | [[Category:Modules]][[Category:Modules documentation]] | ||
Latest revision as of 19:05, 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
}}