6 Troubleshooting

In diesem Kapitel sollen die häufigsten Fehlerursachen und deren Behebung aufgelistet werden.

mnmlit2html.pl erzeugt keinen Listeneintrag

In den meisten Fällen liegt ein Fehler in der BibTeX-Datei vor. Entweder fehlt der Key oder er ist verkehrt, es fehlt das @ vor der entsprechenden Gattung oder es gibt keinen entsprechenden Eintrag für die Gattung in der Initialisierungsdatei .mnmit2html.ini.

An error occured, no Documents added to WWW!

Mit großer Wahrscheinlichkeit gibt es einen Fehler in der BibTeX-Datei. Näheres siehe voriger Punkt.

Input directory empty?

Das Programm stoppt, wenn $INPUT_DIR leer ist. Sollte dieses Verzeichnis nicht leer sein, so kann ein Blick auf die Rechte der einzelnen Dateien im Verzeichnis nicht schaden. Zumindest die Leserechte der einzelnen Dateien müssen für die entsprechende Gruppe bzw. für alle anderen gesetzt sein!

/tmp/publikationen.bib.tex not writeable?

Vermutlich wurde ein vorheriger Durchlauf von mnmlit2html.pl mit einem Fehler abgebrochen oder nicht vollständig durchgeführt. Als Folge davon werden einige temporäre Dateien nicht gelöscht. Abhilfe schafft hier, ein anderes temporäres Verzeichnis zu wählen oder den Dateibesitzer zu bitten, seine Dateien zu löschen.

Bilder werden nicht korrekt übersetzt

LaTeX2HTML erstellt eine Datei images.log, die durch einen L^ATEX-Lauf von images.tex entstanden ist. Finden sich in images.log ungewöhnliche Fehlermeldungen wie nicht gefundene Styles, so kann es sein, daß LaTeX2HTML die Bilder nicht von Encapsulated Postscript nach GIF übersetzen konnte. Fehlerursache ist häufig ein nicht korrekter $TEXINPUTS-Pfad. Abhilfe schafft u.U. ein Zurücksetzen von $TEXINPUTS mittels TEXINPUTS=::. Siehe hierzu auch die Beschreibung zu LaTeX2HTML . Sollten trotz dieser Maßnahmen die Bilder nicht korrekt oder gar nicht dargestellt werden, so ist zu prüfen, ob das Dokument mit einer L^ATEX-Version 2.09 oder kleiner übersetzt wurde. Speziell LaTeX2HTML-97.1 verhält sich da nicht besonders tolerant. Abhilfe schafft ein Löschen der Dateien mit den Endungen .aux und .toc und anschließendes Neuübersetzen mit L^ATEX2e im Kompatibilitätsmodus.

Bilder erscheinen zu klein oder zu groß.

$FIGURE_SCALE_FACTOR entsprechend setzen, um die Größe der Bilder zu skalieren. Siehe hierzu Kapitel5 auf Seite.

Es erscheint keine Zusammenfassung

obwohl ein Eintrag in @ZUSAMMENFASSUNG vorhanden ist und es ein Kapitel mit der Überschrift des Eintrages in @ZUSAMMENFASSUNG gibt. Zunächst ist zu überprüfen, ob Umlaute im L^ATEX-Format, also mit doppelten Anführungszeichen gefolgt von einem Vokal, eingegeben wurden. Dabei sind die Anführungszeichen zu quoten, sprich: mit einem vorgestellten Backslash zu versehen und der Begriff selber in Anführungszeichen zu setzten.

Es erscheint eine ,,falsche`` Zusammenfassung

Möglicherweise ist die Variable $CHILDLINE falsch gesetzt, so daß das Programm mnmlit2html.pl nicht das Ende der Zusammenfassung findet. Für die Versionen 96.1 und 97.1 von LaTeX2HTML sollte die im Sourcecode gesetzte Default-Einstellung richtig sein. Den Anfang der Zusammenfassung findet mnmlit2html.pl anhand dem Eintrag in @ZUSAMMENFASSUNG und der darauffolgenden Zeile. Beginnt diese mit einem Abschnittsbeginn (<P>) oder einem Überschriftsende (<\H1>), so gehören alle folgenden Zeilen bis zu $CHILDLINE zur Zusammenfassung und werden in einer Variablen abgelegt. Sollte sich daran in zukünftigen Versionen von LaTeX2HTML etwas ändern, so muß der Sourcecode entsprechend gepatcht oder die Variable $CHILDLINE anders gesetzt werden.

Die Numerierung der einzelnen Abschnitte fehlt teilweise

Normalerweise reicht es unter L^ATEX, Sonderzeichen wie die deutschen Umlaute durch doppelte Hochkommata und dem anschließenden Vokal zu schreiben, wenn der Style german.sty eingebunden ist. LaTeX2HTML hingegen verlangt die ausführliche Schreibweise in Überschriften. Also:

 

ä ö ü ß \"a \"o \"u \ss{}

Ä Ö Ü \"A \"O \"U

statt

ä ö ü ß "a "o "u "s

Ä Ö Ü "A "O "U

Sollten trotz dieser Maßnahmen die Abschnitte nicht nummeriert werden, so ist zu prüfen, ob das Dokument mit einer L^ATEX-Version 2.09 oder kleiner übersetzt wurde. Speziell LaTeX2HTML-97.1 verhält sich da nicht besonders tolerant. Abhilfe schafft ein Löschen der Dateien mit den Endungen .aux und .toc und anschließendes Neuübersetzen mit L^ATEX2e im Kompatibilitätsmodus.

LaTeX2HTML dreht Schleifen

Dieses unangenehmen ,,Loopen`` des Programms kann von nicht korrekt verwendeten L^ATEX-Befehlen herrühren. Im Kapitel Troubleshooting der Dokumentation zu LaTeX2HTML finden sich nähere Hinweise hierzu.

Was LaTeX2HTML bspw. gar nicht bekommt, sind im \author-Feld eingebundene Grafiken! Dann (und nur dann, soweit das bei den Tests von LaTeX2HTML auftrat) gibt es Loops von LaTeX2HTML.

In den folgenden Passagen muß die input-Zeile unbedingt auskommentiert werden:

\author{
%\centerline{\input{logo.tex}} \\  <--- ohne % => Loops!
%^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
\centerline{{\small Munich Network Management Team}} 
\and Alexander Keller \\
  Faculty of Computer Science, Munich University of Technology \\
  Oettingenstr.\ 67, 80538 Munich, Germany \\
  E-Mail: keller@informatik.uni-muenchen.de} 
\date{}
\maketitle

Das MNM-Team verwendet gelegentlich solche Konstruktionen, um z.B. das MNM-Logo in die oberste Zeile zu setzen. LaTeX2HTML neigt dabei jedoch zum Loopen.

Zur Vermeidung solcher Loops wäre auch die Einbettung der entsprechenden Zeile in folgende Umgebung denkbar:

   [...]
[...]

main.tex is newer than main.bbl: Please rerun latex and bibtex

Diese Meldung kann getrost übersehen werden. LaTeX2HTML meckert an dieser Stelle, wenn die .tex-Datei neuer ist als die dazugehörige .bbl-Datei.