Formatspezifische Befehle

UDO bietet das !raw-Kommando und die raw-Umgebung an, mit denen es möglich ist, Zeilen nur dann auszugeben, wenn Sie in ein bestimmtes Format umwandeln.

In diesen Zeilen können dann spezielle Befehle für ein Format angegeben werden, die UDO dann 1:1, also Umwandlung von Sonderzeichen und ohne Einrückungen, ausgibt.

Bei dem !raw-Befehl spielen Kürzel eine große Rolle. Hier eine Übersicht, welches Kürzel für welches Ausgabeformat benutzt werden kann:

Um beispielsweise eine Zeile nur in das ASCII-Format auszugeben, geben Sie folgendes an:

!raw [asc] Diese Zeile erscheint nur im ASCII-Format

Um eine Zeile in allen Formaten außer dem ASCII-Format auszugeben, geben Sie folgendes an:

!ifndest [asc]
!raw [all] Diese Zeile erscheint nicht im ASCII-Format
!endif

Der Inhalt dieser Zeilen wird ohne das Kommando selbst, ohne Berücksichtigung von UDO-Kommandos und ohne Umwandlung von Sonderzeichen ausgegeben. Diese Zeilen sorgen - genau wie alle Kommandos - auch dafür, dass ein Absatz beendet wird. Diese Kommandos eignen sich also nicht dazu, mittem in einem Absatz unterschiedliche Sätze einzufügen!

Dieses Kommandos können dazu dienen, formatspezifische Kommandos einzufügen. Im folgenden Beispiel wird gezeigt, welche Kommandos Sie in einen Quelltext einfügen müssen, damit LaTeX weiß, mit welchem Stil ein Dokument auszudrucken ist und damit es einen Index erzeugt:

!no_preamble [tex]
!raw [tex] \documentstyle[11pt,german,makeidx]{article}
!raw [tex] \makeindex
[...]
!raw [tex] \printindex

Die raw-Umgebung

Wollen Sie größere Blöcke im jeweiligen Format angeben, wäre es ziemlich mühsam, wenn Sie jede Zeile mit einem Kürzel beginnen müssten.
Daher bietet UDO die raw-Umgebung an. Sie wird mit dem Befehl !begin_raw begonnen und mit dem Befehl !end_raw beendet.
Genau wie der Inhalt der Zeilen, die mit den obigen Formatkürzeln begonnen werden, gibt UDO diese Zeilen ohne Anpassung von Sonderzeichen und ohne Berücksichtigung von UDO-Befehlen direkt aus.
Zusammen mit der Möglichkeit, das Ausgabeformat abzufragen, in das ein Quelltext umgewandelt wird, können spezielle Befehle ausgegeben werden. Anwendungsbeispiele wären z.B. komplizierte Tabellen für LaTeX oder Formulare für HTML. Letzteres soll hier aufgezeigt werden:

!ifdest [html]
!begin_raw

Name: 




!end_raw
!else
In der HTML-Version befindet sich hier ein Formular.
!endif

Um noch einmal den Unterschied zur verbatim-Umgebung klarzumachen: Der Text einer verbatim-Umgebung wird 1:1 dargestellt. Würden Sie das obige Formular in eine verbatim-Umgebung packen, würden Sie im HTML-Browser nur den Quelltext des Formulars sehen! Nur bei der Verwendung der raw-Umgebung wird das Formular auch als solches vom HTML-Browser dargestellt.
Eine weitere Möglichkeit dazu bietet der Befehl !rinclude.

Die comment-Umgebung

Wollen Sie größere Blöcke als Kommentar in die Ausgabedatei schreiben, wäre es ziemlich mühsam, wenn Sie jede Zeile mit einem Kürzel beginnen müssten.
Daher bietet UDO die comment-Umgebung an. Sie wird mit dem Befehl !begin_comment begonnen und mit dem Befehl !end_comment beendet.
Genau wie der Inhalt der Zeilen, die mit !comment begonnen werden, gibt UDO diese Zeilen ohne Anpassung von Sonderzeichen und ohne Berücksichtigung von UDO-Befehlen als Kommentar aus.
Eine weitere Möglichkeit dazu bietet der Befehl !cinclude.