Benutzer:Revvar/VM/XML-Schema
aus Wikipedia, der freien Enzyklopädie
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="TemplateUsage"> <xs:annotation> <xs:documentation>Wurzelknoten, welcher die Beschreibung enthält.</xs:documentation> </xs:annotation> <xs:complexType> <xs:choice> <xs:element ref="Group" minOccurs="1" maxOccurs="unbounded"/> </xs:choice> <xs:attribute name="output" use="optional" default="collapse"> <xs:annotation> <xs:documentation>(optional) - Beschreibt die Art des erzeugten Vorlagen-Quelltextes.
Vorgabe: "collapse" - Es werden nur Parameter genutzt, denen ein Wert zugewiesen wurde. Leere Parameter fallen weg. Der Quelltext enthält keine Zeilenumbrüche. Diese Ausgabe eignet sich bei Vorlagen mit wenigen Parametern und intuitiven Namen (zum Beispiel: http://de.wikipedia.org/wiki/Vorlage:Literatur). Alternativ: "expand" - Der Vorlagenquelltext enthält alle, auch leere, Parameter. Zusätzlich wird bei benannten Gruppen, der Gruppenname als HTML-Kommentar eingefügt, sowie die Gruppen durch eine zusätzliche Leerzeile optisch getrennt. Jeder Parameter steht auf einer separaten Zeile. Diese Ausgabeart eignet sich für Vorlagen mit einer Vielzahl von Parametern, und erleichtert Nutzern ohne Toolunterstützung, die Arbeit mit der Vorlage (zum Beispiel: http://de.wikipedia.org/wiki/Vorlage:Infobox Schienenfahrzeug).
</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="collapse"/>
<xs:enumeration value="expand"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="Group">
<xs:annotation>
<xs:documentation>Gruppiert eine Menge von Parametern. Im Formular werden diese in einem separaten Bereich dargestellt. Ist eine Gruppierung nicht zweckmäßig, so sind alle Parameter in einer einzigen Gruppe zu beschreiben.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:choice>
<xs:element ref="Parameter" maxOccurs="unbounded"/>
</xs:choice>
<xs:attribute name="name" use="optional" type="xs:string">
<xs:annotation>
<xs:documentation>(optional) - Beschreibt den Inhalt der Gruppe. Ist dieses Attribut angegeben, so wird es als Gruppenüberschrift angezeigt.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="showempty" use="optional" default="true">
<xs:annotation>
<xs:documentation>(optional) - Legt fest ob im Ausgabemodus „expand“ die Gruppe angezeigt werden soll, wenn kein Parameter dieser Gruppe ein Wert zugewiesen wurde.
Vorgabe: "true" - Alle Parameter der Gruppe werden ausgegeben, auch wenn keinem ein Wert zugewiesen wurde. Alternativ: "false" - Alle Parameter dieser Gruppe werden nur ausgegeben, wenn wenigstens einem Parameter ein Wert zugewiesen wurde.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="true"/>
<xs:enumeration value="false"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="Parameter">
<xs:annotation>
<xs:documentation>Beschreibt einen benannten Parameter der Vorlage. Nur als Kindknoten von "Group" erlaubt.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:choice minOccurs="0">
<xs:sequence>
<xs:element ref="Help"/>
<xs:choice minOccurs="0">
<xs:sequence>
<xs:element ref="Default"/>
<xs:choice minOccurs="0">
<xs:element ref="Value" maxOccurs="unbounded"/>
<xs:element ref="Condition"/>
</xs:choice>
</xs:sequence>
<xs:sequence>
<xs:choice>
<xs:element ref="Value" maxOccurs="unbounded"/>
<xs:element ref="Condition"/>
</xs:choice>
<xs:element ref="Default" minOccurs="0"/>
</xs:sequence>
</xs:choice>
</xs:sequence>
<xs:sequence>
<xs:element ref="Default"/>
<xs:choice minOccurs="0">
<xs:sequence>
<xs:element ref="Help"/>
<xs:choice minOccurs="0">
<xs:element ref="Value" maxOccurs="unbounded"/>
<xs:element ref="Condition"/>
</xs:choice>
</xs:sequence>
<xs:sequence>
<xs:choice>
<xs:element ref="Value" maxOccurs="unbounded"/>
<xs:element ref="Condition"/>
</xs:choice>
<xs:element ref="Help" minOccurs="0"/>
</xs:sequence>
</xs:choice>
</xs:sequence>
<xs:sequence>
<xs:choice>
<xs:element ref="Value" maxOccurs="unbounded"/>
<xs:element ref="Condition"/>
</xs:choice>
<xs:choice minOccurs="0">
<xs:sequence>
<xs:element ref="Default"/>
<xs:element ref="Help" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element ref="Help"/>
<xs:element ref="Default" minOccurs="0"/>
</xs:sequence>
</xs:choice>
</xs:sequence>
</xs:choice>
<xs:attribute name="name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name des Parameters.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="label" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>(optional) - Alternative Bezeichnung, die statt des Namens im Formular angezeigt wird. Zum Beispiel: „Chefredakteur“ statt „chefred“.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="length" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>(optional) - Länge des Eingabefeldes in Zeichen oder „max“. Letzere Angabe bewirkt das der Parameter vollständig über eine eigene Zeile gestreckt wird. Bei Zahlenangaben variiert die tatsächliche Länge leider je nach verwendeten Browser und verwendeter Schritart. Es können aber mindestens die angegebenen Anzahl von Zeichen dargestellt werden. Sinnvoll ist die Angabe bei Parametern mit inhaltlich begrenzter Länge, wie Höhen- und Geschwindigkeitsangaben, und bei Parametern denen in der Regel sehr lange Texte übergeben werden. Vorgabe sind 20 Zeichen.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="height" type="xs:positiveInteger" use="optional">
<xs:annotation>
<xs:documentation>(optional) - Höhe des Eingabefeldes in Zeilen. Vorgabe ist eine Zeile.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="null" use="optional" default="true">
<xs:annotation>
<xs:documentation>(optional) - Legt fest, ob ein Wert für diesen Parameter eingegeben werden muss.
Vorgabe: "true" - Ein leeres Feld ist erlaubt - es muss kein Wert eingegeben werden. Alternativ: "false" - Die Angabe eines Wertes ist Pflicht. Der Parametername ist im Formular unterstrichen. Vor dem Übernehmen der Eingaben prüft das Programm, ob ein Wert eingegeben wurde, und markiert dieses Feld im Fehlerfall.
</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="true"/>
<xs:enumeration value="false"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="predefined" use="optional" default="false">
<xs:annotation>
<xs:documentation>(optional) - Sagt aus, ob die Vorlage für diesen Parameter einen vordefinierten Wert nutzt, wenn kein Wert übergeben wird.
Vorgabe: "false" - Es existiert kein vordefinierter Wert. Bei der Ausgabeart „expand“, wird der Parameter bei fehlender Eingabe auch mit leerem Inhalt im Vorlagentext erzeugt (zum Beispiel: „ISBN=“). Alternativ: "true" - Es existiert ein vordefinierter Standardwert für diesen Parameter. Dies hat bei der Ausgabe „expand“ die Auswirkung, dass der Parameter, wenn er leer ist, ohne Gleichheitszeichen erzeugt wird. Dadurch bleibt er weiterhin dokumentiert, ist aber trotzdem nicht definiert. Stattdessen erzeugt dies einen unbenannten Parameter (zum Beispiel {{{1}}}) mit dem Parameternamen als Inhalt.
</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="true"/>
<xs:enumeration value="false"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="Help" type="xs:string">
<xs:annotation>
<xs:documentation>(optional) - Enthält eine Hilfetext, der die Verwendung des Parameters beschreibt. Im Formular wird dieser in der Statuszeile angezeigt, wenn das dazugehörige Eingabefeld aktiv ist. Des weiteren wird die Hilfe als Tooltip angezeigt. Nur als Kindknoten von "Parameter" erlaubt.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Value">
<xs:annotation>
<xs:documentation>(optional) - Erlaubt die Angabe eines Wertes die der Parameter annehmen darf. Im Formular wird anstatt eine Texteingabefeldes eine Auswahlliste angezeigt, welches mit allen Value-Elementen des Parameters gefüllt ist. Nur als Kindknoten von "Parameter" erlaubt.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="label" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>(optional) - Alternative Bezeichnung, die statt des Namens im Formular angezeigt wird. Zum Beispiel: „Chefredakteur“ statt „chefred“.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="Condition">
<xs:annotation>
<xs:documentation>(optional) - Erlaubt die Angabe eines regulären Ausdrucks, der für eine gültige Eingabe erfüllt sein muss. Vor dem Übernehmen der Eingaben prüft das Programm die Gültigkeit und markiert dieses Feld im Fehlerfall.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Default">
<xs:annotation>
<xs:documentation>(optional) - Über diesen Kindknoten von „Parameter“ lässt sich ein Vorgabewert festlegen, mit dem das Eingabefeld immer vorausgefüllt wird, wenn es leer ist.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:schema>
