Wie erhalte ich Hilfe von LaTeX

Question

Bei meinen ersten Versuchen mit LaTeX (ich verwende TeXnicCenter) steht bei Fehlern immer unten

Type  H <return>  for immediate help.

Ich drücke H und anschließend enter, aber nichts passiert. Wie bekomme ich denn Hilfe von LaTeX?

Accepted Answer

LaTeX bietet Klassen- und Paketautoren die Möglichkeit, auf Fehlermeldungen mit \ClassError bzw. \PackageError auf Anwenderfehler zu reagieren. Dabei kann der Klassen- bzw. Paketautor auch einen zusätzlichen Hilfetext angeben. Dieser wird von LaTeX im interaktiven Modus angezeigt, wenn man bei dieser Meldung auf h drückt. Allerdings verlangt dies, wie erwähnt, den interaktiven Modus. In diesem Modus erlaubt TeX Eingaben während des LaTeX-Laufs.

Viele Editoren starten latex bzw. pdflatex jedoch in einem Modus, indem Fehler nicht zu einer Unterbrechung führen, keine Eingaben möglich sind und deshalb diese zusätzlichen Hilfen auch nicht angezeigt werden. Trotzdem wird der Hinweis, dass man mit H Hilfe bekommen kann, ausgegeben. Aber das macht nichts, in diesen Modi wird die zusätzliche Hilfe nämlich zwar nicht in der Programmausgabe von latex oder pdflatex auf dem Terminal angezeigt, sie erscheint aber trotzdem in der Log-Datei. Bei dem folgenden Beispiel:

\documentclass{scrartcl}
\KOMAoptions{version=first}
\begin{document}
Test
\end{document}

erscheint dann zwar in der Teminal-Ausgabe nur:

! Class scrartcl Error: Option `version' too late.

See the scrartcl class documentation for explanation.
Type  H <return>  for immediate help.
 ...

l.2 \KOMAoptions{version=first}

! Package typearea Error: Option `version' too late.

See the typearea package documentation for explanation.
Type  H <return>  for immediate help.
 ...

l.2 \KOMAoptions{version=first}

in der Log-Datei steht aber zusätzlich die Erklärung:

Option `version' may be set only while loading the class.
But you've tried to set it up later.

Einige Editoren (beispielsweise emacs mit auctex) zeigen auch diesen Hilfetext aus der Log-Datei mit an.

Answer 2

1

du solltest TeXnicCenter so konfigurieren, dass er im batchmodus durchläuft, also nicht bei einer Fehlermeldung anhält. Du kannst über den Button in "Ausgabe->Ausgabeprofile definieren" einstellen, der ansonsten das Stoppen bei einem Fehler veranlasst. Dann gehst du bei einem Fehler auf das erste Ausrufezeichen oben rechts und erhältst dann im unteren Fenster die etwas bessere Fehlermeldung.

Permanenter link

beantwortet 21 Jun '13, 13:18

Herbert
5.1k●3●4
Akzeptiert-Rate: 31%

bearbeitet 21 Jun '13, 13:18

Answer 3

TeX bzw. LaTeX sind Programme, welche auf der Kommandozeile/Konsole/Terminal ausgeführt werden. Übliche Editoren rufen meist

pdflatex -interaction=nonstopmode <NameDerTexDatei>

durch Tastendruck oder Mausklick des Nutzers auf. Eine Interaktin, wie im Folgenden erklärt, ist damit nicht möglich.

Der Editor TeXworks bietet die Möglichkeit pdflatex genau so interaktiv zu nutzen wie im Terminal. Interaktion bedeutet dabei mit dem Programm pdflatex (oder latex) zu kommunizieren. Dies kann auf verschiedene Weise erfolgen.

\documentclass{article}
\begin{document}
\sektion{Abschnitt}
Text des Abschnittes
\end{document}

In obigem Beispiel ist der section-Befehl falsch geschrieben. LaTeX stellt fest, dass es diesen Befehl nicht kennt:

! Undefined control sequence.
l.3    \sektion
            {Abschnitt}
?

Zusätzlich wird gezeigt, in welcher Zeile (l.3) und bei welchem Befehl Unklarheiten (\sektion) auftauchten. Mit dem Fragezeichen fragt LaTeX nun, was im Anschluss zu tun ist. Ist man sich nicht sicher, kann man LaTeX fragen, welche Möglichkeiten bestehen (?), oder mit h Hilfe beziehen. Mit <enter> kann der Lauf fortgeführt werden, der aktuelle Fehler wird dabei so gut wie möglich ignoriert, kann aber weitere Fehler hervorrufen.

S und Q quittieren einfach gesagt jeden nun kommenden Fehler mit <enter>, alle Fehlermeldungen werden aber in der Log-Datei gesichert. Diese wird bei jedem Aufruf von pdflatex neu erstellt. X beendet den aktuellen Lauf und man kann die Fehler bequem in der Datei beheben.

Um ein Gefühl für die verschiedenen Fehler zu erhalten, welche von LaTeX/TeX/den Klassen und Paketen ausgegeben werden, kannst du dir ein Minimalbeispiel basteln und schauen, wie TeX auf eingebaute Fehler reagiert.

Fehler sind ganz normal und können schnell behoben werden, wenn man ruhig bleibt und tief durchatmet. Baut man bewusst kleine Fehler in ein Beispieldokument, lernt man, welche Fehlermeldungen LaTeX bringt. Somit erhält man schnell ein Gespür für die verschiedensten Fehlerquellen.

Wie erhalte ich Hilfe von LaTeX

Folgen dieser Frage

verwandte Fragen