Emacs (AUCTeX / YaTeX)

Es gibt zwei Hauptmethoden, um LaTeX in Emacs zu schreiben: AUCTeX, die umfassende TeX/LaTeX-Umgebung, und YaTeX (野鳥), das stark auf Japanisch basiert. Beide sind tastaturgesteuert und ermöglichen das Kompilieren, Vervollständigen, Querverweisen und die Vorschau direkt im Editor. Die Lernkurve ist steil, aber sobald es in Ihre Hände passt, geht es sehr schnell. Diese Seite führt Sie durch das Setup von AUCTeX, seinen Begleiter RefTeX und preview-latex zum Inline-Rendering von Mathematik im Puffer und wendet sich dann YaTeX für Japanisch zu.

Was AUCTeX ist

Emacs setzt TeX nicht selbst. Die eigentliche Kompilierung erfolgt durch eine Distribution, die Sie auf Ihrem Computer installieren – TeX Live (oder MacTeX / MiKTeX). AUCTeX ist das Paket, das den Editor und diese Distribution verbindet: Es erzeugt latex oder latexmk als untergeordneten Prozess, fängt Fehler ab und springt zur fehlerhaften Zeile und fügt die Vervollständigung von Umgebungen und Makros, Syntaxhervorhebung, Dokumentfaltung und Hilfe bei der mathematischen Eingabe hinzu. Die einzige Voraussetzung ist, dass latexmk --version in einem Terminal funktioniert – das heißt, die TeX-Befehle befinden sich auf Ihrem PATH.

Historisch gesehen hat AUCTeX zwei Hauptmodi: LaTeX-mode für LaTeX-Dokumente und TeX-mode für rohe TeX / plain TeX. Öffnen Sie eine .tex-Datei und AUCTeX überprüft sie, um die richtige einzugeben. Die aktuelle Verteilung konzentriert sich auf GNU ELPA, das integrierte Paketarchiv von Emacs; GNU ELPA hat im Januar 2026 14.1.2 gelistet. Die heutige Installation ist also ein Einzeiler mit package.el, wie unten gezeigt.

Wenn die Tastennotation Emacs unbekannt ist: C-c bedeutet Steuerung mit c gedrückt halten, C-c C-c bedeutet drücken Sie c und dann erneut c, während Sie die Steuerung gedrückt halten, und M-x bedeutet Meta (Alt oder ESC) + x. Fast jeder AUCTeX-Befehl basiert auf einem Schlüssel, der mit C-c beginnt.

AUCTeX-Setup

Die Installation besteht aus zwei Schritten. Installieren Sie zunächst eine Distribution wie TeX Live (im Jahr 2026 TeX Live 2026) und legen Sie sie auf Ihrem PATH ab. Installieren Sie dann AUCTeX von Emacs aus. GNU ELPA ist standardmäßig aktiviert, also ist nur M-x package-install RET auctex RET erforderlich. Beginnen Sie in Ihrem init.el (oder ~/.emacs.d/init.el) mit TeX-PDF-mode, um standardmäßig die Ausgabe von PDF zu verwenden, und TeX-source-correlate-mode, um die Quelle an PDF (SyncTeX) zu binden.

Hier ist ein praktisches init.el mit use-package. Wenn Sie TeX-source-correlate-method auf synctex setzen und TeX-source-correlate-start-server aktivieren, wird die umgekehrte Suche vom Viewer zurück zur Quelle ermöglicht. Außerdem werden reftex-mode und LaTeX-math-mode automatisch in LaTeX-Puffer aktiviert:

;; GNU ELPA is enabled by default; ensure it is initialised.
(require 'package)
(package-initialize)

(use-package tex
  :ensure auctex
  :hook ((LaTeX-mode . TeX-source-correlate-mode)   ; SyncTeX
         (LaTeX-mode . reftex-mode)                  ; cross-references
         (LaTeX-mode . LaTeX-math-mode))             ; ` math shortcuts
  :config
  (setq TeX-auto-save t           ; write parse data (the auto/ dir)
        TeX-parse-self t          ; scan the file for \usepackage etc.
        TeX-PDF-mode t)           ; produce PDF, not DVI
  ;; Tie source lines to PDF positions and run a server for inverse search.
  (setq TeX-source-correlate-method 'synctex
        TeX-source-correlate-start-server t))

TeX-parse-self und TeX-auto-save weisen AUCTeX an, das Dokument zu analysieren – indem sie die Makros aus den Paketen einziehen, die Sie \usepackage haben – und das Ergebnis in einem auto/-Verzeichnis zwischenzuspeichern. Der Lohn ist eine Fertigstellung, die sich an die von Ihnen tatsächlich geladenen Pakete anpasst.

Das Herzstück des Kompilierens ist C-c C-c (TeX-command-master). Drücken Sie darauf und der Minipuffer fragt, was als nächstes ausgeführt werden soll, und schlägt einen Standard basierend auf dem Status des Dokuments vor (zuerst LaTeX, erneut LaTeX, wenn Referenzen nicht aufgelöst sind, BibTeX, wenn eine Bibliographie vorhanden ist, dann View). Akzeptieren mit Enter und Wiederholen ist die Grundschleife. Im Gegensatz dazu C-c C-a (TeX-command-run-all) verkettet die erforderlichen Schritte automatisch bis zu einem Fehler oder Abschluss und öffnet bei Erfolg den Viewer für Sie. Wenn Sie nur zu einem fertigen PDF gelangen möchten, ist C-c C-a der schnelle Weg.

Um latexmk als Compiler zu standardisieren, installieren Sie das Paket auctex-latexmk und rufen Sie (auctex-latexmk-setup) auf. Dadurch wird ein LatexMk-Eintrag zu den C-c C-c-Auswahlmöglichkeiten hinzugefügt, und die Einstellung von TeX-command-default auf "LatexMk" macht ihn zur Standardeinstellung. Da latexmk Abhängigkeiten überprüft und genau so oft wie nötig erneut ausführt, zählen Sie nie Durchgänge für Querverweise oder das Inhaltsverzeichnis. auctex-latexmk erbt auch TeX-PDF-mode und TeX-source-correlate-mode von AUCTeX und fügt automatisch die Ausgabe von PDF und -synctex=1 hinzu.

(use-package auctex-latexmk
  :ensure t
  :after tex
  :config
  ;; Make latexmk pick up TeX-PDF-mode (pass -pdf when PDF output is on).
  (setq auctex-latexmk-inherit-TeX-PDF-mode t)
  (auctex-latexmk-setup)
  ;; Offer LatexMk as the default action for C-c C-c.
  (setq-default TeX-command-default "LatexMk"))

Engine- und Bibliografiedetails sind in einem .latexmkrc im Projektstamm am saubersten (unabhängig von den Einstellungen von AUCTeX; der von C-c C-c gestartete latexmk liest sie auch). Weisen Sie für Japanisch beispielsweise upLaTeX + dvipdfmx zu $latex / $dvipdf zu und wählen Sie $pdf_mode = 3. Einzelheiten finden Sie auf der Seite „Build-Tools“.

Die AUCTeX-Schlüssel, die Sie täglich erreichen, sind in einer Tabelle zusammengefasst (die Spalte name ist die wörtliche Schlüsselsequenz):

RefTeX – Querverweise und Zitate

RefTeX ist ein Begleiter, der sich auf die Verwaltung von \label, \ref und \cite konzentriert. Es ist von AUCTeX getrennt und mit Emacs selbst gebündelt (keine separate Installation). Aktivieren Sie reftex-mode in LaTeX-Puffer wie in init.el oben und lassen Sie es mit AUCTeX zusammenarbeiten, und die Beschriftung und Referenzierung wird erheblich einfacher.

Der Knackpunkt ist, dass Sie niemals Etiketten von Hand erfinden müssen. C-c ( (reftex-label) schaut, wo Sie sich befinden (Abbildung, Tabelle, Gleichung, Abschnitt) und schlägt eine sinnvoll vorangestellte Bezeichnung (fig:, tab:, eq:, …) zum Einfügen vor. Als Referenz: C-c ) (reftex-reference) lässt Sie einfach aus vorhandenen Beschriftungen auswählen. Für Zitate durchsucht C-c [ (reftex-citation) Ihr .bib nach regulärem Ausdruck und fügt \cite{...} für den von Ihnen gewählten Eintrag ein. Und C-c = (reftex-toc) öffnet einen Inhaltsverzeichnispuffer für das gesamte Dokument in einem anderen Fenster, sodass Sie zu einem Abschnitt springen oder die Struktur überblicken können.

Für eine tiefe Integration mit AUCTeX legen Sie reftex-plug-into-AUCTeX fest. Die eigene \label-Einfügung von AUCTeX und die Vervollständigung von \ref/\cite durchlaufen dann RefTeX, und die beiden Pakete fühlen sich wie eins an. Selbst in Projekten mit mehreren Dateien (\include/\input) folgt RefTeX der Masterdatei, um alle Beschriftungen und Zitate im gesamten Dokument zu erfassen.

(use-package reftex
  :ensure nil                 ; bundled with Emacs
  :hook (LaTeX-mode . turn-on-reftex)
  :config
  (setq reftex-plug-into-AUCTeX t   ; cooperate with AUCTeX
        reftex-cite-format 'natbib)) ; or 'biblatex, etc.

Vorschau-Latex – Inline-Vorschau

preview-latex setzt tatsächlich Mathematik, Zahlen, tikzpictures und dergleichen mit LaTeX und überlagert dann das Ergebnis als Bild direkt dort im Quellpuffer. Im Lieferumfang ist AUCTeX enthalten, sodass nichts extra installiert werden muss. Die Quelle einer $...$-, \[...\]- oder equation-Umgebung bleibt bearbeitbar, wird jedoch als festgelegte Mathematik angezeigt, wenn Sie sie überprüfen möchten – ein WYSIWYG-ähnliches Gefühl, bleibt aber reiner Text.

Befehle beginnen mit C-c C-p (Vorschau). C-c C-p C-p (preview-at-point) zeigt nur das Objekt am Cursor in der Vorschau an (erneut drücken, um zur Quelle zurückzukehren). C-c C-p C-b übernimmt den gesamten Puffer, C-c C-p C-d das gesamte Dokument und C-c C-p C-r einen ausgewählten Bereich. C-c C-p C-c C-p löscht Vorschauen in einer Region. Unter der Haube läuft LaTeX, um die Bilder zu generieren, daher dauert der erste Durchgang einen Moment.

Preview-Latex benötigt Ghostscript und dvipng (oder einen PDF-to-image-Schritt), um die Bilder zu erstellen. Daher müssen diese in Ihrer Distribution vorhanden sein (TeX Live hat sie normalerweise). Dies lohnt sich am meisten bei Dokumenten mit vielen langen Gleichungen oder kommutativen Diagrammen, bei denen Sie beim Schreiben das eingestellte Ergebnis auf einen Blick sehen möchten.

YaTeX (野鳥) – die japanisch orientierte Wahl

YaTeX (野鳥, „wilder Vogel“) ist ein LaTeX-Hauptmodus für Emacs von Yuuji Hirose. International ist AUCTeX die gebräuchlichere Wahl, aber in Japan erfreut sich YaTeX anhaltender Beliebtheit und einer umfangreichen japanischen Dokumentation. Der aktuellste Wert liegt bei 1,84 (Februar 2025). Installieren Sie es von MELPA mit M-x package-install RET yatex RET (oder legen Sie es manuell in site-lisp ab und erweitern Sie load-path).

Seine Philosophie unterscheidet sich ein wenig von AUCTeX und basiert auf „Geben Sie die ersten paar Buchstaben plus Vervollständigung ein“, um Makros und Umgebungen schnell einzufügen. Das Präfix ist standardmäßig C-c. C-c b ist eine Vervollständigung vom Anfangstyp (Umgebungen, \begin{...}...\end{...}), C-c s ist ein Abschnittstyp (\section, …), C-c l ist ein großer Typ (Größe/Gesicht wie \large) und C-c m ist ein Maketitle-Typ (argumentlose Makros wie \maketitle, \item). Der Schriftsatz beginnt mit C-c C-t: C-c C-t j-Schriftsätze und C-c C-t p-Vorschauen (startet den Viewer).

Ein paar Variablen verankern das japanische Setup. YaTeX-kanji-code ist die Kanji-Kodierung beim Speichern; Da UTF-8 jetzt Standard ist, setzen Sie es auf nil (beachten Sie die vorhandene Kodierung der Datei), wenn Sie nicht möchten, dass Dateien stillschweigend neu kodiert werden. tex-command ist der tatsächlich aufgerufene Satzbefehl – ​​z.B. "latexmk", "lualatex -synctex=1" oder "uplatex". Wenn Sie bibtex-command und makeindex-command auf upbibtex und upmendex setzen, funktionieren japanische Bibliografien und Indizes. Hier ist ein minimaler init.el:

(use-package yatex
  :ensure t                       ; from MELPA
  :mode ("\\.tex\\'" . yatex-mode)
  :config
  (setq YaTeX-kanji-code nil      ; keep the file's own encoding (UTF-8)
        tex-command "latexmk"     ; or "lualatex -synctex=1", "uplatex"
        bibtex-command "upbibtex"
        makeindex-command "upmendex"
        ;; Use C-c C-t style prefixes (C-c C-t j, C-c C-t p, ...).
        YaTeX-inhibit-prefix-letter t))

Wenn Sie YaTeX-inhibit-prefix-letter auf t setzen, werden die Satzschlüssel auf C-c C-t ... (die vom Modifikator gehaltene Redewendung Emacs) und nicht auf C-c t ... gesetzt. YaTeX liefert auch einen Schwestermodus für HTML, yahtml. AUCTeX und YaTeX sind am besten auf das eine oder andere festgelegt und nicht gemischt: Wählen Sie AUCTeX für hauptsächlich englischsprachige Arbeiten oder um Preview-Latex/RefTeX vollständig zu nutzen, und YaTeX, um schnell japanische Dokumente zu schreiben.

Eine praktische Emacs-Schreibschleife

Beginnen Sie nach dem Schreiben der Einstellungen nicht mit einer großen Abschlussarbeit. Korrigieren Sie zunächst die Schleife edit,typeset, reference,check-PDF auf einem kleinen main.tex. In AUCTeX mit C-c C-a durchlaufen; Sobald PDF geöffnet ist, erstellen Sie mit C-c ( Beschriftungen für Gleichungen oder Abbildungen und fügen Sie dann mit C-c ) Referenzen aus der Prosa ein. Wenn ein Fehler auftritt, springen Sie mit „C-c \“ zum nächsten und lesen Sie das Protokoll weiterhin in „Emacs“. Sobald Sie diese Schleife in Ihren Fingern haben, ist Emacs nicht mehr nur „konfiguriert“. Es wird zur Werkbank, an der die Kapitel der Abschlussarbeit jeden Tag tatsächlich voranschreiten.

Entscheiden Sie in der ersten halben Stunde, wem der Bau gehört, nicht das Thema oder die Farben. Gehen Sie entweder mit dem Standard-C-c C-c von AUCTeX durch oder delegieren Sie die Kette über auctex-latexmk an latexmk. Sobald dies mit einem Projekt .latexmkrc gepaart ist, kann dasselbe PDF aus Emacs, einem anderen Editor oder CI reproduziert werden.