docs/office/latex-in-vscode.md
2025-12-13 17:08:32 +01:00

3.1 KiB
Raw Permalink Blame History

LaTeX-Umgebung in VS Code unter Arch Linux

Eine produktive, leichtgewichtige LaTeX-Umgebung in Visual Studio Code auf Arch Linux. Diese Konfiguration nutzt modulare Arch-Pakete anstelle der monolithischen texlive-full-Installation, um Speicherplatz zu sparen und dennoch volle Kompatibilität mit der VS Code Extension "LaTeX Workshop" zu gewährleisten.

Pakete

Die Installation setzt sich aus folgenden modularen Paketen zusammen:

  • texlive-basic: Die absolute Basis-Infrastruktur für TeX.
  • texlive-latex: Kern-LaTeX-Pakete und Formate.
  • texlive-latexrecommended: Standard-Pakete, die für die meisten Dokumente benötigt werden.
  • texlive-fontsrecommended: Wichtige Schriftarten (z.B. Helvetica/Arial, Times), ohne die viele Standard-Templates fehlschlagen (behebt "Metric TFM not found" Fehler).
  • texlive-pictures: Grafik-Tools, notwendig für Pakete wie pgfplots oder tikz.
  • texlive-mathscience: Erweiterte mathematische Symbole und Formel-Umgebungen.
  • texlive-latexextra: Eine Sammlung häufig genutzter Zusatzpakete für besseres Layout (z.B. Tabellen).
  • texlive-binextra: Enthält latexmk das Automatisierungstool, welches VS Code im Hintergrund zwingend benötigt.
  • texlive-langgerman: Deutsche Sprachunterstützung (Silbentrennung, Umlaute).
  • biber: Modernes Backend für Literaturverzeichnisse.
  • perl-yaml-tiny & perl-file-homedir: Perl-Abhängigkeiten für das Code-Formatierungstool latexindent.

Installation

Installation der LaTeX-Distribution

Installiere alle notwendigen Komponenten über den Paketmanager:

$: sudo pacman -S texlive-basic texlive-latex texlive-latexrecommended texlive-fontsrecommended texlive-pictures texlive-mathscience texlive-latexextra texlive-binextra texlive-langgerman biber

Installation der Formatierungs-Tools

Damit die automatische Code-Formatierung ("Format Document") in VS Code funktioniert, müssen fehlende Perl-Module für latexindent nachinstalliert werden:

$: sudo pacman -S perl-yaml-tiny perl-file-homedir

VS Code Einrichtung

  1. Installiere die Extension LaTeX Workshop (James Yu).
  2. Es ist keine manuelle Konfiguration von "Recipes" notwendig, da latexmk (aus texlive-binextra) installiert wurde. Die Extension erkennt die Umgebung automatisch.

Verwendung

Erstelle eine .tex-Datei in VS Code und nutze die üblichen Befehle der LaTeX Workshop Extension:

  • Strg+Alt+B: Kompiliert das Dokument.
  • Strg+Alt+V: Öffnet die PDF-Vorschau.

Es wird außerdem automatisch ein Watcher gestartet, der bei jeder Speicherung die Datei neu kompiliert.

Fehlersuche & Hinweise

  • "Metric (TFM) file not found": Dies deutet auf fehlende Schriftarten hin. Stelle sicher, dass texlive-fontsrecommended installiert ist.
  • Aufräumen: Falls der Compiler nach Paket-Updates hängt, hilft oft das Bereinigen der temporären Dateien in VS Code: Strg+Shift+P -> LaTeX Workshop: Clean up auxiliary files.
  • Preambles: Achte bei der Verwendung von \input{../preamble.tex} darauf, dass der relative Pfad korrekt ist.