Readme.md hinzugefügt
This commit is contained in:
53
README.md
Normal file
53
README.md
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
# Vorraussetzungen
|
||||||
|
Damit die Dokumentation korrekt compiliert, müssen zwei Vorraussetzungen erfüllt sein:
|
||||||
|
1. Eine LaTeX distribution (MiKTeX, TeX Live, MacTeX)
|
||||||
|
2. Ein entsprechender githook um den aktuellen commit hash korrekt in das Dokument übernehmen zu können.
|
||||||
|
|
||||||
|
## LaTeX Distributionen
|
||||||
|
- [MiKTeX](https://miktex.org/)
|
||||||
|
- [TeXLive](https://www.tug.org/texlive/)
|
||||||
|
- [MacTeX](https://www.tug.org/texlive/)
|
||||||
|
|
||||||
|
## Git hook
|
||||||
|
Eine Datei mit dem Namen `post-checkout` im Ordner `.git\hooks` mit folgendem Inhalt erstellen:
|
||||||
|
```shell
|
||||||
|
#!/bin/sh
|
||||||
|
# Copyright 2015 Brent Longborough
|
||||||
|
# Part of gitinfo2 package Version 2
|
||||||
|
# Release 2.0.7 2015-11-22
|
||||||
|
# Please read gitinfo2.pdf for licencing and other details
|
||||||
|
# -----------------------------------------------------
|
||||||
|
# Post-{commit,checkout,merge} hook for the gitinfo2 package
|
||||||
|
#
|
||||||
|
# Get the first tag found in the history from the current HEAD
|
||||||
|
FIRSTTAG=$(git describe --tags --always --dirty='-*' 2>/dev/null)
|
||||||
|
# Get the first tag in history that looks like a Release
|
||||||
|
RELTAG=$(git describe --tags --long --always --dirty='-*' --match '[0-9]*.*' 2>/dev/null)
|
||||||
|
# Hoover up the metadata
|
||||||
|
git --no-pager log -1 --date=short --decorate=short \
|
||||||
|
--pretty=format:"\usepackage[%
|
||||||
|
shash={%h},
|
||||||
|
lhash={%H},
|
||||||
|
authname={%an},
|
||||||
|
authemail={%ae},
|
||||||
|
authsdate={%ad},
|
||||||
|
authidate={%ai},
|
||||||
|
authudate={%at},
|
||||||
|
commname={%cn},
|
||||||
|
commemail={%ce},
|
||||||
|
commsdate={%cd},
|
||||||
|
commidate={%ci},
|
||||||
|
commudate={%ct},
|
||||||
|
refnames={%d},
|
||||||
|
firsttagdescribe={$FIRSTTAG},
|
||||||
|
reltag={$RELTAG}
|
||||||
|
]{gitexinfo}" HEAD > .git/gitHeadInfo.gin
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
# Build
|
||||||
|
Wenn alle Vorraussetzungen erfüllt sind, kann das dokument mit folgendem Befehl erstellt werden:
|
||||||
|
```shell
|
||||||
|
pdflatex fat.tex
|
||||||
|
```
|
||||||
|
Beim ersten erstellen, kann es sein, dass der Befehl mehrfach ausgeführt werden muss, damit das inhaltsverzeichnis und alle Referenzen korrekt bestimmt werden können.
|
||||||
Reference in New Issue
Block a user