Handbuch UDO: Änderungen in Version 7.00

Änderungen in Version 7.00

UDO 7 ist ein großer Sprung seit der letzten veröffentlichten Version. Vor allem die volle Unicode-Unterstützung und viele Verbesserungen in der HTML-Ausgabe machen diese Version sehr wertvoll.

UDO 7.00 wurde am 01.03.2010 veröffentlicht.

Schriftauszeichnung

Neue Kommandos:

(!SUP)...(!sup) Text hochgestellt ausgeben

(!SUB)...(!sub) Text tiefgestellt ausgeben

(!INS)...(!ins) Einfügungen erzeugen

(!DEL)...(!del) Gelöschten Text visualisieren

Sprachen

Neue Sprachen für UDO-Standardtexte:

!language [czech] Tschechisch

!language [danish] Dänisch

!language [polish] Polnisch

!language [swedish] Schwedisch

Farben

Die 16 Standardfarben existieren jetzt in UDO als Platzhalter für die Ausgabe von HTML, RTF, WinHelp, DRC und PostScript. Die Farben werden wie folgt angegeben: (!black), (!red) usw. Abgeschlossen wird jeweils mit (!coloff).

Tabellen

In der Tabellen-Umgebung können Kommentare eingefügt werden.
In der Tabellen-Umgebung können Labels eingefügt werden.
In Tabellen werden UDO-Universalzeichen jetzt korrekt ausgegeben.
Tabellen-Zellen dürfen jetzt max. 700 Zeilen hoch sein.

Encodings

UDO unterstützt jetzt 18 Ein-Byte-Codepages und Unicode (UTF-8). Wesentlicher Unterschied zu früheren UDO-Versionen ist, dass sämtliche Codepages intern im Unicode-Format verwaltet werden. Dadurch sind Konvertierungsverluste nicht mehr so groß wie früher.
Die Encodings sowohl der UDO-Dokumente als auch der Zielformate lassen sich über zwei neue Kommandos eindeutig und unabhängig vom UDO-Programm definieren:

!code_source legt das Quellformat-Encoding der UDO-Dokumente fest.

!code_target legt das Ausgabe-Encoding fest.
Das früher verwendete UDO-Kommando !code ist nicht mehr verfügbar. Ändern Sie Ihre UDO-Dokumente entsprechend ab.
Die UDO-Universalzeichen wurden erweitert und deren Umsetzung ins jeweilige Zielformat verbessert.

Strukturelles

!docinfo hat weitere Argumente erhalten:

[category]	bezeichnet eine Kategorie, zu der das Dokument gehört.
[company]	bezeichnet die Firma, für die ein Dokument erstellt wird. Wenn [company] benutzt wird, wird auf der Titelseite unter Autor für [company] eingefügt.
[distributor]	bezeichnet die Firma, die das Produkt oder Dokument vertreibt. Wenn [distributor] benutzt wird, wird auf der Titelseite nach Autor und Firma Distributor: [distributor] eingefügt.
[translator]	bezeichnet den Namen des Übersetzers, der das Produkt oder Dokument übersetzt hat. Wenn [translator] benutzt wird, wird auf der Titelseite nach Autor und Firma Übersetzung: [translator] eingefügt.

Die !docinfo-Optionen [program] und [programimage] schließen sich nicht mehr gegenseitig aus, sondern können jetzt gleichzeitig ausgegeben werden. Wenn beide benutzt werden, wird [program] zuerst ausgegeben.
Index-Link im Inhaltsverzeichnis:

!use_udo_index Wenn dieser Schalter benutzt wird, wird ein Link Index im Abschnitt !tableofcontents ausgegeben.

Zeilen zusammenkleben:

!\ Endet eine UDO-Eingabezeile mit !\, wird die folgende Zeile von UDO als Fortsetzung der vorhergehenden Zeile aufgefasst. Es können damit mehrere echte Zeilen aus Sicht von UDO zu einer einzigen logischen Eingabezeile zusammengefasst werden. Diese Fortsetzungszeilen sind an jeder Stelle im UDO-Quelltext zulässig, auch z.B. in Makros und Definitionen. Steht !\ nicht unmittelbar am Ende einer Zeile, wird es ignoriert und als normaler Text ausgegeben.

Eine mögliche Anwendung ist, den Inhalt einer Tabellenzeile auf mehrere Zeilen in der Eingabedatei aufzuteilen, um die Lesbarkeit des UDO-Quelltextes zu verbessern.

Vorher:

!begin_table
Das hier ist Zelle 1 !! !\
Das hier ist Zelle 2 !! !\
Das hier ist Zelle 3
!end_table

Nachher:

Das hier ist Zelle 1

Das hier ist Zelle 2

Das hier ist Zelle 3

Neuer Kommandozeilen-Parameter:

--no-warningslines Keine Warnungen ausgeben

-Wl Kurzschreibweise des o.g. Kommandozeilen-Parameters.

Neue Schalter:

!use_short_descriptions	Gibt alle Description-Umgebungen kompress, also ohne zusätzliche Leerzeilen zwischen Absätzen, aus.
!use_short_enumerates	Gibt alle Enumerate-Umgebungen kompress, also ohne zusätzliche Leerzeilen zwischen Absätzen, aus.
!use_short_itemizes	Gibt alle Itemize-Umgebungen kompress, also ohne zusätzliche Leerzeilen zwischen Absätzen, aus.
!use_short_lists	Gibt alle Listen-Umgebungen kompress, also ohne zusätzliche Leerzeilen zwischen Absätzen, aus.

Diese vier neuen Schalter bieten eine differenziertere Steuerung der Umgebungen-Formatierung, als es durch den Generalschalter !use_short_envs möglich ist. Sofern aber der Generalschalter gesetzt ist, sind die o.g. vier Schalter als Teilmengen davon wirkungslos.

Neues Kommando:

(!label) Erzeugt manuelle Links an beliebigen Stellen im Fließtext.

UDO

Die UDO Community ist in dem Text ergänzt worden, der von !use_about_udo ausgegeben wird.
Die Bezeichnung der einzelnen Versionen wurde geändert. Es heißt jetzt nicht mehr Release 6.x Patchlevel yy, sondern schlicht Version 7.xy.
Die OS/2-Version von UDO meldet sich jetzt als UDO for OS/2.

Allgemeine Fehlerbehebungen

Bugfix #38: Zeichenausgaben (nicht nur in Mac-Encodings) sollten dank Umstellung auf Unicode keine Fehler mehr haben.
Bugfix #45/#77: Stack-Overflow mit der DOS-Version von UDO behoben.
Bugfix #48: Fehlermeldung unknown command: !html_use_hyphenation. Ursache: Das Kommando fehlte in der Kommandoliste.
Bugfix #55: Umlaute, die in (!img) oder (!ilink) im zweiten Parameter vorkamen, wurden nicht richtig umgesetzt.
Bugfix #59: Nichtfunktion, wenn Makro intern eine Definition aufruft.
Bugfix #75: !raw-Ausgaben korrigiert.
Bugfix #78: Sortierung in der Index-Seite (z.B. indexudo.htm) wesentlich verbessert.

HTML Apple Help

Neues Ausgabeformat: HTML Apple Help
Ist im Prinzip nichts anderes als HTML, allerdings mit kleinen Änderungen. Deshalb gibt es auch für !docinfo für dieses Format zwei neue Argumente:

[AppleTitle] legt den (lokalisierbaren) Titel der Hilfe fest.

[AppleIcon] legt das Icon fest, das der Apple Help Viewer in der Auflistung aller Programmhilfen für diese Hilfe zeigen soll.

Hypertext Markup Language (HTML)

Neue Kommandos:

`!html_bgsound`	Legt die Hintergrundmusik für eine HTML-Seite fest.
`!html_robots`	Dient zum Setzen der `robots`-Anweisungen für Suchmaschinen. `!html_robots` hat Vorrang vor `!docinfo` [robots].
`!docinfo` [robots]	Dient zum Setzen der `robots`-Anweisungen für Suchmaschinen. Wird nur geschrieben, wenn in einzelnen Dateien nicht `!html_robots` benutzt wird.
`!html_frames_toc_title`	Setzt den TOC-Frame-Titel beim Frame-Layout.
`!html_frames_con_title`	Setzt den CON-Frame-Titel beim Frame-Layout.
`!html_navigation` [line]	Dieses Kommando bietet eine neue Formatierung der Navigationsleiste. In den unterstützten HTML-Ausgabeformaten kann jetzt optional die Navigationsleiste einzeilig (mit und ohne Ordner-Symbol am Anfang) ausgegeben werden.
`!html_navigation` [image]	Dieses Zusatzkommando zum vorgenannten legt fest, welches Symbol als Ordner am Anfang der Navigationsleiste ausgegeben werden soll. Verwenden Sie hier z.B. bei Programm-Dokumentationen das Programm-Symbol.

Neue Schalter:

`!html_header_links`	#53: Neuer Schalter, der je nach Vorgabe <link>-Elemente im HTML-Header erzeugt.
`!html_header_date` <text>	#54: Bisher wurde zu Beginn jeder HTML-Datei ein Kommentar mit dem Datum der Datei-Erzeugung eingefügt, z.B. `<!- last modified on 29.01.2004 –>`. Nunmehr wird, wenn dieser Schalter gesetzt ist, im HTML-Header ein META-Tag für Datum/Uhrzeit der Datei-Erzeugung erzeugt.
`!html_quotes` [classic \| tags]	#82: Mit diesem neuen Schalter können Sie steuern, ob An-/Abführungszeichen wie früher als `"` ausgegeben werden sollen ([classic]) oder als HTML-Quotation-Tags + ([tags], voreingestellt).

Neu: Indexseite für HTML, die auch eine Sprungmarkenleiste (A–Z) für schnelleres Auffinden in langen Index-Listen mitbringt.
Neu: Die Navigationsleiste hat jetzt immer einen Link zur Index-Seite.
Der Link wird in einem Span namens UDO_nav_index ausgegeben und kann bequem per CSS z.B. rechtsbündig auf der Seite platziert werden.
Feature-Wunsch #70: Das Kommando (!img) wurde erweitert.
Die <link>-Elemente für die Navigation werden nicht mehr automatisch, sondern nur noch auf Anforderung in den HTML-Header geschrieben (siehe oben).
Datum/Uhrzeit der Erzeugung der HTML-Datei werden nicht mehr automatisch als Kommentar, sondern nur noch auf Anforderung als META-Tag in den HTML-Header geschrieben (siehe oben).
Bei !html_ignore_8bit kann nun ein optionaler Parameter <text> für die Codepage übergeben werden.
!html_counter_command kann jetzt auch im Vorspann benutzt werden, dann wird dies für alle Dateien erzeugt.
Die Kommandos (!B), (!I), (!U), (!T) und (!V) werden zu , , und umgesetzt, wenn der HTML Doctype >= XHTML_STRICT ist, ansonsten werden die alten Elemente benutzt.

Der Bereich der Titelseite wird jetzt durch folgendes Konstrukt geklammert:

Bei !use_raw_header und !use_raw_footer werden Makros und Defines ausgeführt.

Bessere HTML-Formatierung und -Compliance:

Attribute (nowrap, noresize) erweitert.

#11: (
,
, , , )

#11: XML-Namespace für XHTML-Dateien hinzugefügt.

Description-Umgebungen werden sauber formatiert, auch bei enthaltenen Links.

Listen und Tabellen werden sauberer und syntaxrichtig ausgegeben.

Ankernamen enthalten nur noch für URLs erlaubte Zeichen.

Beim Modern Layout wird die Tabelle in der linken Spalte, die das Menü zeigt, jetzt mit einer ID namens UDO_menu versehen, so dass das Menü beim Drucken mittels CSS ausgeblendet werden kann.

Die Einträge von !docinfo [keywords, description] werden jetzt auch bei der HTML-Ausgabe geschrieben, allerdings nur, wenn in einzelnen Dateien nicht !html_keywords bzw. !html_description benutzt wird. Diese haben also Vorrang.

Das Kommando !begin_quote kann jetzt ein Argument bekommen.

Beim Kommando !html_style_name können beliebig viele Stylesheets übergeben werden.

Bisher gab es ein UDOTOC"> vor dem Inhaltsverzeichnis, auf das Sie bei der HTML-Ausgabe innerhalb von Raw-Umgebungen verweisen können.
Jetzt wird UDOTOC als Label angelegt, wenn für HTML ein Inhaltsverzeichnis erzeugt werden soll. Dann können Sie auch innerhalb des UDO-Quelltextes auf UDOTOC verweisen, ohne dass ein Fehler auftritt.

Bugfix #12: Keine unnötigen Leerzeichen mehr hinter Tags.

Bugfix #44: Wenn !no_numbers gesetzt ist, werden keine Nummern mehr vor die Kapitelnamen innerhalb des <link>-Elementes im HTML-Header geschrieben.

Bugfix #58: Falsche UDO-Versionsbezeichnung in HTML-Metatags korrigiert.

Bugfix #65: Falsche Zeichenausgabe in IMG-Tags korrigiert.

Bugfix #83: Anker-URL enthalten nur noch erlaubte Zeichen für URL-Angaben.

Bugfix #84: Label in Description-Umgebungen werden korrekt in DT-Tags eingeschlossen.

Bugfix #85: TOC-Listen werden korrekt formatiert.

Rich Text Format (RTF)

Neu: Neues Kommando !rtf_add_colour, mit dem zusätzliche Farben (über die 16 Standardfarben hinaus) in den Kopf einer RTF-Datei geschrieben werden.

Neu: Die !docinfo-Einträge subject, keywords, company und category werden in die Info-Einträge der RTF-Datei geschrieben.

Neu: Alle Nodes, Subnodes usw. werden für die RTF-Ausgabe als Label/Bookmark markiert.

Neu: Das Kommando (!plink) unterstützt. Die Angabe erfolgt als Hinweis auf die Seitenzahl.

Neu: \*\revtbl {Unknown}{UDO Version x.x.x}} wird gesetzt.

Neu: !use_raw_header kann auch für die RTF-Ausgabe benutzt werden.

Bugfix #56: Falsche Berechnung der Ausmaße von Bildern bei der RTF-Ausgabe. Versehentlich wurde dem Parameter Höhe die Breite übergeben.

Bugfix #17: Fehlermeldung: couldn't read BMP header of . No such file or directory.
Neuer Zustand: Wenn beim ersten Übersetzungslauf nach RTF das UDO-Link-Bild udo_mw.bmp noch nicht vorhanden ist, wird jetzt ein Hinweis ausgegeben, das Dokument ein weiteres Mal zu übersetzen, um es zu vervollständigen.
Das UDO-Bild wird jetzt auch auf TOS-kompatiblen Computern gefunden.

Bugfix #60: Abstürze bei RTF-Ausgabe beseitigt.

HTML-Help

Neu: Wird der Kommandozeilenparameter –map gesetzt, werden eine Alias- und MAP-Datei erzeugt.

Neu: !html_name is now used in HTML-Help output.

ST-Guide

Bugfix: Horizontale Linien können länger als 126 Zeichen sein.

(!SUP)...(!sup)	Text hochgestellt ausgeben
(!SUB)...(!sub)	Text tiefgestellt ausgeben
(!INS)...(!ins)	Einfügungen erzeugen
(!DEL)...(!del)	Gelöschten Text visualisieren

`!language` [czech]	Tschechisch
`!language` [danish]	Dänisch
`!language` [polish]	Polnisch
`!language` [swedish]	Schwedisch

`!code_source`	legt das Quellformat-Encoding der UDO-Dokumente fest.
`!code_target`	legt das Ausgabe-Encoding fest.

--no-warningslines	Keine Warnungen ausgeben
-Wl	Kurzschreibweise des o.g. Kommandozeilen-Parameters.

[AppleTitle]	legt den (lokalisierbaren) Titel der Hilfe fest.
[AppleIcon]	legt das Icon fest, das der Apple Help Viewer in der Auflistung aller Programmhilfen für diese Hilfe zeigen soll.