45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
# 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
|
|
``` |