# Templates für die Seminarfacharbeit an der TGS-Weimar

## Pandoc Template

Das Template [seminarfach.latex](https://gitlab.com/october32551/tgsw_semi/-/blob/main/templates/seminarfach.latex) ist eine Modifikation des [default Pandoc Templates](https://github.com/jgm/pandoc/blob/master/data/templates/default.latex).

### Variablen

Die folgenden Variablen müssen in dem [Yaml Metadata Block](https://pandoc.org/MANUAL.html#extension-yaml_metadata_block) der Markdown Datei angegeben werden um das Titelblatt und die Kopfzeile richtig zu generieren.

#### allgemein Variablen

+ `documentclass`
	+ eg. `documentclass: article`
+ `mainfont`
	+ eg. `mainfont: Carlito`
+ `titel`
	+ eg. `titel: Ein sehr langer Titel der meine Seminarfacharbeit beschreibt`
+ `kurztitel` für für Kopfzeile
	+ falls `titel` zu lang für die Kopfzeile ist, kann **auch** ein kurztitel definiert werden
	+ eg. `kurztitel: Mein Thema`
+ `student`
	+ wenn mehrere Angegeben werden sollten diese schon Alphabetisch sortiert angegeben werden
	+ eg.:

```yaml
student:
- nachname: Mustermann
  name: Max
  stammkurs: 11 1
- nachname: Müller
  name: Marie
  stammkurs: 12 3
```

+ `nur-nachname`
	+ kann zu `nur-nachname: true` gesetzt werden um nur die Nachnamen in der Kopfzeile zu setzen

#### Deckblatt

Falls ein Deckblatt generiert werden soll müssen diese Variablen gesetzt werden und `deckblatt: true` hinzugefühgt werden.

+ `schulname`
	+ eg. `schulname: Staatliche Gemeinschaftsschule Weimar`
+ `seminarfachlehrer-in`, `seminarfachlehrerin` oder `seminarfachlehrer`
	+ eg. `seminarfachlehrer: Max Mustermann`
	+ `Seminarfachlehrer-in` für SeminarfachlehrerIn
+ `fachbetreuer-in`, `fachbetreuerin` oder `fachbetreuer`
	+ eg. `fachbetreuerin: Martina Mustermann`

Um eine eigenes Latex-Deckblatt zu benutzen muss `deckblatt-datei: Pfad-zur-datei` angegeben werden, z.B. `deckblatt-datei: ./deckblatt.tex`

### Beispiele

#### Yaml Kopf

```yaml
---
documentclass: article
titel: A very long title about stuff that is very interessting
kurztitel: A title
mainfont: Carlito
deckblatt: true
schulname: Schule Niemandsland
seminarfachlehrer-in: Karl Marx
fachbetreuer: Albert Einstein
student:
- nachname: Erbse
  name: Markus
  stammkurs: 21 1
- nachname: Fuchs
  name: Elise
  stammkurs: 12 7
- nachname: Gurke
  name: Angela
  stammkurs: 14 5
nur-nachname: true
datum: 21. Dezember 1999
---
```

#### Dokument

+ [Quell-Markdown](Beispiele/example.md)
+ [Entstandene PDF-Datei](Beispiele/example.pdf)

### Kompilieren

+ template datei muss in User-Dir/templates sein siehe `pandoc -v`
	+ unter Linux: `~/.local/share/pandoc/templates`
	+ unter Windows: `C:\Users\USERNAME\AppData\Roaming\pandoc`
+ Befehl:

```bash
pandoc file.md --standalone --template=seminarfach -o outputfile.pdf --pdf-engine=xelatex
```

# Ressourcen

+ [allgemeine Ressourcen zu Pandoc und Markdown](https://baireuther.de/page/markdown/)
+ [Pandoc Installation](https://pandoc.org/installing.html)

# Todo

+ [ ] definition von `documentclass` unnötig machen 
+ [ ] vielleicht generelle einführung in Pandoc