Template:ElementDocu: Difference between revisions
[checked revision] | [checked revision] |
No edit summary |
No edit summary |
||
Line 21: | Line 21: | ||
-->{{#if:{{{intro|}}}|{{intro|{{{intro}}}}}}}{{#if:{{{depr|}}}|{{depr|{{{depr}}}}}}}<!-- | -->{{#if:{{{intro|}}}|{{intro|{{{intro}}}}}}}{{#if:{{{depr|}}}|{{depr|{{{depr}}}}}}}<!-- | ||
-->{{#if:{{{semcon|}}}|<br> <br>{{semconHint}}}}<!-- | -->{{#if:{{{semcon|}}}|<br> <br>{{semconHint}}}}<!-- | ||
-->{{#if:{{#var:interwiki}}|<br>The corresponding {{rml|3}} element is {{otherlink|{{#var:interwiki}}}}.}}<!-- | -->{{#if:{{#var:interwiki}}|<br> <br>The corresponding {{rml|3}} element is {{otherlink|{{#var:interwiki}}}}.}}<!-- | ||
-->{{#if:{{{interwiki}}}|<br>The corresponding {{rml|3}} element is {{otherlink|{{{interwiki}}}}}.{{interwiki|{{{interwiki}}}}}}} | -->{{#if:{{{interwiki}}}|<br> <br>The corresponding {{rml|3}} element is {{otherlink|{{{interwiki}}}}}.{{interwiki|{{{interwiki}}}}}}} | ||
===Attributes of {{{elementName|{{#var:autitle}}}}} / {{Deu|Attribute von {{{elementName|{{#var:autitle}}}}}}} / {{Fra|Attributs de {{{elementName|{{#var:autitle}}}}}}} === | ===Attributes of {{{elementName|{{#var:autitle}}}}} / {{Deu|Attribute von {{{elementName|{{#var:autitle}}}}}}} / {{Fra|Attributs de {{{elementName|{{#var:autitle}}}}}}} === | ||
{{#if:{{Boolandnoteq|{{{inheritedAttributes|}}}|{{{inheritedAttributes}}}|''None''}} | {{#if:{{Boolandnoteq|{{{inheritedAttributes|}}}|{{{inheritedAttributes}}}|''None''}} |
Revision as of 19:20, 24 January 2022
Usage
This template is the working horse of element documentation. It provides a standardized framework on which a number of ohter templates build upon.
Aricles employing the template have the following structure:
- Scheme description
- Position in the XML-Tree
- Parent
- Children: Not yet described. / Noch nicht beschrieben. /
- Semantics
- Attributes
- Constraints
- Best practice & Examples
- Notes
- Open issues
Arguments
- Obligatory:
- elementName — the name of the element
- semantics — a human readable explanation of the function of the described element
- Optional:
- parent — the name of the parent node within the XML tree
- childs — the children nodes
- ownAttributes — specific, not inherited attributes of this element
- constraints
- notes — general notes
- example
- openissues — comments on open issues
- intro – You can optionally enter the version when the element was introduced. It will produce a reminder at the top of the article
- depr – You can optionally enter the version when the element was deprecated. It will produce a reminder at the top of the article
- minocc – the minimum number of occurances – default=1
- maxocc – the maximum of occurances – default=1
- multi – Some comment to the multiplicity. E.g. version changes
- interwiki – The corresponding railML® 3 element (if applicable; use carefully!).
- Arguments to be discontinued — Do not use them anymore
- inheritedAttributes — inherited attributes from other data types — use ownAttributes, as the distinction between own and inherited attributes will no longer be presented in this wiki.
- bestpractice — use example, as the paragraphs Best Practice and Examples have been merged
Dependencies
The template depends on Template:Deu and Template:Fra. There is abig number of templates building on Template:ElementDocu.
Example
{{Template:ElementDocu|ElementName=SomeSampleElement|semantics=''This is an example. For readability reasons it is boxed.''}}
delivers
Scheme description / Schemenbeschreibung /Position of FIXME in the XML-Tree / Position von FIXME im XML-Baum /
Semantics / Bedeutung /This is an example. For readability reasons it is boxed. Attributes of FIXME / Attribute von FIXME /Not yet described. / Noch nicht beschrieben. / Constraints / Beschränkungen /Not yet described. / Noch nicht beschrieben. / Best practice & Examples / Empfohlene Anwendung & Beispiele /Not yet described. / Noch nicht beschrieben. / Notes / Anmerkungen /Not yet described. / Noch nicht beschrieben. / Not yet described. / Noch nicht beschrieben. / Open issues / Offene Punkte/Pedenzen /Not yet described. / Noch nicht beschrieben. / |
An example of the application of this template afield is IS:signal.