Template:TemplateData/entry/doc: Difference between revisions

From CrossCode Wiki
Jump to navigation Jump to search
Line 43: Line 43:
| Sequence
| Sequence
| +
| +
| Sequence of definition
| Sequence of definitions
|-
|-
| Alternative
| Alternative

Revision as of 17:27, 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: Data Dictionary Notation (modified BNF notation which is used in Data dictionaries)

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: [[#Data_Dictionary_Notation_.28DDN.29_for_types|Data Dictionary Notation]] (modified [https://en.wikipedia.org/wiki/Backus%E2%80%93Naur_form BNF notation] which is used in Data dictionaries)

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 types

Type Notation Description
Sequence + Sequence of definitions
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
  • Digit (0 - 9)
  • Boolean (0 or 1)
  • All parameter names of the current template

Examples

  • String + Number + {param}
  • Number + param

(param are in this examples an other parameter of the template)

  • String + " = " + 1 {String} 2
  • String + (Number)