Template:TemplateData/doc: Difference between revisions

From CrossCode Wiki
Jump to navigation Jump to search
(Created page with "{{doc/start}} Template for creating a unified parameter format for templates == About == Creates a list that displays Template parameter in a unified format. == Parameter ==...")
 
(Use custom formatting)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{doc/start}}
{{Doc/start}}
Template for creating a unified parameter format for templates
Template for creating a unified parameter format for templates


Line 6: Line 6:


== Parameter ==
== Parameter ==
{{TemplateData|
{{TemplateData
{{TemplateData/entry|name=Entries|param=1|desc=Parameter list|def=NULL|type=List {[[Template:TemplateData/entry]]}|status=Required}}
| desc  = Creates a table that displays Template parameters in a unified format and emits the equivalent MediaWiki TemplateData.
| format = {{((}}_
{{!}} ______ = _
{{))}}
| params =
{{TemplateData/entry
| name   = Description
| param = desc
| desc   = The [[mw:Help:TemplateData#Description|MediaWiki TemplateData description property]], ignored if <code>noConvert</code> or <code>partial</code> is <code>1</code>.
| type  = Plaintext
| mwType = content
| status = Recommended
}}
}}
{{TemplateData/entry
| name  = Format
| param  = format
| desc  = The [[mw:Help:TemplateData#Format|MediaWiki TemplateData format string]], ignored if <code>noConvert</code> or <code>partial</code> is <code>1</code>.
| type  = [[Template:TemplateData/entry#FormatString|FormatString]]
| mwType = content
| status = Recommended
}}
{{TemplateData/entry
| name  = Entries
| param  = 1
| alias1 = params
| desc  = Parameter list
| type  = 1 {[[Template:TemplateData/entry]]}
| status = Required
}}
{{TemplateData/entry
| name    = Partial?
| param  = partial
| desc    = Whether this TemplateData block is not the last, ignored if <code>noConvert</code> is <code>1</code>.
| default = 0
| type    = Boolean
| status  = Optional
}}
{{TemplateData/entry
| name    = No Conversion
| param  = noConvert
| desc    =
If set, other than to 0, prevents [[mw:Help:TemplateData|MediaWiki TemplateData]] from being produced.


== Examples ==
Potentially useful if there are multiple instances of this template on a page but only one should be active. To clarify, this means that this template will ''not'' be understood by the VisualEditor.
 
| default = 0
'''Complete example:'''
| type   = Boolean
 
| status = Optional
{{TemplateData|
{{TemplateData/entry|name=Example name|alias1=Example alias 1|alias2=Example alias 2|alias3=Example alias 3|param=example param|desc=example description|def=NULL|example=xyz|type=String|status=Required}}
}}
}}
<pre>
{{TemplateData|
{{TemplateData/entry|name=Example name|alias1=Example alias 1|alias2=Example alias 2|alias3=Example alias 3|param=example param|desc=example description|def=NULL|example=xyz|type=String|status=Required}}
}}
}}
</pre>


{{doc/end}}
== Examples ==
{{#lsth:Template:TemplateData/entry/doc|Examples}}
{{Doc/end}}
<includeonly>
<!-- Categories for the template itself -->
[[Category:Documentation templates]]
</includeonly>

Latest revision as of 18:23, 23 May 2021

File:Template-info.svg Template Documentation

Template for creating a unified parameter format for templates

About

Creates a list that displays Template parameter in a unified format.

Parameter

Do not use named parameter for 1 ... x. The first Parameter will be automatically marked as 1, the second as 2 and so on.

Parameter Description Type Status
Description desc

The MediaWiki TemplateData description property, ignored if noConvert or partial is 1.

Example:
no example
Plaintext Recommended
Format format

The MediaWiki TemplateData format string, ignored if noConvert or partial is 1.

Example:
no example
FormatString Recommended
Entries 1
params

Parameter list

Example:
no example
1 {Template:TemplateData/entry} Required
Partial? partial

Whether this TemplateData block is not the last, ignored if noConvert is 1.

Default:
0
Example:
no example
Boolean Optional
No Conversion noConvert

If set, other than to 0, prevents MediaWiki TemplateData from being produced.

Potentially useful if there are multiple instances of this template on a page but only one should be active. To clarify, this means that this template will not be understood by the VisualEditor.

Default:
0
Example:
no example
Boolean Optional
Format:
Custom:
{{_
| ______ = _
}}

See Template:TemplateData and Template:TemplateData/entry for more information about the parameter list and DDNCode for more information about types and the DDN Notation

Test of raw TemplateData output:

Creates a table that displays Template parameters in a unified format and emits the equivalent MediaWiki TemplateData.

Template parameters

This template has custom formatting.

ParameterDescriptionTypeStatus
Descriptiondesc

The [[mw:Help:TemplateData#Description|MediaWiki TemplateData description property]], ignored if <code>noConvert</code> or <code>partial</code> is <code>1</code>.

Contentsuggested
Formatformat

The [[mw:Help:TemplateData#Format|MediaWiki TemplateData format string]], ignored if <code>noConvert</code> or <code>partial</code> is <code>1</code>.

Contentsuggested
Entries1 params

Parameter list

Contentrequired
Partial?partial

Whether this TemplateData block is not the last, ignored if <code>noConvert</code> is <code>1</code>.

Default
0
Booleanoptional
No ConversionnoConvert

If set, other than to 0, prevents [[mw:Help:TemplateData|MediaWiki TemplateData]] from being produced. Potentially useful if there are multiple instances of this template on a page but only one should be active. To clarify, this means that this template will ''not'' be understood by the VisualEditor.

Default
0
Booleanoptional

Examples

{{#lsth:Template:TemplateData/entry/doc|Examples}}