mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/TemplateData
synced 2024-11-23 15:36:47 +00:00
Minor fixes & improvements to Specification.md
Change-Id: Ic2dfeaa12f1e9249dfafd641a8eabfa5ce208d8a
This commit is contained in:
parent
560819e270
commit
e0582842b4
|
@ -57,14 +57,14 @@ Requirements for non-Required ("optional") properties only apply if the property
|
||||||
|
|
||||||
#### 3.1.2 `params`
|
#### 3.1.2 `params`
|
||||||
* Required
|
* Required
|
||||||
* Value: `Object`
|
* Value: `Object` containing `Param` objects, see 3.2
|
||||||
|
|
||||||
Describes each of the template's parameters to a User.
|
Describes each of the template's parameters to a User.
|
||||||
|
|
||||||
Authors MUST ensure that the `params` object maps parameter names to `Param` objects.
|
Authors MUST ensure that the `params` object maps parameter names to `Param` objects.
|
||||||
|
|
||||||
#### 3.1.3 `paramOrder`
|
#### 3.1.3 `paramOrder`
|
||||||
* Value: `Array`
|
* Value: `Array` of `string`
|
||||||
|
|
||||||
The logical order of the parameters.
|
The logical order of the parameters.
|
||||||
|
|
||||||
|
@ -74,7 +74,7 @@ Consumers SHOULD display the parameters in this order.
|
||||||
|
|
||||||
#### 3.1.4 `sets`
|
#### 3.1.4 `sets`
|
||||||
* Required
|
* Required
|
||||||
* Value: `Array`
|
* Value: `Array` of `Set` objects, see 3.3
|
||||||
|
|
||||||
List of groups of parameters that can be used together.
|
List of groups of parameters that can be used together.
|
||||||
|
|
||||||
|
@ -84,7 +84,7 @@ A Consumer MAY encourage users to interact with parameters in a `Set` together (
|
||||||
|
|
||||||
#### 3.1.5 `maps`
|
#### 3.1.5 `maps`
|
||||||
* Required
|
* Required
|
||||||
* Value: `Object`
|
* Value: `Object` containing `Map` objects, see 3.6
|
||||||
|
|
||||||
An object describing which parameter(s) specific Consumers SHOULD use for some purpose.
|
An object describing which parameter(s) specific Consumers SHOULD use for some purpose.
|
||||||
|
|
||||||
|
@ -97,7 +97,7 @@ Consumers that look for a `Map` SHOULD publicly document their identifier key.
|
||||||
Authors MUST ensure that the `maps` object contains only `Map` objects. Authors MAY include a parameter in multiple `Map` objects. Authors are NOT REQUIRED to reference each parameter in at least one `Map` object.
|
Authors MUST ensure that the `maps` object contains only `Map` objects. Authors MAY include a parameter in multiple `Map` objects. Authors are NOT REQUIRED to reference each parameter in at least one `Map` object.
|
||||||
|
|
||||||
#### 3.1.6 `format`
|
#### 3.1.6 `format`
|
||||||
* Value: `null` or `FormatString` or `string` of either `'inline'` or `'block'`
|
* Value: `null` or `FormatString` (see 3.7) or `string` of either `'inline'` or `'block'`
|
||||||
* Default: `null`
|
* Default: `null`
|
||||||
|
|
||||||
How the template's wikitext representation SHOULD be laid out. Authors MAY choose to use this parameter to express that a template will be better understood by other human readers of the wikitext representation if a template is in one form or the other.
|
How the template's wikitext representation SHOULD be laid out. Authors MAY choose to use this parameter to express that a template will be better understood by other human readers of the wikitext representation if a template is in one form or the other.
|
||||||
|
@ -163,7 +163,8 @@ Whether this parameter is discouraged from usage. Seting to `false` indicates th
|
||||||
Authors are RECOMMENDED to, when marking a parameter as deprecated, provide a `string` of explanatory text describing why the parameter is deprecated (and what parameter or parameters the user should use instead). Alternatively, Authors MAY use the value `true` in absence of explanatory text.
|
Authors are RECOMMENDED to, when marking a parameter as deprecated, provide a `string` of explanatory text describing why the parameter is deprecated (and what parameter or parameters the user should use instead). Alternatively, Authors MAY use the value `true` in absence of explanatory text.
|
||||||
|
|
||||||
#### 3.2.6 `aliases`
|
#### 3.2.6 `aliases`
|
||||||
* Value: `Array`
|
* Value: `Array` of `integer` or `string`
|
||||||
|
* Default: `[]`
|
||||||
|
|
||||||
An array of alternative names for the parameter.
|
An array of alternative names for the parameter.
|
||||||
|
|
||||||
|
@ -172,7 +173,7 @@ Authors MUST NOT provide a `Param` object in `Root.params` for any alias. To des
|
||||||
Consumers SHOULD display aliases where entered as secondary to the primary name.
|
Consumers SHOULD display aliases where entered as secondary to the primary name.
|
||||||
|
|
||||||
#### 3.2.7 `type`
|
#### 3.2.7 `type`
|
||||||
* Value: `Type`
|
* Value: `Type`, see 3.4
|
||||||
|
|
||||||
The kind of value the template expects to be associated with this parameter.
|
The kind of value the template expects to be associated with this parameter.
|
||||||
|
|
||||||
|
@ -186,7 +187,7 @@ The key of another parameter from which this parameter will inherit properties.
|
||||||
Authors MUST ensure that the value matches the key of a `Param` object in `Root.params`.
|
Authors MUST ensure that the value matches the key of a `Param` object in `Root.params`.
|
||||||
|
|
||||||
#### 3.2.9 `autovalue`
|
#### 3.2.9 `autovalue`
|
||||||
* Value: `string`
|
* Value: `null` or `string`
|
||||||
|
|
||||||
A dynamically-generated default value in wikitext, such as today's date or the editing user's name; this will often involve wikitext substitution, such as `{{subst:CURRENTYEAR}}`.
|
A dynamically-generated default value in wikitext, such as today's date or the editing user's name; this will often involve wikitext substitution, such as `{{subst:CURRENTYEAR}}`.
|
||||||
|
|
||||||
|
@ -200,7 +201,7 @@ The default value in wikitext (or description thereof) of a parameter as assumed
|
||||||
Consumers SHOULD indicate this default value to the user when inserting or editing a template.
|
Consumers SHOULD indicate this default value to the user when inserting or editing a template.
|
||||||
|
|
||||||
#### 3.2.11 `suggestedvalues`
|
#### 3.2.11 `suggestedvalues`
|
||||||
* Value: `Array`
|
* Value: `Array` of `string`
|
||||||
* Default: `[]`
|
* Default: `[]`
|
||||||
|
|
||||||
A list of commonly used, suggested values.
|
A list of commonly used, suggested values.
|
||||||
|
@ -227,13 +228,13 @@ Authors are RECOMMENDED to ensure these are unique and distinguishable from othe
|
||||||
|
|
||||||
#### 3.3.2 params
|
#### 3.3.2 params
|
||||||
* Required
|
* Required
|
||||||
* Value: `Array`
|
* Value: `Array` of `string`
|
||||||
|
|
||||||
A list of one or more `Root.params` keys.
|
A list of one or more `Root.params` keys.
|
||||||
|
|
||||||
### 3.4 Type
|
### 3.4 Type
|
||||||
* Value: `string`
|
* Value: `string`
|
||||||
* Default: `"unknown"`
|
* Default: `'unknown'`
|
||||||
|
|
||||||
One of the following:
|
One of the following:
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue