Template:TemplateData/entry/doc: Difference between revisions

From CrossCode Wiki
Jump to navigation Jump to search
No edit summary
Line 15: Line 15:
{{TemplateData/entry|name=Parameter Description|param=desc|desc=Specify a description for a parameter of the template documentation|def=no description|type=String|status=Recommended}}
{{TemplateData/entry|name=Parameter Description|param=desc|desc=Specify a description for a parameter of the template documentation|def=no description|type=String|status=Recommended}}
{{TemplateData/entry|name=Parameter Example|param=example|desc=Specify an example for a parameter of the template documentation|def=no example|type=String|status=Recommended}}
{{TemplateData/entry|name=Parameter Example|param=example|desc=Specify an example for a parameter of the template documentation|def=no example|type=String|status=Recommended}}
{{TemplateData/entry|name=Parameter type|param=type|desc=Specify a type for a parameter of the template documentation: String, Number, Boolean, a Template or the modified [https://en.wikipedia.org/wiki/Backus%E2%80%93Naur_form BNF notation] which is used in Data dictionaries |def=NULL|type=String|status=Required}}
{{TemplateData/entry|name=Parameter type|param=type|desc=Specify a type for a parameter of the template documentation: String, Number, Boolean, a Template or the modified [https://en.wikipedia.org/wiki/Backus%E2%80%93Naur_form BNF notation] which is used in Data dictionaries (Data Dictionary Notation) |def=NULL|type=String|status=Required}}
{{TemplateData/entry|name=Parameter status|param=status|desc=Specify a status for a parameter of the template documentation (Required, Recommended, Optional)|def=NULL|type=String|status=Required}}
{{TemplateData/entry|name=Parameter status|param=status|desc=Specify a status for a parameter of the template documentation (Required, Recommended, Optional)|def=NULL|type=String|status=Required}}
}}
}}
Line 32: Line 32:
}}
}}
</pre>
</pre>
== Data Dictionary Notation (DDN) for custom types ==
{| class="wikitable"
|-
! Type
! Notation
! Description
|-
| Sequence
| +
| Sequence of definition
|-
| Alternative
| <nowiki>[...|...]</nowiki>
| Only one element out of this list
|-
| Repetition
| {...}
| Repetition of the definition
|-
| Repetition
| 2 {...}
| Repetition of the definition with the minimum of two
|-
| Repetition
| {...} 5
| Repetition of the definition with the maximum of five
|-
| Repetition
| 1 {...} 6
| Repetition of the definition with the minimum of one and the maximum of six
|-
| Option
| ()
| Optional definition
|-
| Specific value
| "..."
| fix definition
|}
=== Predefined ===
* String
* Number
* Boolean
* All parameter names of the current template
=== Examples ===
* String + Number + {param}
(param is in this example an other parameter of the template)
* String + " = " + 1 {String} 2


{{doc/end}}
{{doc/end}}

Revision as of 05:35, 9 December 2016

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. This template creates a single entry for the Required template Template:TemplateData.

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
Parameter title name

Specify a title for a parameter of the template documentation

Default:
NULL
Example:
no example
String Required
Parameter name param

Specify a name for a parameter of the template documentation

Default:
NULL
Example:
no example
String Required
Parameter alias1 alias1

Specify a alias for a parameter of the template documentation

Default:
NULL
Example:
no example
String Optional
Parameter alias2 alias2

Specify a alias for a parameter of the template documentation

Default:
NULL
Example:
no example
String Optional
Parameter alias3 alias3

Specify a alias for a parameter of the template documentation

Default:
NULL
Example:
no example
String Optional
Parameter Description desc

Specify a description for a parameter of the template documentation

Default:
no description
Example:
no example
String Recommended
Parameter Example example

Specify an example for a parameter of the template documentation

Default:
no example
Example:
no example
String Recommended
Parameter type type

Specify a type for a parameter of the template documentation: String, Number, Boolean, a Template or the modified BNF notation which is used in Data dictionaries (Data Dictionary Notation)

Default:
NULL
Example:
no example
String Required
Parameter status status

Specify a status for a parameter of the template documentation (Required, Recommended, Optional)

Default:
NULL
Example:
no example
String Required

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:

No description.

Template parameters

ParameterDescriptionTypeStatus
Parameter titlename

Specify a title for a parameter of the template documentation

Stringrequired
Parameter nameparam

Specify a name for a parameter of the template documentation

Stringrequired
Parameter alias1alias1

Specify a alias for a parameter of the template documentation

Stringoptional
Parameter alias2alias2

Specify a alias for a parameter of the template documentation

Stringoptional
Parameter alias3alias3

Specify a alias for a parameter of the template documentation

Stringoptional
Parameter Descriptiondesc

Specify a description for a parameter of the template documentation

Default
no description
Stringsuggested
Parameter Exampleexample

Specify an example for a parameter of the template documentation

Default
no example
Stringsuggested
Parameter typetype

Specify a type for a parameter of the template documentation: String, Number, Boolean, a Template or the modified [https://en.wikipedia.org/wiki/Backus%E2%80%93Naur_form BNF notation] which is used in Data dictionaries (Data Dictionary Notation)

Stringrequired
Parameter statusstatus

Specify a status for a parameter of the template documentation (Required, Recommended, Optional)

Stringrequired

Examples

Complete example:

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
Example name example param
Example alias 1
Example alias 2
Example alias 3

example description

Default:
NULL
Example:
xyz
String Required

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:

No description.

Template parameters

ParameterDescriptionTypeStatus
Example nameexample param Example alias 1 Example alias 2 Example alias 3

example description

Example
xyz
Stringrequired
{{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}}
}}

Data Dictionary Notation (DDN) for custom types

Type Notation Description
Sequence + Sequence of definition
Alternative [...|...] Only one element out of this list
Repetition {...} Repetition of the definition
Repetition 2 {...} Repetition of the definition with the minimum of two
Repetition {...} 5 Repetition of the definition with the maximum of five
Repetition 1 {...} 6 Repetition of the definition with the minimum of one and the maximum of six
Option () Optional definition
Specific value "..." fix definition

Predefined

  • String
  • Number
  • Boolean
  • All parameter names of the current template

Examples

  • String + Number + {param}

(param is in this example an other parameter of the template)

  • String + " = " + 1 {String} 2