Batix-Tags Referenz
Hinweis für (fast) alle Tags: für Parameterwerte können auch Präfix-Variablen eingesetzt werden.
Syntax-Konventionen
<bx:tag1.{command} static="value" [not] />
<bx:tag2 [optional="(option1 | option2)"] />
<bx:tag3 [first | last] />
<bx:tag4 required="(option1 | option2)">{content}</bx:tag> <!-- 'content' darf auch leer sein -->
Zur besseren Lesbarkeit steht ein Leerzeichen vor dem Ende selbstschließender Tags, also vor />.
Platzhalter sind mit { } umschlossen (siehe command und content). Im Beschreibungstext der Tags werden die Platzhalter genauer bestimmt, z.B. welche Werte oder Typen zugelassen sind.
Optionaler Code ist mit [ ] umschlossen (siehe not, optional und first / last). Dies bedeutet, dass dieser Bereich komplett weggelassen werden kann.
Pflichtauswahlen werden mit ( ) und Auswahlen, die auch komplett weggelassen werden können, werden mit [ ] umschlossen. Die jeweiligen Möglichkeiten sind durch | getrennt.
Falls unbedingt nötig, sind Kommentare in der Form <!-- Kommentartext --> eingefügt, diese Art der Beschreibung sollte allerdings nur in Ausnahmefällen auftauchen.
Diese Beispiele sind laut der obigen Definition valide:
<bx:tag1.replace static="value" />
<bx:tag2 />
<bx:tag2 optional="option1" />
<bx:tag3 />
<bx:tag3 first />
<bx:tag4 required="option2">Lorem Ipsum</bx:tag>
Die folgenden Beispiele sind allerdings nicht valide (das Kommentar hinter jedem Beispiel beschreibt warum):
<bx:tag1 static="value" /> <!-- der Platzhalter 'command' muss gefüllt werden -->
<bx:tag1.replace /> <!-- der Parameter 'static' muss exakt aus der Definition übernommen werden -->
<bx:tag2 optional="option3" /> <!-- 'option3' steht nicht zur Auswahl -->
<bx:tag2 optional="" /> <!-- es muss eine der Optionen gewählt werden -->
<bx:tag3 middle /> <!-- 'middle' steht nicht zur Auswahl -->
<bx:tag4 required=""></bx:tag> <!-- es muss eine Option für 'required' gewählt werden, leerer Taginhalt ist laut Kommentar in Ordnung -->