Files were not saved..

office/latex-in-vscode.md

@@ -0,0 +1,56 @@
+# 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.