DHBW LaTeX-Vorlage für VS Code
Neue wissenschaftliche Arbeit (T1000, T2000, T3000, Bachelorarbeit …) mit einem Klick anlegen, beim
Speichern das PDF erstellen und vor der Abgabe alles prüfen. Zugeschnitten auf die DHBW-Vorlage
(Version 3.3, mitgeliefert) und TeX Live.
Installieren
- TeX Live installieren (einmalig, vollständige Installation):
tug.org/texlive/windows.html (Windows),
MacTeX (macOS) oder
texlive-full (Linux).
- Extension installieren: Unter Releases (rechts auf der Repo-Startseite)
dhbw-latex-vorlage-<version>.vsix herunterladen. In VS Code links auf Erweiterungen → oben rechts
… → Aus VSIX installieren …. LaTeX Workshop (PDF-Vorschau) wird automatisch mitinstalliert.
- Links auf das Doktorhut-Symbol → Neue Arbeit anlegen, Angaben ausfüllen, Arbeit anlegen.
Das erste PDF wird sofort erstellt und rechts neben dem Text angezeigt.
Zwei Varianten beim Anlegen:
- Leer: Kapitelgerüst Einleitung bis Fazit, ohne Anleitung, Beispielkapitel, Beispielquellen und Beispiel-Glossar.
- Mit Anleitung und Beispielen: die komplette Vorlage zum Ausprobieren.
Build-Reste (output/, .aux, .bbl, .gls …) einer Vorlage werden beim Anlegen nie mitkopiert.
Schreiben
| Was |
Wie |
| PDF aktualisieren |
Speichern (Strg+S). Statusleiste unten links: „PDF aktuell · 42 S.“ oder „1 Fehler“ |
| Fehler finden |
Klick auf „Fehler“ in der Statusleiste springt zur Stelle; Meldung auf Deutsch |
| Zitat einfügen |
Seitenleiste → Zitat einfügen … oder Rechtsklick im Text: Quelle suchen, indirekt/direkt, Seiten → \citeM{i}{Schluessel}{12}{14} |
| Quelle hinzufügen |
Quelle hinzufügen …: Formular für Buch, Artikel, Webseite, Sammelband, Sonstiges – oder DOI/ISBN eingeben und Daten holen |
| Abbildung einfügen |
Abbildung einfügen …: Bild wählen (wird bei Bedarf nach images/ kopiert), Bildunterschrift, Quelle |
| Glossarbegriff / Abkürzung |
Seitenleiste oder Rechtsklick auf markiertes Wort; \ac{ schlägt alle Abkürzungen vor |
| Neues Kapitel |
Neues Kapitel … (wird automatisch eingebunden) |
| Text ↔ PDF |
Stelle im PDF zeigen (Strg+Alt+J); Strg+Klick ins PDF springt zurück in den Text |
| Umfang |
Wörter zählen: Fließtext je Kapitel; Seitenzahl steht in der Statusleiste |
| Vor der Abgabe |
Abgabe prüfen: Platzhalter auf Deckblatt und im Abstract, Anleitung/Beispielkapitel noch drin, Quellen und Verweise ins Leere, \todo, leere Kapitel … |
| Verzeichnisse sehen alt aus |
Aufräumen & neu erstellen |
Schnipsel beim Tippen: citeM, tabelle, aufzaehlung.
Das PDF liegt als dokumentation.pdf im Ordner der Arbeit, die Hilfsdateien im (ausgeblendeten)
Unterordner output/.
Zusammenspiel mit LaTeX Workshop
Die Extension baut beim Speichern selbst (Glossar, Literatur, Verzeichnisse – so viele Durchläufe wie
nötig) und übersetzt Fehlermeldungen. Alles andere kommt von LaTeX Workshop: PDF-Vorschau, Sprung
zwischen Text und PDF, Autovervollständigung (\cite, \citeM, \autoref, \gls), Gliederung.
Der grüne Knopf von LaTeX Workshop funktioniert weiterhin; er baut mit latexmk in dieselben Ordner.
Einstellungen
| Einstellung |
Bedeutung |
dhbwLatex.beimSpeichernBauen |
manuell (Standard: bei Strg+S), immer (auch bei Auto-Speichern), nie |
dhbwLatex.pdfAutomatischAnzeigen |
PDF nach dem ersten Erstellen neben dem Text öffnen |
dhbwLatex.texPfad |
Ordner mit pdflatex, falls die automatische Suche nichts findet |
dhbwLatex.vorlagenOrdner |
eigener Ordner mit einer neueren Vorlage für Neue Arbeit anlegen |
Vorhandene Arbeiten
Ordner der Arbeit öffnen (den Ordner mit dokumentation.tex selbst, nicht den darüber) und Einrichten
bestätigen. Dabei werden die Projekteinstellungen ergänzt und alte Hilfsdateien im Hauptordner entfernt –
die waren früher oft der Grund für ein veraltetes Glossar oder Literaturverzeichnis.
Probleme?
Seitenleiste → Umgebung prüfen zeigt, ob TeX Live, BibTeX, latexmk und alle Pakete der Vorlage da
sind, installiert fehlende Pakete per tlmgr und bietet einen Probelauf an. Die komplette Ausgabe
steht im Ausgabefenster DHBW LaTeX.
- PDF in Adobe Reader geöffnet: Windows sperrt die Datei. Adobe schließen oder die Vorschau in VS Code nutzen.
- Arbeit in OneDrive: funktioniert; meldet LaTeX „I can't write on file“, kurz warten und erneut speichern.
- DOI/ISBN-Abfrage: braucht Internet (doi.org, openlibrary.org, googleapis.com).
Rechtschreibung
VS Code prüft von sich aus keine Rechtschreibung. Empfehlung: die Erweiterungen Code Spell Checker
und German – Code Spell Checker installieren und mit dem Befehl Enable German Spell Checker
Dictionary einschalten.
Entwicklung
npm install
npm test # Engine-Tests gegen ein echtes TeX Live
npm run package # → dist-vsix/dhbw-latex-vorlage-<version>.vsix
Neue Vorlage: Inhalt von vorlage/ ersetzen (.gitignore → _gitignore, .vscode → _vscode),
Version in package.json erhöhen. Jeder Merge auf main baut automatisch ein Release.
