57 lines
3.1 KiB
Markdown
57 lines
3.1 KiB
Markdown
# 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:
|
||
|
||
```bash
|
||
$: 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:
|
||
|
||
```bash
|
||
$: 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.
|