Markdown + Latex für Thesis

Dieses Template ist eine Variante des BFH-Latex-Template vom BFH-Intranet mit:

• Style-Klasse (bfh_template.cls) -> einfacheres main.tex
• Markdown-Syntax (auch Latex-Befehle möglich)
• simples Makefile

Die integration von Markdown wurde mit Pandoc umgesetzt.

Voraussetzungen

Linux/Unix/Mac OSX System mit

• Pandoc
• make
• Latex (MacTeX)
• "sre/rubber" (fork, https://github.com/sre/rubber)
• openout_any = r gesetzt in /usr/local/texlive/2014/texmf-dist/web2c/texmf.cnf Anleitung

Verwendung

• Git clone / zip download
• Unnötige Features/Kapitel auskommentieren in main.tex
• Pfad sollte keine leerzeichen enthalten, sonst gibt es Probleme mit einigen Tools.
• Details einstellen in bfh_template.cls. (z.B. für einseitigen Druck twoside entfernen).
• Markdown-Dateien mit Endung .md anlegen und in main.tex mit include einbinden.
• kapitel/demo.md zeigt die wichtigste Syntax

Build actions

• make pdf: convert .md and create pdf
• make clean: remove temp. / .md.tex files

For debugging:

• make markdown: (only) convert .md -> .md.tex
• make rubber: (only) create pdf (allows editing temp. .md.tex files.)
• make pdf test: create PDF and compare with expected pdf

Troubleshooting

Developer Notes

Notes to developers / forkers:

• Zitate wie [@juergens:einfuehrung] werden mit \autocite{} umgesetzt. Die von BFH verwendeten Packages kennen den Befehl nicht. Damit es trotzdem funktioniert gibt es im bfh_template.cls ein Alias dafür.
• Es wird ein der Fork von Rubber verwendet, weil es das Modul glossaries anbietet.

Further resources

• Einführung in Latex und Links zu weiteren Informationen: https://www.tug.org/mactex/src/WelcomeToMacTeX.pdf
• Einführung in Latex: http://latex.hpfsc.de/content/latex_tutorial/literatur_bibtex/