TeX-Umgebung / TeX-Distribution

Überblick

TeX64 ruft Kommandozeilen-Tools wie latexmk, lualatex und latexindent auf. Verwenden Sie eine vorhandene TeX-Distribution oder bestätigen Sie den Download und die Installation einer verwalteten TeX-Live-Umgebung.

Warum eine TeX-Distribution nötig ist

Das TeX64-App-Paket enthält keine LaTeX-Engine. Es ruft TeX-Befehle aus einer vorhandenen oder appverwalteten Distribution auf Ihrem Gerät auf. Ohne TeX-Distribution ist keine Kompilierung möglich.

  • TeX64 ist auf externe TeX-Tools angewiesen (latexmk, lualatex, synctex)
  • Die Installation einer TeX-Distribution ist eine Voraussetzung
  • Ohne Distribution zeigt TeX64 Kompilierungsfehler an

Optionen

MacTeX (empfohlen)

  • Größe: ~4 GB
  • URL: https://www.tug.org/mactex/
  • Installation: .pkg herunterladen und Installer ausführen
  • Enthält: Alles (latexmk, lualatex, latexindent, synctex, alle Pakete)
  • Für japanische Nutzer: CJK-Pakete sind standardmäßig enthalten
  • Geeignet für: Einsteiger, Nutzer, die Null-Konfiguration wünschen

BasicTeX (minimale Installation)

TeX Live (manuell)

  • TeX Live direkt außerhalb von MacTeX verwalten
  • Für Homebrew-Nutzer: brew install texlive

Installation überprüfen

Öffnen Sie das Terminal und führen Sie diese Befehle aus, um zu prüfen, ob alle Tools gefunden werden:

which lualatex
which latexmk
which latexindent
which synctex

Alle sollten Pfade zurückgeben. Liefert einer nichts, ist das Tool nicht installiert oder nicht im PATH.

In TeX64: Einstellungen > Umgebung zeigt für jedes Tool einen grünen/roten Status.

Windows 10/11 einrichten

Unter Windows x64 können Sie verwaltetes TeX Live, eine normale TeX-Live-Installation oder MiKTeX verwenden.

Verwaltetes TeX Live

  • TeX64 > Einstellungen > Umgebung öffnen und die Installation des verwalteten TeX Live wählen.
  • Download prüfen und bestätigen. Eine vollständige Installation benötigt mehrere GB freien Speicher und kann dauern.
  • TeX64 bis zum Abschluss geöffnet lassen; die Installation liegt in einem App-verwalteten Ordner und wird automatisch erkannt.

TeX Live (manuell)

  • Offiziellen Windows-Installer der TeX Users Group laden und ausführen.
  • Bei mehreren GB freiem Speicher das vollständige Schema wählen, um fehlende Pakete zu vermeiden.
  • C:\texlive\<year>\bin\windows zu PATH hinzufügen und TeX64 vollständig beenden und neu starten.
  • https://www.tug.org/texlive/acquire-netinstall.html

MiKTeX

  • MiKTeX installieren und in der MiKTeX Console Updates sowie fehlende Pakete installieren.
  • Die bedarfsgesteuerte Paketinstallation aktivieren, wenn fehlende .sty-Dateien beim Build aufgelöst werden sollen.
  • Prüfen, dass das MiKTeX-bin-Verzeichnis in PATH liegt und lualatex, latexmk und synctex verfügbar sind.
  • https://miktex.org/download

In PowerShell prüfen

Diese Befehle in einem neuen PowerShell-Fenster ausführen und danach Einstellungen > Umgebung in TeX64 prüfen:

Get-Command lualatex
Get-Command latexmk
Get-Command latexindent
Get-Command synctex

Wird ein Befehl nicht gefunden, PATH unter Windows-Einstellungen > System > Info > Erweiterte Systemeinstellungen > Umgebungsvariablen korrigieren und PowerShell sowie TeX64 vollständig neu starten.

Windows-Fehlerbehebung

  • TeX Live: Das Jahr in PATH muss dem Installationsordner entsprechen und der Pfad mit \bin\windows enden.
  • MiKTeX: In der MiKTeX Console aktualisieren und latexmk oder das im Build-Protokoll genannte Paket installieren.
  • Verwaltete Installation: stabile Verbindung und mehrere GB freien Speicher prüfen, unter Einstellungen > Umgebung erneut versuchen und beim Support das Setup-/Build-Protokoll mitsenden.

Paketverwaltung (tlmgr)

  • Paketmanager aktualisieren: sudo tlmgr update --self
  • Alle Pakete aktualisieren: sudo tlmgr update --all
  • Paket installieren: sudo tlmgr install <package>
  • Pakete suchen: sudo tlmgr search --global --file <filename>

PATH-Konfiguration

  • MacTeX fügt /Library/TeX/texbin automatisch hinzu
  • Homebrew verwendet /opt/homebrew/bin
  • Falls PATH nicht gesetzt: export PATH="/Library/TeX/texbin:$PATH" in ~/.zshrc eintragen
  • Nach PATH-Änderungen Terminal und TeX64 neu starten

Japanisches LaTeX-Setup

  • MacTeX: Enthält CJK-Pakete standardmäßig
  • BasicTeX: Japanische Pakete separat installieren: sudo tlmgr install collection-langjapanese
  • Paket luatexja mit lualatex verwenden
  • \usepackage{luatexja} zu Ihrer .tex-Datei hinzufügen

Häufige Probleme

latexmk nicht gefunden

MacTeX installieren oder sudo tlmgr install latexmk ausführen

Fehlende .sty-Datei

sudo tlmgr install <package> ausführen

PATH-Probleme

Zur Shell-Profil-Datei hinzufügen

Berechtigung verweigert

sudo verwenden

Bei Fragen oder Unterstützungsbedarf besuchen Sie die Support-Seite.