Bedingungen

Inhalte gezielt ein- und ausblenden

Mit Bedingungen (Conditionals) können Sie Textabschnitte in der Vorschau und Ausgabe ein- oder ausblenden. Das ist besonders nützlich in Kombination mit Produkten, um Inhalte für verschiedene Zielgruppen anzupassen.

Es gibt drei Arten von Bedingungen:

Syntax Wirkung

ifdef::attribut[]

Inhalt wird angezeigt, wenn das Attribut definiert ist

ifndef::attribut[]

Inhalt wird angezeigt, wenn das Attribut nicht definiert ist

ifeval::[ausdruck]

Inhalt wird angezeigt, wenn der Ausdruck wahr ist

ifdef und ifndef

Die einfachste Bedingung prüft, ob ein Attribut existiert:

 ifdef::ipad[]
 Dieser Text erscheint nur in der iPad-Version.
 endif::[]

 ifndef::ipad[]
 Dieser Text erscheint in allen Versionen außer iPad.
 endif::[]

Für kurze Texte gibt es eine einzeilige Variante ohne endif:

 ifdef::print[Nur im Druck sichtbar.]
 ifndef::print[Nur online sichtbar.]

Sie können auch mehrere Attribute kombinieren:

 ifdef::mac,ipad[]
 Erscheint wenn mac ODER ipad definiert ist.
 endif::[]

 ifdef::mac+pro[]
 Erscheint nur wenn mac UND pro definiert sind.
 endif::[]

ifeval für komplexe Bedingungen

Mit ifeval können Sie Ausdrücke auswerten:

 ifeval::[{version} >= 2]
 Diese Funktion ist ab Version 2.0 verfügbar.
 endif::[]

 ifeval::["{lang}" == "de"]
 Deutscher Inhalt
 endif::[]

Verfügbare Operatoren: ==, !=, <, <=, >, >=

Bedingungen werden vom adoc Coach unterstützt. Drücken Sie ESC nach if für Vorschläge.
Bedingungen entfalten ihre volle Stärke in Kombination mit Produkten. Definieren Sie Attribute wie :ipad: oder :beginner: in Ihren Produkten und steuern Sie damit, welche Inhalte in welcher Ausgabe erscheinen.