Template:ElementDocu: Difference between revisions
[unchecked revision] | [unchecked revision] |
Line 86: | Line 86: | ||
==Example== | ==Example== | ||
<nowiki>{{Template:ElementDocu|ElementName=SomeSampleElement|semantics=This is an example. For readability reasons it is boxed.}}</nowiki> | <nowiki>{{Template:ElementDocu|ElementName=SomeSampleElement|semantics=''This is an example. For readability reasons it is boxed.''}}</nowiki> | ||
delivers | delivers | ||
{|border="5" | {|border="5" | ||
|{{ | | | ||
== Scheme description / {{Deu|Schemenbeschreibung}} / {{Fra|Description du schéma}} == | |||
=== Position of FIXME in the XML-Tree / {{Deu|Position von FIXME im XML-Baum}} / {{Fra|position de FIXME dans l’aborescence XML}} === | |||
* Parent: ''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
* Children: ''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
=== Semantics / {{Deu|Bedeutung}} / {{Fra|Sémantique}} === | |||
''This is an example. For readability reasons it is boxed.'' | |||
=== Inherited attributes from other data types / {{Deu|Abgeleitete Attribute von anderen Datentypen}} / {{Fra|Attributs hérités d’autres types données}} === | |||
''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
=== Specific Attributes of FIXME / {{Deu|Spezielle Attribute von FIXME}} / {{Fra|Attributs spécifiques de FIXME}} === | |||
''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
=== Constraints / {{Deu|Beschränkungen}} / {{Fra|Contraintes}} === | |||
''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
== Best practice / {{Deu|Empfohlene Anwendung}} / {{Fra|Bonnes pratiques}} == | |||
''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
== Additional information / {{Deu|Zusätzliche Informationen}} / {{Fra|Information supplémentaire}} == | |||
=== Notes / {{Deu|Anmerkungen}} / {{Fra|Notes}} === | |||
''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
=== Example / {{Deu|Beispiel}} / {{Fra|Exemple}} === | |||
''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
== Open issues / {{Deu|Offene Punkte/Pedenzen}} / {{Fra|Questions ouvertes}} == | |||
''Not yet described. / {{Deu|Noch nicht beschrieben.}} / {{Fra|Pas encore décrit.}}'' | |||
[[Category:{{ | |||
#switch: {{#explode:{{FULLPAGENAME}}|:}} | |||
|CO = Common_Elements | |||
|IS = Infrastructure_Elements | |||
|RS = Rollingstock_Elements | |||
|TT = Timetable_Elements | |||
|Vorlage = Element_Template | |||
|FIXME | |||
}}|{{#explode:{{FULLPAGENAME}}|:|-1}}]] | |||
|} | |} | ||
[[Category:ContentTemplate]]</noinclude> | [[Category:ContentTemplate]]</noinclude> |
Revision as of 20:17, 11 February 2016
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
- Inherited attributes from other data types
- Specific Attributes
- Constraints
- Best practice
- Additional information
- Notes
- Example
- Open issues
Parameters
- 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
- inheritedAttributes — inherited attributes from other data types
- ownAttributes — specific, not inherited attributes of this element
- constraints
- bestpractice — comments about best practice
- notes — general notes
- example
- openissues — comments on open issues
Dependencies
The template depends on Template:Deu and Template:Fra. There is abig number of templates building on Template:ElementDocu, eg: Template:InheritContractor
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. Inherited attributes from other data types / Abgeleitete Attribute von anderen Datentypen /Not yet described. / Noch nicht beschrieben. / Specific Attributes of FIXME / Spezielle Attribute von FIXME /Not yet described. / Noch nicht beschrieben. / Constraints / Beschränkungen /Not yet described. / Noch nicht beschrieben. / Best practice / Empfohlene Anwendung /Not yet described. / Noch nicht beschrieben. / Additional information / Zusätzliche Informationen /Notes / Anmerkungen /Not yet described. / Noch nicht beschrieben. / Example / Beispiel /Not yet described. / Noch nicht beschrieben. / Open issues / Offene Punkte/Pedenzen /Not yet described. / Noch nicht beschrieben. / |