Inhaltsbasierte Auswahl

Präprozessor-Funktion

Der Wahlschalter fügt z.B. abhängigg Yaml-Variablen einen Text ein.

choice wird vorrangig bei den Präprozessor-Funktionen abgearbeitet.

• Es können beliebig viele Werte, getrennt durch | (ALT < - Taste) angegeben werden.

  Ausgegeben wird der erste von rechts gefundene Wert, der länger als 0 Zeichen ist (umschließende Leerzeichen werden entfernt). Die Funktion wird durch den gefundenen Text ersetzt.

• Wird die Zeichenfolge .-., Punkt Strich Punkt1, gefunden, wird eine „leere“ Ausgabe erzeugt: Eine „leere“ Variable führt zur Wahl des Wertes links daneben.

  Mit der „Schalterfunktion“ von „!“Variablen lassen sich Absätze steuern.

  Eine fehlende „!Variable“ in der Funktion löscht den vollständigen Absatz, statt die nachfolgende Option auszugeben.

• Hat choice ein + an einer beliebigen Stelle in der Zuordnung, wird vor dem Text ein gleichnamiger Anker erzeugt. Wird der Anker angesprungen, gewährliestet das für die Sichtbarkeit des relevanten Textes.

• Beginnt die Zuordnung mit einer Zahl 1-6, wird der HTML-Code für eine Überschrift des entsprechenden Rangs erzeugt.

  In diesem Fall wird die +-Option ingoriert: Es wird wie für alle Überschriften ein id=… erzeugt, der als Anker verwendet werden kann. Die so generierten Überschriften können deshalb in einem Inhaltsverzeichns angesprungen werden kann.

  Die Überschrift-Option sollte in einer Markdown Datei alleinstehend in einem Absatz verwendet werden, andernfalls wird ungültiger HTML-Code entstehen.

  Bei Verwendung z.B. innerhalb einer Layout-Datei sollte darauf geachtet werden, dass mit der Ausgabe gültige Strukturen entstehen.

Definition

$$$ choice [1..6|+]zuordnung :[variante 1 | variante 2 | … ]  $$$

[1..6|+]Zuordnung

Eindeutiger Funktionsname. Beginnt dieser mit 1..6, erfolgt die Ausgabe als HTML-Überschrift der entsprechenden Hierarchie.

Enthält der Funktionsnahme irgendwo ein +, wird vor der Ausgabe ein gleichnamiger Anker des gewählten Textes erzeugt.

variante | variante | …

Eine bliebige Anzahl Varianten. Ausgegeben wird der erste Eintrag von rechts, der mindestens ein Zeichen ≠ Leerzeichen enthält.

variante = .-.

Umschließende Leerzeichen werden entfernt, weshalb „nichts“ als Ausgabe diese spezielle Notation erfordert.

Beispiele

$$$ choice 1+c5 : %%­%Titel%%­% | %%­%Ersatztitel%%­% $$$

• Wahlweise aus der YamlVariable „Titel“ oder „Ersatztitel“ wird eine „H1“-Überschrift erzeugt.
• Steht im Ersatztitel .-., wird die Funktion ohne Ausgabe (auch kein HTML-Code) entfernt.
• Die Ankerfunktion + wird ignoriert: Überschriften erhalten eine ID.
• Maßgeblich für den Überschrift-Rang ist die Zahl an erster Stelle in der Zuordnung. An anderer Stelle sind Zahlen Bestandteil des Zuordnungsnamens.

$$$ choice +was : keine | %%­%blume1%%­% | %%­%blume2%%­% $$$

• Abhängig von den Inhalten der Variablen wird sowohl ein Text, also auch ein gleichlautender Anker erzeugt.