# LaTeX-Wochenende

In diesem Repository befinden sich die Präsentation und die Materialien für das LaTeX-Wochenende der Fachschaft WIAI.

## Verwendung der Präsentation

Zum Zeigen der Präsentation wird ein aktueller Browser benötigt. In diesem muss lediglich die Datei `slides.de.html` (bzw. `slides.en.html` für die englische Version) geöffnet werden.

## Anpassungen vornehmen

Um Inhalte der Präsentationen abzuändern oder zu ergänzen, muss zunächst das Repository geklont werden. Hierbei ist zu beachten, dass wir ein Submodul verwenden und deshalb eine zusätzliche Option beim Klonen notwendig ist:

```sh
git clone --recurse-submodules https://git.stuve-bamberg.de/latex/latex-wochenende.git
```

### Folien kompilieren

Zum Kompilieren der Präsentation werden python3 und pandoc (empfohlene Version: [2.5](https://github.com/jgm/pandoc/releases/tag/2.5)) verwendet. Als nächstes müssen alle benötigten Python-Pakete geladen werden.

```sh
cd latex-wochenende/onpoint
pip3 install -r requirements.txt
```

Damit sind alle benötigten Komponenten installiert. Mittels `python3 main.py ..` können alle Sprachversionen kompiliert werden. Danach stehen sie wie oben beschrieben als HTML-Dateien zur Verfügung.

Die Präsentation baut auf dem von uns entwickelten [onPoint-Präsentationswerkzeug](https://git.stuve-bamberg.de/latex/onpoint/) auf. Einen Überblick über die Verzeichnisstruktur und eine Anleitung zum automatischen Kompilieren bei jeder Änderung (unter Linux) finden sich [im zugehörigen README](https://git.stuve-bamberg.de/latex/onpoint/src/branch/main/README.md#user-content-the-project-structure).

### Stylesheet anpassen

Das Stylesheet verwendet Sass. Nach der Installation lassen sich die Styles folgendermaßen automatisch erzeugen:

```sh
cd css
sass --watch latex.scss:latex.css
```

### TeX-Beispiele in SVG umwandeln

Hierfür gibt es ein Skript, das mit dem Werkzeug `pdf2svg` arbeitet.

```
bash pdf2svg.sh svg/<chapter>/<file>.tex
```