latex-wochenende/README.md

2.1 KiB

LaTeX-Wochenende

In diesem Repository befinden sich die Präsentation und die Materialien für das LaTeX-Wochenende der Fachschaft WIAI. Für die Präsentation wurde auf Reveal.js zurückgegriffen, dieses Repository ist ein Fork von Reveal.js.

Installation des Fachschafts-Themes

Wir verwenden für dieses Projekt das Fachschafts-Theme für Reveal.js als Git-Submodul. Deshalb muss das Repository etwas anders behandelt werden als "normale" Repositories. Unter lib/css/fswiai-theme sollte nach einfachem git clone ... von latex/latex-wochenende ein leerer Ordner zu finden sein. In diesem Ordner soll unsere CSS-Datei mit dem Theme liegen. Da die Datei ein eigenes Repository hat, binden wir dieses ein, statt die Datei immer zu kopieren. Um den Inhalt des Repositoriums zu laden, was leider nicht automatisch von Git gemacht wird, sind folgende Befehle notwendig:

$ cd latex-wochenende
$ git submodule init
$ git submodule update

Danach sollte in dem Ordner die Datei fswiai-theme.css aufgetaucht sein. Um aktuelle Änderungen aus dem Repositorium des Themes zu laden, wird der folgende Befehl benötigt:

$ git submodule update --remote

Clonen ohne SSH

Das Laden des Submoduls schlägt fehl, wenn du keinen SSH-Key zu deinem Git-Account hinzugefügt hast. In diesem Fall muss unter path/to/latex-wochenende/.git/config der URL-Eintrag für das Submodul geändert werden (letzte Zeile):

[submodule "lib/css/fswiai-theme"]
        active = true
        # Vorher: url = ssh://git@git.wiai.de:22222/fknoch/fswiai-revealjs-theme.git
        url = https://git.wiai.de/fknoch/fswiai-revealjs-theme.git

Anschließend sollte $ git submodule update funktionieren.

Verwendung der Präsentation

Die Präsentation benötigt eine aktuelle Version von Node.js. Im Anschluss müssen untenstehende Befehle ausgeführt werden, um einen lokalen Server unter http://localhost:8000 zu starten.

$ cd path/to/latex-wochenende/presentation
$ npm install
$ npm start