TeX-Umgebung / TeX-Distribution

Überblick

TeX64 ruft Kommandozeilen-Tools wie latexmk, lualatex und latexindent auf, um Ihre Dokumente zu kompilieren. Eine TeX-Distribution muss auf Ihrem System vorinstalliert sein.

Warum eine TeX-Distribution nötig ist

TeX64 enthält keine eigene LaTeX-Engine. Es ruft Systembefehle auf Ihrem Mac auf. Ohne eine TeX-Distribution ist eine Kompilierung nicht 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)

• Größe: ~100 MB
• URL: https://www.tug.org/mactex/morepackages.html
• Nach der Installation: Fehlende Pakete manuell mit tlmgr ergänzen
• Geeignet für: Erfahrene Nutzer, die minimalen Speicherbedarf wünschen

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.

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.