Home Verschiedenes Abfragebefehle Ausgabeformate
 Die Anleitung zu UDO
 Die UDO-Syntax
 Verschiedenes

Formatspezifische Befehle

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

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:

amg AmigaGuide
aqv Apple-QuickView
asc ASCII
drc David's Readme Compiler
htag HP-Helptag-SGML
html HTML
hh HtmlHelp
info Texinfo
ipf OS/2 IPF
ldoc Linuxdoc-SGML
lyx LyX
man Manualpage
nroff Nroff
pas Pascal-Sourcecode
pch Pure-C-Help
pdf PDFLaTeX
ps PostScript
rtf RTF
src C-Sourcecode
stg ST-Guide
tex LaTeX
tvh Turbo-Vision-Help
udo UDO (Universal Document)
wh4 WinHelp4
win WinHelp

Um beispielsweise eine Zeile nur in das ASCII-Format auszugeben, gibt man folgendes an:

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

Um eine Zeile in allen Formaten außer dem ASCII-Format auszugeben, gibt man 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, daß 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 man in einen Quelltext einfügen muß, 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

 
Will man größere Blöcke im jeweiligen Format angeben, wäre es ziemlich mühsam, wenn man jede Zeile mit einem Kürzel beginnen müßte.
 
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
<FORM method=post action="mailto:info@dirk-hagedorn.de">
<PRE>
<p>    Name:  <INPUT name="Name" size=60>
<p>
<p>           <INPUT type=submit value="Absenden">
<p>           <INPUT type=reset value="L&ouml;schen">
</PRE>
</FORM>
!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 lediglich 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

 
Will man größere Blöcke als Kommentar in die Ausgabedatei schreiben, wäre es ziemlich mühsam, wenn man jede Zeile mit einem Kürzel beginnen müßte.
 
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.
 

Copyright © www.udo-open-source.org
Letzte Aktualisierung am 12. Januar 2004

Home Verschiedenes Abfragebefehle Ausgabeformate