der Benutzer durch verschiedene Parameter steuern, wie sein Dokument verarbeitet wird. Dies betrifft die Aufspaltungstiefe und das Ein- und Abschalten der Generierung verschiedener Elemente. Letzterer Punkt ist dadurch notwendig, dass der Zugang zum World Wide Web nicht nur durch graphikf?ahige Terminals sondern auch von ASCII- Terminals aus m?oglich ist. Hier w?are die Darstellung einer Tabelle, Formel oder Graphik durch eine Bilddatei nicht sinnvoll.

2 Benutzung von pub2html

Die Umwandlung der Dokumente erfolgt durch das Perl-Script pub2html. F?ur die Ausf?uhrung des Scripts wird die Version 5.001 von Perl ben?otigt. Zudem werden einige Tools von netpbm und ImageMagick sowie der PostScript-Interpreter GhostScript genutzt.

Als Eingabe wird entweder eine von Publisher generierte SGML-Datei oder das gesamte Publisher-Dokument ben?otigt. Nur bei der Angabe eines Publisher-Dokuments wird dieses auf die Einbindung von Unterdokumenten untersucht. Ist das der Fall, so wird der SGML-Code der Unterdokumente bei der Konvertierung erzeugt und eingebunden.

F?ur die Konvertierung m?ussen keine weiteren Konfigurationsdateien vorhanden sein.

Wenn die Optionen -destdir und -destname (siehe Abschnitt 2.2.1) nicht verwendet werden, generiert der Filter ein Verzeichnis fname?html, das die HTML-Dateien und Graphik-Dateien des Publisher-Dokuments enth?alt. Der Verzeichnisname besteht dann aus dem Dokumentnamen, dem das K?urzel ?html angeh?angt wird.

In diesem Verzeichnis sind die einzelnen Dateien des Dokuments hierarchisch in Unterverzeichnisse aufgeteilt. F?ur jedes Kapitel wird ein separates Unterverzeichnis erstellt, das alle dazu geh?orenden Dateien enth?alt (siehe Abb. 1).

testdoc?html
+-- testdoc.html
+-- chapter?1.html
+-- chapter?1
? +- section?1.html
? +- section?1
? +- +-- topic?1.html
? ? +-- topic?1
? ? ? +-- subtop?1.html
? ? ? +-- subtop?2.html
? ? ? +-- subtop?3.html
? ? ? +-- subtop?4.html
? ? +-- topic?2.html
? ? +-- topic?2
? ? +-- subtop?1.html
? ? +-- subtop?2.html
? +-- section?2.html
? +-- section?3.html
? +-- section?3
? +-- topic?1.html
? +-- topic?2.html
? +-- topic?3.html
? +-- topic?4.html
? +-- topic?5.html
+-- chapter?2.html

Abbildung 1: Baumstruktur eines Beispiel-Dokuments

Alle Verweise innerhalb der einzelnen Dateien sind relativ gehalten. Dadurch ist es m?oglich, das Hauptverzeichnis an jede beliebige Stelle zu verschieben.