############################################################
# @(#) verbatim-Umgebung
# 22.01.1996: Hinweis auf die raw-Umgebung
############################################################

!subsubnode	Vorformatierter Text
!alias verbatim-Umgebung

UDO sorgt selbständig für die Formatierung des auzugebenden Textes. Dies
ist jedoch nicht immer erwünscht. Will man beispielsweise Schnippsel eines
Sourcecodes darstellen, wäre es fatal, würde UDO hier eine Formatierung
vornehmen.

Zur Ausgabe von vorformatiertem Text kann man sich daher der
verbatim-Umgebung bedienen, welche mit (!I)!/begin_verbatim(!i)
begonnen und mit (!I)!/end_verbatim(!i) beendet wird.

Der Text, der innerhalb dieser Umgebung steht, wird nicht besonders
behandelt, sprich es wird der Zeilenumbruch exakt übernommen und es
werden keine UDO-Kommandos(!N)bis auf (!I)!/end_verbatim(!i)(!n) bearbeitet.
Steht eine verbatim-Umgebung allerdings in einer anderen Umgebung, so wird
der vorformatierte Text zusätzlich eingerückt. Beachten Sie dazu auch den
Hinweis am Ende dieses Abschnitts.

Bei der Ausgabe ins (!LaTeX)-Format werden die gleichnamigen Befehle
(!V)\begin{verbatim}(!v) und (!V)\end{verbatim}(!v) ausgegeben, bei den
anderen Formaten wird (falls nötig) ein nichtproportionaler Font
eingestellt und Sonderzeichen automatisch angepaßt.

!index !/tabwidth

Tabulatoren, die innerhalb einer verbatim-Umgebung auftauchen, werden
von UDO automatisch durch Leerzeichen ersetzt. Durch den Schalter
(!I)!/tabwidth(!i) können Sie UDO mitteilen, mit welcher
Tabulatorbreite der Text geschrieben wurde.

!smallskip

!index !/vinclude

Da innerhalb einer verbatim-Umgebung keine UDO-Kommandos und somit auch
nicht (!I)!/include(!i) beachtet werden, wäre es nicht möglich, eine externe
Datei einzuladen und diese unformatiert darzustellen. Aus diesem Grund
bietet UDO den Befehl (!I)!/vinclude(!i) an, der eine
Befehlskombination aus (!I)!/begin_verbatim(!i), (!I)!/include(!i)
und (!I)!/end_verbatim(!i) darstellt.

Falls Sie jedoch Passagen benutzen wollen, die bereits im Ausgabeformat
geschrieben wurden (z.B. eine mit (!LaTeX) gesetzte Tabelle), so muß man
sich der raw-Umgebung bedienen.

!smallskip

(!HINTS)

!begin_enumerate

!item Da andere Umgebungen im Quelltext eingerückt werden können, erscheint
es verlockend, auch eine verbatim-Umgebung im Quelltext passend einzurücken.
Bedenken Sie allerdings, daß führende Leerzeichen bei der Ausgabe des
vorformatierten Textes übernommen werden und dieser dann in der späteren
Ausgabedatei zuweit rechts stehen wird, falls Sie den Text der
verbatim-Umgebung einrücken.

!item	Der Unterschied zur raw-Umgebung besteht darin, daß der Text
der verbatim-Umgebung 1:1 dargestellt wird. Text der raw-Umgebung wird
hingegen 1:1 übernommen und dient daher der Einbindung spezieller
Formatbefehle.

!end_enumerate

