Häufige Fehler und wie Sie sie beheben
Die meisten Probleme halten das Dokument nicht an: Unbekannte Befehle werden übersprungen und im Tab Probleme aufgeführt, eine Formel, die sich nicht lesen lässt, wird rot angezeigt und dort genannt, und fehlende Bilder oder Zitate werden an Ort und Stelle markiert; nur ein EPS-Bild hält das ganze Dokument an.
Wie Probleme gemeldet werden
Eine TeX-Installation hält beim ersten Fehler an und fragt Sie, was zu tun ist. Scissor LaTeX macht weiter: Es setzt so viel vom Dokument, wie es kann, und listet im Tab Probleme unter der Vorschau auf, was es nicht verarbeiten konnte. Jeder Eintrag nennt, soweit bekannt, die betroffene Zeile, und ein Klick springt dorthin.
Es gibt vier Arten von Ergebnissen:
| Was Sie sehen | Was es bedeutet | Wo Sie nachsehen |
|---|---|---|
| Eine Meldung im Tab Probleme, das Dokument ist in Ordnung | Etwas wurde übersprungen oder ausgelassen. | Die Abschnitte unten. |
| Eine Formel als roter Quelltext | Diese Formel ließ sich nicht lesen. | Rote Formeln |
Ein rotes [key?] oder ein grauer gestrichelter Kasten | Ein Zitat oder ein Bild fehlt. | Fehlende Zitate und Bilder |
| Gar keine Seiten, ein Fehler ganz oben | Das ganze Dokument ist gescheitert. | Wenn sich das ganze Dokument nicht setzen lässt |
„Skipped N unknown commands“
Diese Meldung sehen Sie am häufigsten; sie entspricht „Undefined control sequence“ in LaTeX. Ein Befehl, den Scissor LaTeX nicht kennt, wird übersprungen: Sein Name verschwindet, und der Text in seinen geschweiften Klammern bleibt.
Ein unbekannter Befehl: Der Name verschwindet, der Text bleibt
The value is \highlightvalue{44} and the unit is \unitname{kg}.Tab „Probleme“: Skipped 2 unknown commands: \highlightvalue, \unitname
Was Sie tun können:
- Prüfen Sie die Schreibweise.
\textbffunktioniert,\textboldnicht. - Wenn der Befehl aus einem Paket stammt, schlagen Sie das Paket auf den Paketseiten nach. Für manche Befehle gibt es einen einfachen Ersatz.
- Wenn es Ihr eigener Befehl ist, prüfen Sie, ob er mit
\newcommanddefiniert ist, bevor er verwendet wird (siehe Eigene Befehle).
Eine unbekannte Umgebung verhält sich anders: Sie wird ohne Meldung entfernt, und ihr Inhalt bleibt. Wenn Text unformatiert aussieht, prüfen Sie den Namen der Umgebung.
„Package ... is not available here“
\usepackage schlägt nie fehl. Ein Paket, das Scissor LaTeX nicht kennt, wird im Tab Probleme vermerkt, und seine Formatierung wird nicht angewendet. Der Rest des Dokuments wird wie gewohnt gesetzt, und unbekannte Befehle aus dem Paket werden als unbekannt gemeldet.
Ein Paket, das nicht verfügbar ist
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Tab „Probleme“: Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
Rote Formeln
Wenn eine Formel etwas enthält, das der Mathematik-Konverter nicht lesen kann, wird diese Formel als roter Quelltext angezeigt. Der Rest des Dokuments ist nicht betroffen. Der Tab Probleme nennt die Formel, ihre Zeile und den Grund, etwa „This formula could not be read: \symbf{v} (unknown command: \symbf)“; nach zehn Formeln gibt eine weitere Zeile die Anzahl der übrigen an.
\symbf gibt es nicht, also ist die Formel rot
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Rot dargestellt: Die Formel kann nicht gelesen werden, deshalb steht dort ihr Quelltext.
Häufige Ursachen und Lösungen:
| Ursache | Lösung |
|---|---|
\abs{x}, \norm{x}, \dv{f}{x} (physics) | \left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx} |
\SI{44}{\kilo\gram} (siunitx) | 44\,\mathrm{kg} |
\sideset | Schreiben Sie die Formel ohne ihn. |
Ein $ ohne Gegenstück | Schließen Sie die Formel. Ein nicht geschlossenes $ ist nicht rot: Es verwandelt den Rest seines Absatzes bis zur nächsten Leerzeile in zusammenlaufende kursive Mathematik. |
Fehlende Zitate und Bilder
Ein Zitierschlüssel, der in keiner .bib-Datei steht, erscheint als rotes [key?], und der Tab Probleme listet die fehlenden Schlüssel auf. Ein fehlendes Bild wird zu einem grauen gestrichelten Kasten mit dem Dateinamen.
Ein Bild, das nicht im Projekt ist
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Tab „Probleme“: Images not in the project: figures/plot.png
Laden Sie die Datei mit demselben Pfad in das Projekt hoch oder korrigieren Sie den Pfad. Ohne Endung werden Dateien mit .png, .jpg, .jpeg und .svg gefunden; PDF- und EPS-Abbildungen zeigen ebenfalls den Kasten (siehe Abbildungen und Bilder). Zu Zitaten siehe Literaturverzeichnisse und Zitate.
Weitere Meldungen
| Meldung | Bedeutung | Was Sie tun können |
|---|---|---|
| „N included files are not part of this conversion“ | \subfile, \import, \lstinputlisting, \inputminted oder \includepdf wurde übersprungen. | Verwenden Sie \input oder fügen Sie den Inhalt direkt ein. |
| „File not found: ...“ | Ein \input oder \include nennt eine Datei, die nicht im Projekt ist. | Prüfen Sie den Pfad ab dem obersten Ordner des Projekts. |
| „N pictures of an unsupported kind are not included“ | Eine Umgebung tikzcd, circuitikz, forest oder picture wurde ausgelassen. | Siehe Zeichnungen mit TikZ. |
| „TikZ option '...' is not supported yet“ | Ein Bild verwendet eine Option, die die Zeichen-Engine nicht kennt. Das Bild wird ohne sie gezeichnet. | Prüfen Sie die Option oder lassen Sie sie weg. |
| „Layout in the style of ... Not official.“ | Eine Konferenzklasse oder ein Konferenzpaket hat auf ein nachgebildetes Layout umgeschaltet. | Nichts; das ist nur eine Information. |
| „Macro expansion stopped at the safety limit“ | Ein Befehl expandiert in sich selbst oder in eine riesige Menge Text. | Suchen Sie nach einem \newcommand, das seinen eigenen Namen verwendet. |
| „This formula could not be read: ...“ | Die Formel wird rot angezeigt; der Grund steht in Klammern. | Siehe Rote Formeln. |
| „References to labels that do not exist (shown as ??): ...“ | Ein \ref, \eqref, \pageref oder \cref nennt ein Label, das nicht definiert ist oder auf einer roten Formel steht. | Prüfen Sie die Schreibweise des Labels. |
| „Bibliography style ... is not available; using numbered references [1] instead“ | \bibliographystyle nennt einen Stil, der nicht auf der Liste steht, etwa alpha. | Wählen Sie einen Stil aus der Liste oder behalten Sie die nummerierten Verweise. |
| „Skipped .bib entries: ...“ | Diese Einträge der .bib-Datei ließen sich nicht lesen (eine fehlende Klammer, ein doppelter Schlüssel); die übrigen werden verwendet. | Korrigieren Sie den Eintrag in der angegebenen Zeile. |
LaTeX-Fehler, die Sie hier nicht sehen
Manche klassischen LaTeX-Fehler halten in Scissor LaTeX nichts an, weshalb man sie leicht übersieht:
| LaTeX-Fehler | Was Scissor LaTeX tut |
|---|---|
„Missing $ inserted“ für x_1 im Text | Gibt x_1 wörtlich aus. Setzen Sie Mathematik in $...$. |
| „Misplaced alignment tab character &“ | Gibt & wörtlich aus. Schreiben Sie \& für ein kaufmännisches Und. |
| „Extra }, or forgotten $“ | Ignoriert unausgeglichene geschweifte Klammern. |
| „\begin{itemize} ended by \end{document}“ | Schließt die Umgebung für Sie. |
| „Reference ... undefined“ | Gibt ein fettes ?? aus; der Tab Probleme listet die fehlenden Labels auf. |
Text, den LaTeX ablehnen würde
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Solche Dokumente können in einer TeX-Installation trotzdem scheitern; beheben Sie die Fehler also, auch wenn die Vorschau gut aussieht.
Unterschiede zu einer TeX-Installation
Eine Checkliste nach Symptomen finden Sie unter Fehlerbehebung.
Fragen und Antworten
Was bedeutet „Undefined control sequence“?
LaTeX kennt einen Befehl nicht, meist wegen eines Tippfehlers oder eines fehlenden Pakets. In Scissor LaTeX zeigt sich dieselbe Situation als „Skipped N unknown commands“ im Tab Probleme, und das Dokument wird trotzdem gesetzt.
Warum ist meine Formel rot?
Die Formel enthält einen Befehl, den der Mathematik-Konverter nicht kennt, etwa \symbf oder \abs. Der Tab Probleme nennt ihn. Ersetzen Sie diesen Befehl; die Tabelle auf dieser Seite listet gängige Alternativen auf.
Warum sehe ich [key?] in meinem Dokument?
Der Zitierschlüssel steht in keiner .bib-Datei des Projekts. Prüfen Sie die Schreibweise und ob die .bib-Datei hochgeladen ist.
Jedes Beispiel auf dieser Seite wird beim Erstellen der Website von Scissor LaTeX gesetzt. Zuletzt aktualisiert am 2026-11-07.