TeXworks

TeXworks ist ein leichter, plattformübergreifender LaTeX-Editor, der im Lieferumfang von TeX Live und MiKTeX enthalten ist. Es wurde bewusst nach dem Vorbild von TeXShop, dem beliebten macOS-Editor, erstellt, um „die Eintrittsbarriere in die TeX-Welt zu senken“ – was es zu einem hervorragenden ersten Editor macht. Auf dieser Seite wird die Konfiguration der Satzwerkzeuge, des Stammdateikommentars, der Projekte mit mehreren Dateien miteinander verbindet, und von SyncTeX, das die Quelle mit der integrierten Vorschau von PDF verknüpft, erläutert.

Was ist TeXworks

TeXworks wurde von Jonathan Kew geschrieben – der auch XeTeX erstellt hat. Da er die damaligen Windows-orientierten integrierten Umgebungen als zu aufwändig und einschüchternd für Neulinge empfand, orientierte er sich bewusst an Richard Kochs TeXShop, dem angesehenen macOS-Editor, und brachte sein aufgeräumtes Gefühl auch auf Windows und Linux. Das Ziel war eindeutig: die Eintrittsbarriere in die TeX-Welt zu senken. Anstatt um Features zu konkurrieren, ist es darauf ausgelegt, die Anzahl der Stellen zu reduzieren, an denen sich ein Anfänger verirren kann.

Sein größter praktischer Vorteil besteht darin, dass nichts extra installiert werden muss: Es wird sowohl mit TeX Live als auch mit MiKTeX ausgeliefert, sodass Sie bei der Installation einer Distribution auch den Editor erhalten. Es basiert auf dem Qt-Toolkit GUI und verhält sich auf Windows, macOS und Linux gleich. Der Editor selbst ist Unicode-fähig (standardmäßig UTF-8) und bietet eine bescheidene, sorgfältig ausgewählte Reihe von Tools – Befehlsvervollständigung, Eingabehilfe und Rechtschreibprüfung. Wenn Sie über die Standardeinstellungen hinauswachsen, können Sie mit optionalen Lua- und Python-Scripting-Plugins (zur Erstellungszeit aktiviert) Ihre eigenen Befehle hinzufügen.

Die Kehrseite dieser Einfachheit ist, dass TeXworks nicht für aufwändige mehrstufige Builds oder umfangreiches Projektmanagement konzipiert ist – solche Arbeitsabläufe werden bewusst aus dem Vordergrund gehalten, da sie für Anfänger zu fortgeschritten sind. Wenn Ihr Setup wirklich komplex wird, sind Editoren wie TeXstudio oder VS Code (LaTeX Workshop) die natürlichen nächsten Schritte. Aber um Ihr allererstes Dokument zum Kompilieren zu bringen, ist TeXworks der kürzeste Weg, den es gibt.

Konfigurieren der Satzwerkzeuge

Das Herzstück von TeXworks ist das Satz-Dropdown-Menü links in der Symbolleiste. Sie wählen die Engine aus, die ausgeführt werden soll (pdfLaTeX, LuaLaTeX, XeLaTeX, ConTeXt usw.) und drücken auf das grüne Dreieck daneben (oder Ctrl/Cmd-T); TeXworks kompiliert das aktuelle Dokument und öffnet die PDF-Vorschau. Es wird mit einer Reihe von Tools geliefert, die bereits konfiguriert sind: pdfLaTeX, XeLaTeX, ConTeXt (MkII) sowie Hilfsprogramme wie BibTeX und MakeIndex.

Sie können dieser Dropdown-Liste Ihre eigenen Einträge hinzufügen. Öffnen Sie Bearbeiten → Einstellungen → die Registerkarte „Satz“; Die Liste Verarbeitungstools unten enthält die Tools, mit + zum Hinzufügen, - zum Entfernen und Edit... zum Ändern. Jedes Tool verfügt über einen Namen (die in der Dropdown-Liste angezeigte Bezeichnung), ein Programm (den auszuführenden Befehl), Argumente (eines pro Zeile) und ein Kontrollkästchen Zxqph6xz nach der Ausführung anzeigen. Argumente akzeptieren Variablen: $fullname erweitert sich auf die verarbeitete Datei und $synctexoption auf die Option SyncTeX (siehe unten).

Als Beispiel sehen Sie hier ein pdfLaTeX-Tool, das den Build an latexmk übergibt. Da latexmk selbst entscheidet, wie viele Durchgänge zum Auflösen von Querverweisen und Bibliografien erforderlich sind, bleibt die TeXworks-Seite einfacher. Stellen Sie „Programm“ auf „latexmk“ ein, geben Sie die Argumente wie folgt pro Zeile ein und aktivieren Sie Zxqph5xz nach der Ausführung anzeigen.

-e
$pdflatex=q/pdflatex $synctexoption %O %S/
-pdf
$fullname

Für Japanisch besteht der übliche Weg darin, mit upLaTeX zu setzen und das Ergebnis mit dvipdfmx in PDF umzuwandeln. Das mit TeX Live gebündelte TeXworks enthält bereits japanische Tools. Wenn Sie jedoch selbst eines hinzufügen, ist ptex2pdf der einfachste Ansatz, der beide Schritte umfasst. Stellen Sie das Programm wie folgt auf ptex2pdf und die Argumente ein (-u wählt upLaTeX, -l das LaTeX-Format und -ot übergibt zusätzliche Optionen an TeX).

-l
-u
-ot
-kanji=utf8 -no-guess-input-enc $synctexoption
$fullname

Legen Sie diejenige, die Sie am häufigsten verwenden, als Standardsatz-Engine oben in den Satzeinstellungen fest, und neu geöffnete Dokumente werden sie verwenden. Wenn Sie für eine bestimmte Datei eine andere Engine benötigen, wird diese durch den magischen Kommentar im nächsten Abschnitt überschrieben.

Die Stammdatei und magische Kommentare

Wenn ein Dokument wächst, besteht eine übliche Vorgehensweise darin, es in kapitelweise Dateien aufzuteilen, die von einem übergeordneten Dokument mit \input oder \include abgerufen werden. Der Haken besteht darin, was passiert, wenn Sie Text eingeben, während eine untergeordnete Datei (z. B. chapter1.tex) geöffnet ist: Das untergeordnete Element hat kein \documentclass und kein \begin{document}, sodass es nicht selbst kompilieren kann.

Der Fix ist ein magischer Kommentar. Für TeX sehen diese wie gewöhnliche Kommentare aus (alles nach %), aber TeXworks liest bestimmte Zeilen am Anfang einer Datei und ändert ihr Verhalten entsprechend. Platzieren Sie % !TeX root = ... oben in einer untergeordneten Datei und zeigen Sie dabei auf die übergeordnete Datei. Wenn Sie beim Bearbeiten der untergeordneten Datei den Text setzen, kompiliert TeXworks stattdessen die übergeordnete Datei (Stammdatei). Der Pfad wird relativ zur untergeordneten Datei geschrieben.

% !TeX root = main.tex

\chapter{はじめに}
本文をここに書きます。

Es gibt noch andere magische Kommentare. % !TeX program = ... wählt die Engine für dieses Dokument aus – der Wert ist der Name des Tools, das Sie in den Einstellungen konfiguriert haben, nicht der Dateiname der ausführbaren Datei. Platzieren Sie es oben in einem japanischen Dokument und die richtige Engine wird verwendet, auch wenn Sie vergessen, das Dropdown-Menü zu wechseln. % !TeX encoding = ... deklariert die Zeichenkodierung der Datei; Da TeXworks standardmäßig UTF-8 ist, benötigen Sie es normalerweise nicht, wenn Sie in UTF-8 schreiben. (% !TeX program akzeptiert auch die ältere Schreibweise % !TeX TS-program.)

% !TeX program = upLaTeX (ptex2pdf)
% !TeX encoding = UTF-8
\documentclass{ujarticle}
\begin{document}
\input{chapter1}
\end{document}

Von einer Seite zu einem geteilten Projekt

TeXworks ist absichtlich klein, daher ist es am besten, mit einer .tex-Datei zu beginnen. Sobald dies ein PDF erzeugt, teilen Sie die Kapitel in untergeordnete Dateien auf und fügen Sie dort Root-Anweisungen hinzu. Das Projekt kann wachsen, ohne dass die Einrichtung kompliziert wird.

• Beginnen Sie nur mit main.tex: Titel, Abschnittsüberschrift und einem kurzen Text.
• Wählen Sie einen Eintrag im Dropdown-Menü „Satz“ aus und bestätigen Sie, dass jedes Mal ein PDF erzeugt wird.
• Platzieren Sie % !TeX root = main.tex nach der Aufteilung der Kapitel oben in den untergeordneten Dateien.
• Halten Sie bei japanischen Dokumenten die Zeile % !TeX program = ... und die Richtlinie UTF-8 im gesamten Projekt konsistent.

Benutzen Sie das Holzscheit und die Hilfsmittel bewusst

Da TeXworks optisch leicht bleibt, ist es ein guter Editor zum Erlernen des Lesens des Protokolls. Die Meldungen nach dem Satz sagen Ihnen mehr als nur, ob ein PDF erstellt wurde: Dort tauchen ungelöste Referenzen, fehlende Pakete und fehlgeschlagene Bildeinbindung auf. Behandeln Sie Hilfsdateien als nützlichen Zustand und nicht als Unordnung, die ständig gelöscht werden muss. Bereinigen Sie sie nur, wenn der Build-Status veraltet aussieht.

• Wenn Referenzen ?? bestehen bleiben, setzen Sie sie mehr als einmal mit demselben Werkzeug, damit .aux aktualisiert wird.
• Löschen Sie .aux oder .toc nur nach größeren Änderungen am Inhaltsverzeichnis oder der Bibliographie und erstellen Sie es dann von Grund auf neu.
• Wenn keine Bilder angezeigt werden, vergleichen Sie den Dateinamen im Protokoll mit dem tatsächlichen Pfad. Vermeiden Sie Leerzeichen und japanische Zeichen in Dateinamen.
• Wenn die Konfiguration zu aufwändig wird, verschieben Sie die Build-Logik nach .latexmkrc oder ziehen Sie einen umfangreicheren Editor in Betracht, anstatt alles nach TeXworks zu zwingen.

SyncTeX (Vorwärts- und Rückwärtssuche)

TeXworks verfügt über eine integrierte PDF-Vorschau basierend auf Qt und der Poppler-Bibliothek, sodass Sie nicht zu einem externen Viewer wie Acrobat wechseln müssen – Sie wechseln zwischen Bearbeitung und Überprüfung im selben Fenster. SyncTeX verknüpft dann Positionen in der Quelle und der Vorschau in beide Richtungen; Es handelt sich um den von Jérôme Laurens und anderen entwickelten Synchronisationsmechanismus.

Die Bedienung ist intuitiv. Um von einer Stelle in der Quelle zur passenden Stelle in PDF (Vorwärtssuche) zu springen, Ctrl/Cmd-click in der Quelle. Um umgekehrt zu gehen, von PDF zurück zur entsprechenden Zeile in der Quelle (inverse Suche), Ctrl/Cmd-click in der Vorschau. Die Möglichkeit, sofort zwischen „Wo ist dieser Absatz im PDF“ und „Welche Quellzeile ist das?“ zu wechseln, macht die Überarbeitung wesentlich reibungsloser.

Glücklicherweise funktioniert das auf Anhieb. SyncTeX erstellt seine Zuordnung, indem es zur Kompilierungszeit eine .synctex.gz-Nachschlagetabelle ausgibt, und die standardmäßigen TeXworks-Tools aktivieren es automatisch, indem sie das Äquivalent von --synctex=1 (das $synctexoption aus dem vorherigen Abschnitt) übergeben. Fügen Sie in Ihren eigenen Tools $synctexoption in die Argumente ein, und die Synchronisierung funktioniert auf die gleiche Weise.