Dev:Special Wiki Markup: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
(template:external)
Line 46: Line 46:
=== railML types ===
=== railML types ===


It shows a link to the basic [http://www.w3.org/TR/xmlschema-2 W3C XML schema type] re-used by railML for a certain reason. It does not cover complex types or enumeration lists.
It shows a link to the basic {{external|http://www.w3.org/TR/xmlschema-2 W3C XML schema type}} re-used by railML for a certain reason. It does not cover complex types or enumeration lists.


<pre><nowiki>{{RailMLType|<type-name>}}</nowiki></pre>
<pre><nowiki>{{RailMLType|<type-name>}}</nowiki></pre>
Line 54: Line 54:
=== Pure XML Schema types ===
=== Pure XML Schema types ===


It shows a link to the basic [http://www.w3.org/TR/xmlschema-2 W3C XML schema type].
It shows a link to the basic {{external|http://www.w3.org/TR/xmlschema-2 W3C XML schema type}}.


<pre><nowiki>{{XsdType|<type-name>}}</nowiki></pre>
<pre><nowiki>{{XsdType|<type-name>}}</nowiki></pre>

Revision as of 17:33, 12 January 2018

Generic documentation links for railML elements

The following templates may be used at every wiki page for refering to a certain railML element documentation site.

Link in angle brackets

The link is shown in angle brackets: <...>. It looks like an XML element.

  • Elements without parent inheritance
    {{<sub-schema-prefix>:Tag|<element-name>}}
    example: {{RS:Tag|fourQuadrantChopper}} results in <fourQuadrantChopper>
  • Elements with parent inheritance
    {{<sub-schema-prefix>:Tag|<element-name>|<parent-element-name>}}

    example: {{RS:Tag|additionalName|vehicle}} results in <additionalName>

Pure link

The link is shown pure without any characters around. This is better for reading a text flow.

  • Elements without parent inheritance
    {{<sub-schema-prefix>:Doc|<element-name>}}
    example: {{RS:Doc|fourQuadrantChopper}} results in fourQuadrantChopper
  • Elements with parent inheritance
    {{<sub-schema-prefix>:Doc|<element-name>|<parent-element-name>}}

    example: {{RS:Doc|additionalName|vehicle}} results in additionalName

Generic links for types

The following templates may be used at every wiki page for refering to a certain simple type constraint.

railML types

It shows a link to the basic W3C XML schema type http://www.w3.org/TR/xmlschema-2 W3C XML schema type (external link) re-used by railML for a certain reason. It does not cover complex types or enumeration lists.

{{RailMLType|<type-name>}}

example: {{RailMLType|tGenericRef}} results in xs:IDREF

Pure XML Schema types

It shows a link to the basic W3C XML schema type http://www.w3.org/TR/xmlschema-2 W3C XML schema type (external link).

{{XsdType|<type-name>}}

example: {{XsdType|string}} results in xs:string

Version management

The current wiki does not support version management itself. That's the reason for the templates explained in the following sections.

New objects

If new objects are introduced with some official version number, use the following template for showing it:

{{Intro | <version-number>}}

example: {{Intro | 2.1}} results in (introduced with version 2.1)

There is no difference in handling between elements, attributes, enumeration values, occurence changes...

Deprecated objects

If objects are declared "deprecated" they are kept until the next major release.

{{Depr | <version-number>}}

example: {{Depr | 2.1}} results in (deprecated with version 2.1)

There is no difference in handling between elements, attributes, enumeration values, occurence changes...

Attributes

The following template may be used at every wiki page for a corporate layout for attributes:

{{Attr | <attribute-name>}}

example: {{Attr | axleSequence}} results in axleSequence

Enumeration values

The following template may be used at every wiki page for a corporate layout for enumeration values:

{{Enum | <enumeration-value>}}

example: {{Enum | mechanical}} results in mechanical

German layout (de: Deutsche Auszeichnung)

It's a good practice to translate some paragraphs and/or words into German since there are many German railML users. In order to offer a flexible layout, please use the following template:

{{Deu | <deutscher-text>}}

example: {{Deu | Deutsche Erläuterung}} results in Deutsche Erläuterung

Please, use Template:rml for displaying the railML® logo. {{rml}} produces railML®. It is consens, that the initial letter r should allways be written small, and that the superscript ® should always be displayed. Both is granted for by the template. Don't use the superscript ® in URLs — such links cannot be processed! Instead, use railML in the URL and employ the vertical bar | to display an appropriate link text, e.g. [[How to join, edit and create the railML wiki|How to join, edit and create the {{rml}} wiki]] for How to join, edit and create the railML® wiki.