Sarmate.net Sarmate.net
Startseite Funktionen Preise Dokumentation Kontakt
Anmelden Registrieren

Den richtigen Compiler wählen

Das ist der Fehler, der die meisten Anfänger blockiert: der falsche Compiler. LaTeX bietet drei davon an — pdfLaTeX, XeLaTeX, LuaLaTeX —, und ein einziges Auswahlmenü genügt, um von einem zum anderen zu wechseln. Sehen wir uns an, wann welcher zu verwenden ist.

Welchen soll man wählen?

  • pdfLaTeX — die Standardwahl, schnell, für die Mehrzahl der Dokumente geeignet. Beginnen Sie immer mit ihm.
  • XeLaTeX / LuaLaTeX — notwendig, sobald das Dokument fontspec verwendet (also Systemschriften, .otf-/.ttf-Dateien) oder fortgeschrittenes Unicode (Arabisch, Kyrillisch …).
Kompilieren Die meisten Dokumente funktionieren mit pdfLaTeX. Kompilieren Sie dieses unverändert (der Compiler ist bereits auf pdfLaTeX eingestellt).

Der klassische Fall: fontspec erfordert XeLaTeX

Wenn ein Dokument \usepackage{fontspec} lädt und Sie es mit pdfLaTeX kompilieren, bricht es sofort ab mit : „Fatal Package fontspec Error: The fontspec package requires either XeTeX or LuaTeX“. Die Lösung erfordert keinerlei Änderung am Code: Es genügt, den Compiler zu wechseln.

Korrigieren Dieses Dokument lädt fontspec und schlägt mit pdfLaTeX fehl (sehen Sie sich das Protokoll an). Wählen Sie im Auswahlmenü des Compilers (oben im Editor) XeLaTeX aus und kompilieren Sie erneut: Es funktioniert, ohne den Code anzurühren.
Lösung anzeigen
% !TEX program = xelatex
\documentclass{article}
\usepackage{fontspec}
\begin{document}
Dieses Dokument lädt fontspec: Es erfordert XeLaTeX oder LuaLaTeX.
\end{document}
Dauerhafter Tipp: Fügen Sie als allererste Zeile % !TEX program = xelatex hinzu. Der Editor wählt beim Öffnen der Datei automatisch den richtigen Compiler aus — Sie müssen nicht mehr daran denken.

Die Belohnung von XeLaTeX: die Systemschriften

Sobald Sie XeLaTeX (oder LuaLaTeX) verwenden, können Sie mit jeder installierten Schrift setzen, über \setmainfont{...}.

Kompilieren Dieses Beispiel ist bereits auf XeLaTeX eingestellt. Kompilieren Sie es: Der Text ist mit der Systemschrift Lato gesetzt — mit pdfLaTeX auf diese Weise unmöglich.
Zum Merken: fontspec oder eine Systemschrift → XeLaTeX oder LuaLaTeX. Andernfalls ist pdfLaTeX geeignet. Das Compiler-Menü ist stets nur einen Klick entfernt — und % !TEX program = ... macht die Wahl dauerhaft.

Dieser Fehler tritt so häufig auf, dass wir ihm eine eigene Seite gewidmet haben: alte Pakete & Compiler →