Initial commit.

.gitignore

@@ -0,0 +1,110 @@
+## Core latex/pdflatex auxiliary files:
+*.aux
+*.lof
+*.log
+*.lot
+*.fls
+*.out
+*.toc
+
+## Intermediate documents:
+*.dvi
+/*.ps
+/*.eps
+/*.pdf
+
+## Bibliography auxiliary files (bibtex/biblatex/biber):
+*.bbl
+*.bcf
+*.blg
+*-blx.aux
+*-blx.bib
+*.run.xml
+
+## Build tool auxiliary files:
+*.fdb_latexmk
+*.synctex.gz
+*.synctex.gz(busy)
+*.pdfsync
+
+## Auxiliary and intermediate files from other packages:
+
+# algorithms
+*.alg
+*.loa
+
+# amsthm
+*.thm
+
+# beamer
+*.nav
+*.snm
+*.vrb
+
+# glossaries
+*.acn
+*.acr
+*.glg
+*.glo
+*.gls
+
+# hyperref
+*.brf
+
+# listings
+*.lol
+
+# makeidx
+*.idx
+*.ilg
+*.ind
+*.ist
+
+# minitoc
+*.maf
+*.mtc
+*.mtc0
+
+# minted
+*.pyg
+
+# nomencl
+*.nlo
+
+# sagetex
+*.sagetex.sage
+*.sagetex.py
+*.sagetex.scmd
+
+# sympy
+*.sout
+*.sympy
+sympy-plots-for-*.tex/
+
+# todonotes
+*.tdo
+
+# xindy
+*.xdy
+
+# Pandoc output
+/*.tex
+!/template.tex
+/*.odt
+/*.docx
+
+# Aufgabenblatt
+sheets
+#!AA_*.pdf
+
+# Lock files
+.~lock*
+*#
+
+# Vim/Nano session files
+[._]*.s[a-w][a-z]
+[._]s[a-w][a-z]
+*.un~
+Session.vim
+.netrwhist
+*~

CAT-Projekt_Maar_Kittelberger.md

@@ -0,0 +1,469 @@
+---
+# Document metadata
+author: Carl Kittelberger \and Jenny Maar
+title: "Das CAT-Projekt"
+institute: "Ferdinand-von-Steinbeis Berufsschule"
+date: 2018-03-21
+
+# Language configuration
+lang: de-DE
+babel-lang: ngerman
+babel-otherlangs:
+  - english
+polyglossia-lang:
+    name: german
+    options:
+      - spelling=new
+
+# Fanciness
+colorlinks: true
+logo: img/steinbeis.png
+tables: true
+papersize: a4
+documentclass: report
+classoption: oneside
+#classoption: oneside,draft
+#sansfont: din1451mittel-regular.ttf
+#sansfont: din1451alt.ttf
+#sansfont: IBMPlexSans-Regular.ttf
+sansfont: Carlito-Regular.ttf
+sansfontoptions:
+  - Path=./fonts/Carlito/
+  #- Ligatures=TeX
+  - BoldFont=Carlito-Bold.ttf
+  - BoldItalicFont=Carlito-BoldItalic.ttf
+  - ItalicFont=Carlito-Italic.ttf
+  #- BoldFont=din1451altG.ttf
+  #- BoldFont=IBMPlexSans-Bold.ttf
+  #- BoldItalicFont=IBMPlexSans-BoldItalic.ttf
+  #- ItalicFont=IBMPlexSans-Italic.ttf
+monofont: IBMPlexMono-Regular.ttf
+monofontoptions:
+  - Path=./fonts/IBMPlexMono/
+  - Ligatures=TeX
+  - BoldFont=IBMPlexMono-Bold.ttf
+  - BoldItalicFont=IBMPlexMono-BoldItalic.ttf
+  - ItalicFont=IBMPlexMono-Italic.ttf
+fontsize: 12pt
+
+toc: true
+
+header-includes:
+    # For \pageref{LastPage}
+    - \usepackage{lastpage}
+
+    # For \textcolor
+    - \usepackage{xcolor}
+
+    # Use sans font for everything except maths
+    - \renewcommand{\familydefault}{\sfdefault}
+
+    # Use TT font for lstset
+    - \lstset{basicstyle=\footnotesize\ttfamily,breaklines=true}
+
+    # Fancy header (and footer)!
+    - \usepackage{fancyhdr}
+    - \usepackage{graphicx}
+    - \pagestyle{fancy}
+    - \fancyhf{}
+    - \fancyhead[L]{\large{\textit{\textbf{BFK-L} \\ CAT-Projekt}}}
+    - \fancyhead[R]{\raisebox{-0.1\height}{\includegraphics[height=32pt]{img/steinbeis.png}}}
+    - \fancyfoot[L]{\textcolor{gray}{Carl Kittelberger, Jenny Maar}}
+    - \fancyfoot[R]{\textcolor{gray}{\bfseries{Seite \thepage/\pageref*{LastPage}}}}
+    - \renewcommand{\headrulewidth}{0.4pt}
+    - \renewcommand{\footrulewidth}{0.4pt}
+    - \setlength\headheight{36pt}
+    - \fancypagestyle{plain}{}
+---
+
+\newpage
+
+# Arbeitsauftrag
+
+Für den Ausstellungsraum einer IT-Firma soll ein Hausnetzwerk
+exemplarisch auf einem Board dargestellt werden. Folgende
+Aufgabenstellung ist gegeben:
+
+1.  Montage von 2 CAT6a-Datendosen mit je zwei RJ-45-Buchsen
+2.  Montage von zwei AMJ-S-CAT6a-Anschlussbuchsen
+3.  Montage eines 6-Port-Patchpanels
+4.  Verlegung von CAT7-Leitungen
+5.  Qualitätsprüfung der Leitung
+6.  Herstellen von zwei Crossover-Kabel (1 Gbit/s)
+7.  Einrichten eines Peer-to-Peer-Netzwerks mit zwei Notebooks
+8.  Einrichten eines Internetzugangs mit Switch und Router
+
+# Montageplan
+
+Der Montageplan beinhaltet die feste Installation des Patchpanels und der
+Anschlussdosen mit Verdrahtung von jeweiligen Komponenten:
+
+![](img/photos/kabeltest-digital.jpg){height=9cm}
+
+## Bauteile
+
+Einzubauen sind folgende Bauteile:
+
+- Patchpanel, leere Netzwerkdosen
+
+  ![](img/photos/einrichtung-leer.jpg){width=8cm}
+
+- ELTROPA CAT7 Kabel
+
+  ![](img/photos/eltropa-cat7.jpg){width=8cm}
+
+- AMJ-S Modul CAT6A T568A
+
+  ![](img/extra/amjsmodul.png){height=3.5cm}
+
+- RJ45-Stecker, CAT6 STP geschirmt
+
+  ![](img/extra/rj45.png){height=3.5cm}
+
+\clearpage
+
+## Werkzeuge
+
+Uns stehen für das Projekt Werkzeuge aus einem Koffer zur Verfügung, enthalten
+sind:
+
+- Feinschraubendreher
+- Schraubendreher Plus-Minus
+- Anlegewerkzeug LSA-Plus
+- Automatische Abisolierzange Jokari
+- Abisolierer
+- Flachrundzange
+- Elektronikseitenschneider
+- Seitenschneider
+- Schere
+- Lineal
+
+![](img/photos/werkzeugkoffer-geraet.jpg){height=10cm}
+
+\clearpage
+
+## Messgeräte
+
+Zur Messung der Leitung und der durch den Aufbau zu schickenden Leitungen werden
+die unten aufgelisteten Geräte verwendet.
+
+Zur digitalen Messung:
+
+- Ethernet Performance Tester KE7200
+
+Zur analogen Messung:
+
+- Multimeter FLUKE 175
+- taco-nauert electronic Splitbox
+
+![](img/photos/kabeltest-digital-ok.jpg){height=8cm} ![](img/photos/kabeltest-analog-ok.jpg){height=8cm} ![](img/photos/splitbox.jpg){height=8cm}
+
+\clearpage
+
+# Verdrahtungsplan
+
+![](img/odg/montageplan.png){height=11.5cm}
+
+Die Verdrahtung geschieht per Norm EIA/TIA-568A.
+
+\clearpage
+
+# Aufbau des Netzwerkkabels
+
+![](img/photos/kabel-geflecht.jpg)
+
+![](img/extra/kabel-einseitig-offen.jpg){height=3cm}
+
+Das Netzwerkkabel selbst besteht aus einem Schirmgeflecht und verschiedenen
+miteinander verwirrten Kabelsträngen, jeweils in Paaren mittels Folie gebündelt
+und voneinander isoliert. Es ist ein so genanntes **Twisted-Pair-Kabel**.
+
+## Twisted-Pair-Kabel
+
+Bei Kabeln dieser Art sind die Adern in Paaren miteinander verwoben. Normalerweise
+entsteht die Möglichkeit, dass die parallel gelegten Adern sich gegenseitig
+stören und übersprechen können. Diese gegenseitige Störung nennt sich auch
+**Crosstalk** und kann am stärksten gemessen werden, wenn eine Leitung alleine Daten überträgt und
+dieses Signal auf die anderen Leitungen überspringt. Dadurch, dass die Adern
+von Leitungen in den verschiedenen Richtungen miteinander gepaart verwoben sind,
+wird dieser Crosstalk weitestgehend unterdrückt.
+
+### Kategorien und Klassen
+
+Die Kabeln sind in nummerierte Kategorien eingeteilt, die jeweils den
+Frequenzbereich und die daraus resultierende Bandbreite und Reichweite der Kabeln
+bezeichnet. Die Nummerierung beginnt bei eins und inkrementiert mit neueren
+und fortgeschritteneren Kabelkategorien. Die Kategorien können wiederum in Klassen
+gruppiert werden, die ähnliche Eigenschaften aufweisen und somit verwendet werden
+um Geräte zu kennzeichnen, die mehrere Kategorien unterstützen..
+Die am weitesten genutzten Kabeln heutzutage sind in den Kategorien CAT5 (100 MBit/s),
+CAT5e (1 GBit/s), CAT6 (1 GBit/s) und CAT7 (10 GBit/s). Das ELTROPA-Kabel das
+wir verwenden ist ein CAT7-Kabel und kann damit theoretisch bis zu 10 GBit/s
+übertragen, allerdings sind die Netzwerkdosen in der E-Klasse (CAT6) und können
+damit selbst nur 1 GBit/s durch die Leitung übertragen.
+
+| Kategorie | Klasse | Typ | Bandbreite | Anwendungen |
+| --- | --- | --- | --- | --- |
+| CAT1 | A | UTP | 0,4 MHz | Telefon-/Modemleitungen |
+| CAT2 | B | UTP | 4 MHz | Ältere Terminalsysteme |
+| CAT3 | C | UTP | 16 MHz | 10BASE-T und 100BASE-T4 |
+| CAT4 | | UTP | 20 MHz | 16-MBit/s-Token-Ring |
+| CAT5 | D | UTP | 100 MHz | 100BASE-TX und 1000BASE-T, LAN |
+| CAT5e | D | UTP | 100 MHz | 100BASE-TX und 1000BASE-T, LAN |
+| CAT6 | E | UTP | 250 MHz | 10GBASE-T |
+| CAT6a | E~A~ | STP | 500 MHz | 10GBASE-T |
+| CAT7 | F | S/FTP | 600 MHz | Telefon, CCTV, 10GBASE-T |
+| CAT7a | F~A~ | S/FTP | 1000 MHz | Telefon, CCTV, 10GBASE-T |
+| CAT8 | G | S/FTP | 1600-2000 MHz | Telefon, PoE, 40GBASE-T |
+
+\clearpage
+
+### Kabelbezeichnungsschema
+
+Kabelbezeichnungen folgen der ISO-Norm ISO/IEC-11801 (2002)E. Die Nomenklatur
+ist `XX/YZZ`, wobei:
+
+- `XX` die Gesamtschirmung bezeichnet.
+  - **U** - ohne Schirm
+  - **F** - Folienschirm
+  - **S** - Geflechtschirm
+  - **SF** - Geflecht- und Folienschirm
+- `Y` die Adernschirmung.
+  - **U** - ohne Schirm
+  - **F** - Folienschirm
+  - **S** - Geflechtschirm
+- `ZZ` die Verdrillung, eigentlich immer **TP** für *Twisted Pair*.
+
+### Beispiele
+
+#### UTP - *Unshielded Twisted Pair*
+
+UTP ist die verbreiteste Kabelart. UTP entspricht einem *Unshielded Twisted Pair*
+Kabel, also einem nicht abgeschirmten verwobenen Kabel. Solche Kabel können mit
+Bandbreiten bis zu 1 GBit/s arbeiten, entsprechend klassifizierbar bis CAT6.
+
+### S/UTP - *Screened, Unshielded Twisted Pair*
+
+Wie oben, jedoch ist die gesamte Kabelbündelung abgeschirmt mit einem Geflechtsstrang.
+
+### S/FTP - *Screened, Foliage-shielded Twisted Pair*
+
+![](img/extra/sftp-schema.png){height=3cm}
+
+Wie S/UTP, außer dass die Aderpaare zusätzlich von einer Folie umgeben sind.
+Dies entspricht unserem ENTROPA-Kabel.
+
+\clearpage
+
+# Steckerbelegungen
+
+Die Kabeladern müssen per einem vorgegebenen Standard mit Steckermodulen verbunden
+werden, um korrekt Daten zwischen zwei Netzwerkteilnehmern übertragen zu können.
+Die entsprechenden Standards sind in den EIA/TIA-568A und EIA/TIA-568B Normen
+niedergeschrieben. Festgelegt sind die exakten Kontaktbelegungen nach Farbe
+und Nummer.
+
+## EIA/TIA-568A
+
+Diese Norm ist die modernere der beiden Normen die von den drei Organisationen
+*Electronic Industries Alliance*, *Telecommunications Industry Association* und *International
+Telecommunications Union* kreiert wurde.
+
+![](img/odg/t568a.png){height=3.5cm}
+
+## EIA/TIA-568B
+
+In dieser Norm sind die grünen und orangenen Kabelpaare vertauscht. Diese Norm wurde von
+der zum Zeitpunkt der Definition der Normen bereits stark verbreiteten 258A-Norm
+übernommen.
+
+![](img/odg/t568b.png){height=3.5cm}
+
+\clearpage
+
+# LSA-Plus-Anschlusstechnik
+
+![](img/extra/lsa-anlegewerkzeug.jpg)
+
+Die Anschlusstechnik ist ein Verfahren zum Verbinden der einzelnen Adern mit
+Steckerverbindungen. Das Auflegen wird von einem dafür speziell gebauten 
+Gerät übernommen. Die **Plus**-Erweiterung beschreibt einen Schneidklemmenwinkel von 45° zum Kabel.
+
+Es werden mit einem speziellen Werkzeug, dem sogenannten Anlegewerkzeug, die Adern eines Kabels mitsamt Isolierung einzeln in eine so genannte Schneidklemme gepresst. Dabei wird durch das Werkzeug das überschüssige Aderende gekürzt und durch die scharfen Kontakte in der metallenen Schneidklemme die Isolierung der Ader durchtrennt und eine gasdichte, elektrische Verbindung hergestellt. Diese Verbindungstechnik funktioniert ohne Löten, Schrauben und Abisolieren, daher die Abkürzung.
+
+\clearpage
+
+# Montage der Patchdose
+
+![](img/photos/patchdose-offen.jpg)
+
+Mit den nun bekannten Informationen und Hilfsmitteln haben wir nun die Montage
+der Patchdose mit Verkabelung begonnen. Die Verkabelung findet per Norm EIA/TIA-568A statt.
+
+# Verbindung zum Patchpanel
+
+![](img/photos/patchpanel-anschluss-uebersicht.jpg){height=13cm}
+
+Folgende Ziele sollten erfüllt werden:
+
+- Die Abschirmung sollte möglichst weit bis zum Kabelende reichen ohne eine Störung zu verursachen
+- Bei der oberen Kabelklemme von den zwei verfügbaren sollte der Schirmstrang mitbefestigt werden.
+- Bei der unteren Kabelklemme sollte das Kabel samt Verkleidung befestigt werden.
+
+# Leitungsmessungen
+
+Nun, da die Leitungen in der Installation stehen, ist es Zeit, die Messungen
+durchzuführen. Wir haben für unser Projekt sowohl eine digitale Messung mit
+dem *KE7200* und eine analoge Messung mit der *Splitbox* und dem *FLUKE 175 Multimeter*
+durchgeführt.
+
+Zur Referenz, eine fehlerhafte Messung würde vom digitalen Messgerät wie folgt
+angezeigt werden:
+
+![](img/photos/kabeltest-digital-nok.jpg){height=5cm}
+
+Die Adern würden nicht parallel verlaufen und zu beiden Enden eine
+Verbindung haben.
+
+Und bei der analogen Messung würde der gemessene Widerstand der Leitung unendlich
+oder sehr hoch sein.
+
+![](img/photos/kabeltest-digital-ok.jpg){height=5cm}
+
+![](img/photos/kabeltest-analog-ok.jpg){height=5cm}
+
+Auf den ersten Versuch haben wir bei einer der beiden Patchdosen keine Probleme
+feststellen können, aber die zweite Patchdose hatte eine fehlerhafte Leitung,
+die durch eine nicht mit korrekten Abständen installierte Aderverbindung in der
+Patchdose verursacht wurde. Erst durch das Entfernen der Verbindung und der erneuten
+Einklemmung wurde das Problem behoben.
+
+Mit allen Steckern im funktionsfähigen Zustand können nun Verbindungen aufgebaut
+werden.
+
+\clearpage
+
+# Peer-to-Peer-Netz
+
+![](img/odg/peer-to-peer-verbindung.png){width=6cm}
+
+## Das Crossover-Kabel
+
+Für die Verbindung von zwei Rechnern wurde eigens ein normaler CAT6-Kabelabschnitt
+in ein Crossover-Kabel umgewandelt. Dafür kamen entsprechende RJ45-Stecker zum Einsatz,
+wobei an einem Ende die Leitung zum Senden und Empfangen von Nutzdaten vertauscht
+wurden. Exakterweise geschieht das durch Umtauschen der Belegung von jeweils Pinpaar
+1 und 3 und Pinpaar 2 und 6. Das Resultat ist auch eine Kabelbelegung nach Norm
+EIA/TIA-568B.
+
+![](img/odg/crossover.png){height=4.5cm}
+
+## Aufbau der Peer-to-Peer-Verbindung
+
+Zum Aufbauen einer Peer-to-Peer Verbindung werden die Anschlüsse an den Ports
+des Patchpanels, die mit den Ethernet-Ports der angeschlossenen Computer
+verbunden sind, mit einem Crossover-Kabel miteinander verbunden. Den Computern
+muss vom Nutzer manuell eine statische IP-Addresse zugewiesen werden. Beide
+IP-Addressen müssen dabei im gleichen Subnetz liegen, in diesem Beispiel wären
+das `192.168.1.1` und `192.168.1.2`, wobei das Subnetz zum Beispiel
+`192.168.1.0/24` ist.
+
+Die entsprechenden Einstellungen werden in den Netzwerkeinstellungen der
+Computer vorgenommen, zum Beispiel bei Windows 10 unter
+"Netzwerk- und Interneteinstellungen", dort "Netzwerk- und Freigabecenter"
+öffnen, "Adaptereinstellungen ändern" anklicken, per Rechtsklick den
+entsprechenden Ethernetadapter auswählen, "Eigenschaften" öffnen,
+"Internetprotokoll, Version 4 (TCP/IPv4)" dann "Eigenschaften" anklicken und im
+sich öffnenden Dialog kann dann auf eine statische IP-Addresse umgestellt werden.
+
+![](img/screenshots/windows-ipv4-einstellungen.png){width=6cm}
+
+## Ergebnis
+
+Die Peers im Netz können sich gegenseitig mit Ping Anfragen und Antworten
+schicken:
+
+![](img/photos/crossover-ping-bidi.jpg)
+
+Genauso funktioniert das verschicken von anderen Anfragen, hier zum Beispiel
+vom Windows-Laptop zu einem Webserver der auf dem Linux-Laptop für diesen
+Zweck aufgesetzt wurde:
+
+![](img/photos/crossover-browser.jpg)
+
+\clearpage
+
+# Client-Server-Netz
+
+![](img/odg/client-server-verbindung.png){height=10cm}
+
+Dieses Netz konnte mit einfachen Kabeln die bereits von der Schule zur Verfügung
+gestellt wurden (alle CAT6) realisiert werden. Zusätzlich wurde ein ZyXEL-Router
+zur Verfügung gestellt, das an ein existierendes geroutetes Netz der Schule
+angeschlossen wurde.
+
+## Aufbau der Verbindung zum Router
+
+Die Konfiguration der teilnehmenden Netzwerkgeräte war einfach zu bewerkstelligen.
+Der Router selbst richtet selbständig ein neues LAN-Netz ein mit eigenem Subnetz
+und eigenem DHCP-Server, der Addressen in diesem Netz vergibt. Die Clients wurden
+auf ihre Standardeinstellungen zurückgestellt, denn diese definieren, dass automatisch
+IP-Addressen ausgehandelt werden mit eben diesem DHCP-Server.
+
+\clearpage
+
+## Ergebnis
+
+Die Clients können erfolgreich die Google-DNS-Serveraddresse im Internet anpingen:
+
+![](img/photos/internet-ping-google.jpg){width=8cm}
+
+Websites können ebenfalls ohne Probleme aufgerufen werden.
+
+![](img/photos/internet-frontansicht.jpg)
+
+\clearpage
+
+# Zeitplanung
+
+| Tätigkeit/Aufgabe | Dauer (h) |
+| --- | --- |
+| Planung | 1 |
+| Montage von 2 CAT 6a-Datendosen mit je zwei RJ-45-Buchsen | 3 |
+| Montage eines 6-Port-Patchpanels | 2 |
+| Montage von zwei AMJ-S CAT6a Modulen | 1,5 |
+| Herstellen von 2 Crossover-Kabeln (1 GBit/s) | 2,5 |
+| Einrichten eines Peer-to-Peer-Netzwerks mit zwei Notebooks | 1 |
+| Einrichten eines Internetzugangs mit Switch und Router | 0,5 |
+| Qualitätsprüfung | 0,5 |
+| | |
+| **Gesamt** | **12** |
+
+# Kostenrechnung
+
+| Bezeichnung | Menge | Einzelpreis | Gesamtpreis |
+| --- | --- | --- | --- |
+| CAT7 Netzwerkkabel (m) | 7 | 1,50€ | 10,50€ |
+| AMJ-S Modul CAT6A T568A | 2 | 13,90€ | 27,80€ |
+| RJ45-Stecker, CAT6 STP geschirmt | 6 | 1,50€ | 9,00€ |
+| 6-Port-Patchpanel | 1 | 20,00€ | 20,00€ |
+| Datendosen Klasse E | 3 | 10,00€ | 30,00€ |
+| Kabelkanal (m) | 1,5 | 17,00€ | 25,50€ |
+| Arbeitszeit (h) | 24 | 80,00€ | 1.920,00€ |
+| | | | |
+| **Gesamt** | | | **2.042,80€** |
+
+\clearpage
+
+# Quellenangaben
+
+Alle Quellen wurden zuletzt abgerufen am 20. März 2018.
+
+- Seite "Was bedeutet Peer-to-Peer?". In: XOVI Handbuch <https://www.xovi.de/wiki/Peer-to-Peer>.
+- Seite "Peer-to-Peer". In: Wikipedia, Die freie Enzyklopädie. URL: <https://de.wikipedia.org/w/index.php?title=Peer-to-Peer&oldid=175021101>
+- Seite "Twisted-Pair-Kabel". In: Wikipedia, Die freie Enzyklopädie. URL: <https://de.wikipedia.org/wiki/Twisted-Pair-Kabel#Kategorien>
+- Seite "TIA-568A/B". In: Wikipedia, Die freie Enzyklopädie. URL: <https://de.wikipedia.org/wiki/TIA-568A/B>
+- Seite "LSA-Anschlusstechnik". In: reicheltpedia, Das Wiki für Elektronik. URL: <https://www.reichelt.de/reicheltpedia/index.php/LSA-Anschlusstechnik>
+- LSA Auflegewerkzeug Anlegewerkzeug. URL: <https://www.zaehlerschrank24.de/lsa-auflegewerkzeug-anlegewerkzeug.html>.
+- Bild STP-Kabel.svg, Original: Uwe Schwöbel, GFDL, https://commons.wikimedia.org/w/index.php?curid=12055895
+- Hauser, Bernhard: Fachwissen Netzwerktechnik. Modelle, Geräte, Protokolle. Verlag Europa-Lehrmittel.

Makefile

@@ -0,0 +1,75 @@
+PANDOC = pandoc
+LATEX = lualatex
+LATEX_FLAGS = \
+	-file-line-error \
+	-recorder \
+	-interaction=nonstopmode \
+	-halt-on-error \
+	--shell-escape
+PANDOC_FLAGS = --top-level-division=section
+PANDOC_TEX_FLAGS = --template=template.tex
+PANDOC_TEX_DEPENDENCIES = template.tex
+SOFFICE = soffice
+SOFFICE_FLAGS = --headless
+INKSCAPE = inkscape
+INKSCAPE_FLAGS = 
+
+MARKDOWN_INPUTS = $(wildcard *.md)
+
+ODG_INPUTS = $(wildcard img/*/*.odg)
+
+.PHONY: all clean clean-pdf clean-tex clean-svg clean-png all-pdf all-tex all-svg all-png default
+
+TEXINPUTS := .:./pkg/:$(TEXINPUTS)
+export TEXINPUTS
+
+default: all
+
+all: all-tex all-svg all-png all-pdf
+
+all-svg: $(addsuffix .svg,$(basename $(ODG_INPUTS)))
+
+all-png: $(addsuffix .png,$(basename $(ODG_INPUTS)))
+
+all-tex: $(addsuffix .tex,$(basename $(MARKDOWN_INPUTS)))
+
+all-pdf: $(addsuffix .pdf,$(basename $(MARKDOWN_INPUTS)))
+
+clean: clean-pdf clean-tex clean-svg clean-png
+
+clean-svg:
+	rm -f $(addsuffix .svg,$(basename $(ODG_INPUTS)))
+
+clean-png:
+	rm -f $(addsuffix .png,$(basename $(ODG_INPUTS)))
+
+clean-tex:
+	rm -f $(addsuffix .tex,$(basename $(MARKDOWN_INPUTS)))
+
+clean-pdf:
+	rm -f \
+		$(addsuffix .aux,$(basename $(MARKDOWN_INPUTS))) \
+		$(addsuffix .pdf,$(basename $(MARKDOWN_INPUTS))) \
+		$(addsuffix .out,$(basename $(MARKDOWN_INPUTS))) \
+		$(addsuffix .fls,$(basename $(MARKDOWN_INPUTS))) \
+		$(addsuffix .log,$(basename $(MARKDOWN_INPUTS))) \
+		$(addsuffix .toc,$(basename $(MARKDOWN_INPUTS))) \
+		missfont.log
+
+%.svg: %.odg
+	@echo $< "->" $@
+	$(SOFFICE) $(SOFFICE_FLAGS) --draw --convert-to svg:draw_svg_Export \
+		--outdir $(dir $<) $<
+
+%.png: %.svg
+	@echo $< "->" $@
+	$(INKSCAPE) $(INKSCAPE_FLAGS) -D -z -e $@ -d 900 $<
+
+%.pdf: %.tex all-svg $(PANDOC_TEX_DEPENDENCIES)
+	@echo $< "->" $@
+	$(LATEX) $(LATEX_FLAGS) $(LATEX_PDF_FLAGS) $< 1>/dev/null
+	$(LATEX) $(LATEX_FLAGS) $(LATEX_PDF_FLAGS) $< 1>/dev/null
+
+%.tex: %.md
+	@echo $< "->" $@
+	$(PANDOC) $(PANDOC_FLAGS) $(PANDOC_TEX_FLAGS) --listings -s $< -o $@

fonts/Carlito/LICENSE

@@ -0,0 +1,95 @@
+Copyright (c) 2010-2013 by tyPoland Lukasz Dziedzic with Reserved Font Name "Carlito".
+
+This Font Software is licensed under the SIL Open Font License,
+Version 1.1 as shown below.
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+
+PREAMBLE The goals of the Open Font License (OFL) are to stimulate
+worldwide development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to provide
+a free and open framework in which fonts may be shared and improved in
+partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves.
+The fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works.  The fonts and derivatives,
+however, cannot be released under any other type of license.  The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such.
+This may include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components
+as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting ? in part or in whole ?
+any of the components of the Original Version, by changing formats or
+by porting the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer
+or other person who contributed to the Font Software.
+
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,in
+   Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+   redistributed and/or sold with any software, provided that each copy
+   contains the above copyright notice and this license. These can be
+   included either as stand-alone text files, human-readable headers or
+   in the appropriate machine-readable metadata fields within text or
+   binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+   Name(s) unless explicit written permission is granted by the
+   corresponding Copyright Holder. This restriction only applies to the
+   primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+   Software shall not be used to promote, endorse or advertise any
+   Modified Version, except to acknowledge the contribution(s) of the
+   Copyright Holder(s) and the Author(s) or with their explicit written
+   permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must
+   be distributed entirely under this license, and must not be distributed
+   under any other license. The requirement for fonts to remain under
+   this license does not apply to any document created using the Font
+   Software.
+
+
+ 
+TERMINATION
+This license becomes null and void if any of the above conditions are not met.
+
+ 
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT.  IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
+DEALINGS IN THE FONT SOFTWARE.
+

fonts/IBMPlexMono/OFL.txt

@@ -0,0 +1,93 @@
+Copyright © 2017 IBM Corp. with Reserved Font Name "Plex"
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

img/.gitignore

@@ -0,0 +1,3 @@
+# Images generated by LibreOffice Draw
+odg/*.png
+odg/*.svg

img/computer.svg

@@ -0,0 +1 @@
+<?xml version="1.0" ?><!DOCTYPE svg  PUBLIC '-//W3C//DTD SVG 1.1//EN'  'http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd'><svg enable-background="new 0 0 141.732 141.732" height="141.732px" id="Livello_1" version="1.1" viewBox="0 0 141.732 141.732" width="141.732px" xml:space="preserve" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><g id="Livello_11"><path d="M92.015,63.895H3.68V4.124h88.335V63.895z M95.696,65.76L95.696,65.76V2.258c0-1.036-0.823-1.868-1.839-1.868H1.84   C0.824,0.391,0,1.223,0,2.258V65.76c0,1.033,0.825,1.867,1.84,1.867h34.967v11.208H22.084c-1.017,0-1.839,0.834-1.839,1.868   c0,1.031,0.824,1.868,1.839,1.868h0.001h51.528c1.017,0,1.841-0.837,1.841-1.868c0-1.034-0.825-1.868-1.841-1.868H58.89V67.627   h34.968C94.875,67.627,95.696,66.792,95.696,65.76 M138.915,29.489H109.86v-5.898h29.055V29.489z M138.915,17.695H109.86v-5.9   h29.055V17.695z M122.098,53.278c0-1.286,1.027-2.324,2.29-2.324c1.265,0,2.293,1.038,2.293,2.324c0,1.285-1.028,2.326-2.293,2.326   C123.126,55.604,122.098,54.562,122.098,53.278 M122.665,60.033c0-0.966,0.771-1.749,1.723-1.749c0.953,0,1.725,0.782,1.725,1.749   c0,0.968-0.772,1.754-1.725,1.754C123.436,61.786,122.665,61.001,122.665,60.033 M141.825,79.621V2.948   c0-1.628-1.302-2.949-2.908-2.949h-29.054c-1.604,0-2.905,1.324-2.905,2.949v76.672c0,1.63,1.301,2.949,2.905,2.949h29.054   C140.522,82.57,141.825,81.251,141.825,79.621"/></g><g id="Livello_1_1_"/></svg>

template.tex

@@ -0,0 +1,415 @@
+\PassOptionsToPackage{unicode=true}{hyperref} % options for packages loaded elsewhere
+\PassOptionsToPackage{hyphens}{url}
+$if(colorlinks)$
+\PassOptionsToPackage{dvipsnames,svgnames*,x11names*}{xcolor}
+$endif$
+%
+\documentclass[$if(fontsize)$$fontsize$,$endif$$if(lang)$$babel-lang$,$endif$$if(papersize)$$papersize$paper,$endif$$if(beamer)$ignorenonframetext,$if(handout)$handout,$endif$$if(aspectratio)$aspectratio=$aspectratio$,$endif$$endif$$for(classoption)$$classoption$$sep$,$endfor$]{$documentclass$}
+$if(beamer)$
+\setbeamertemplate{caption}[numbered]
+\setbeamertemplate{caption label separator}{: }
+\setbeamercolor{caption name}{fg=normal text.fg}
+\beamertemplatenavigationsymbols$if(navigation)$$navigation$$else$empty$endif$
+$endif$
+$if(beamerarticle)$
+\usepackage{beamerarticle} % needs to be loaded first
+$endif$
+$if(fontfamily)$
+\usepackage[$for(fontfamilyoptions)$$fontfamilyoptions$$sep$,$endfor$]{$fontfamily$}
+$else$
+\usepackage{lmodern}
+$endif$
+$if(linestretch)$
+\usepackage{setspace}
+\setstretch{$linestretch$}
+$endif$
+\usepackage{amssymb,amsmath}
+\usepackage{ifxetex,ifluatex}
+\usepackage{fixltx2e} % provides \textsubscript
+\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
+  \usepackage[$if(fontenc)$$fontenc$$else$T1$endif$]{fontenc}
+  \usepackage[utf8]{inputenc}
+  \usepackage{textcomp} % provides euro and other symbols
+\else % if luatex or xelatex
+$if(mathspec)$
+  \ifxetex
+    \usepackage{mathspec}
+  \else
+    \usepackage{unicode-math}
+  \fi
+$else$
+  \usepackage{unicode-math}
+$endif$
+  \defaultfontfeatures{Ligatures=TeX,Scale=MatchLowercase}
+$for(fontfamilies)$
+  \newfontfamily{$fontfamilies.name$}[$fontfamilies.options$]{$fontfamilies.font$}
+$endfor$
+$if(mainfont)$
+    \setmainfont$if(mainfontoptions)$[$for(mainfontoptions)$$mainfontoptions$$sep$,$endfor$]$endif${$mainfont$}
+$endif$
+$if(sansfont)$
+    \setsansfont$if(sansfontoptions)$[$for(sansfontoptions)$$sansfontoptions$$sep$,$endfor$]$endif${$sansfont$}
+$endif$
+$if(monofont)$
+    \setmonofont[Mapping=tex-ansi$if(monofontoptions)$,$for(monofontoptions)$$monofontoptions$$sep$,$endfor$$endif$]{$monofont$}
+$endif$
+$if(mathfont)$
+$if(mathspec)$
+  \ifxetex
+    \setmathfont(Digits,Latin,Greek)[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
+  \else
+    \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
+  \fi
+$else$
+  \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
+$endif$
+$endif$
+$if(CJKmainfont)$
+  \ifxetex
+    \usepackage{xeCJK}
+    \setCJKmainfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
+  \fi
+$endif$
+$if(luatexjapresetoptions)$
+  \ifluatex
+    \usepackage[$for(luatexjapresetoptions)$$luatexjapresetoptions$$sep$,$endfor$]{luatexja-preset}
+  \fi
+$endif$
+$if(CJKmainfont)$
+  \ifluatex
+    \usepackage[$for(luatexjafontspecoptions)$$luatexjafontspecoptions$$sep$,$endfor$]{luatexja-fontspec}
+    \setmainjfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
+  \fi
+$endif$
+\fi
+$if(beamer)$
+$if(theme)$
+\usetheme[$for(themeoptions)$$themeoptions$$sep$,$endfor$]{$theme$}
+$endif$
+$if(colortheme)$
+\usecolortheme{$colortheme$}
+$endif$
+$if(fonttheme)$
+\usefonttheme{$fonttheme$}
+$endif$
+$if(mainfont)$
+\usefonttheme{serif} % use mainfont rather than sansfont for slide text
+$endif$
+$if(innertheme)$
+\useinnertheme{$innertheme$}
+$endif$
+$if(outertheme)$
+\useoutertheme{$outertheme$}
+$endif$
+$endif$
+% use upquote if available, for straight quotes in verbatim environments
+\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
+% use microtype if available
+\IfFileExists{microtype.sty}{%
+\usepackage[$for(microtypeoptions)$$microtypeoptions$$sep$,$endfor$]{microtype}
+\UseMicrotypeSet[protrusion]{basicmath} % disable protrusion for tt fonts
+}{}
+$if(indent)$
+$else$
+\IfFileExists{parskip.sty}{%
+\usepackage{parskip}
+}{% else
+\setlength{\parindent}{0pt}
+\setlength{\parskip}{6pt plus 2pt minus 1pt}
+}
+$endif$
+$if(verbatim-in-note)$
+\usepackage{fancyvrb}
+$endif$
+$if(colorlinks)$
+\usepackage{xcolor}
+$endif$
+\usepackage{hyperref}
+\hypersetup{
+$if(title-meta)$
+            pdftitle={$title-meta$},
+$endif$
+$if(author-meta)$
+            pdfauthor={$author-meta$},
+$endif$
+$if(keywords)$
+            pdfkeywords={$for(keywords)$$keywords$$sep$, $endfor$},
+$endif$
+$if(colorlinks)$
+            colorlinks=true,
+            linkcolor=$if(linkcolor)$$linkcolor$$else$Maroon$endif$,
+            citecolor=$if(citecolor)$$citecolor$$else$Blue$endif$,
+            urlcolor=$if(urlcolor)$$urlcolor$$else$Blue$endif$,
+$else$
+            pdfborder={0 0 0},
+$endif$
+            breaklinks=true}
+\urlstyle{same}  % don't use monospace font for urls
+$if(verbatim-in-note)$
+\VerbatimFootnotes % allows verbatim text in footnotes
+$endif$
+$if(geometry)$
+\usepackage[$for(geometry)$$geometry$$sep$,$endfor$]{geometry}
+$endif$
+$if(beamer)$
+\newif\ifbibliography
+$endif$
+$if(listings)$
+\usepackage{listings}
+\newcommand{\passthrough}[1]{#1}
+$endif$
+$if(lhs)$
+\lstnewenvironment{code}{\lstset{language=Haskell,basicstyle=\small\ttfamily}}{}
+$endif$
+$if(highlighting-macros)$
+$highlighting-macros$
+$endif$
+$if(tables)$
+\usepackage{longtable,booktabs}
+$if(beamer)$
+\usepackage{caption}
+% These lines are needed to make table captions work with longtable:
+\makeatletter
+\def\fnum@table{\tablename~\thetable}
+\makeatother
+$else$
+% Fix footnotes in tables (requires footnote package)
+\IfFileExists{footnote.sty}{\usepackage{footnote}\makesavenoteenv{longtable}}{}
+$endif$
+$endif$
+$if(graphics)$
+\usepackage{graphicx,grffile}
+\makeatletter
+\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
+\def\maxheight{\ifdim\Gin@nat@height>\textheight\textheight\else\Gin@nat@height\fi}
+\makeatother
+% Scale images if necessary, so that they will not overflow the page
+% margins by default, and it is still possible to overwrite the defaults
+% using explicit options in \includegraphics[width, height, ...]{}
+\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
+$endif$
+$if(beamer)$
+% Prevent slide breaks in the middle of a paragraph:
+\widowpenalties 1 10000
+\raggedbottom
+$if(section-titles)$
+\setbeamertemplate{part page}{
+\centering
+\begin{beamercolorbox}[sep=16pt,center]{part title}
+  \usebeamerfont{part title}\insertpart\par
+\end{beamercolorbox}
+}
+\setbeamertemplate{section page}{
+\centering
+\begin{beamercolorbox}[sep=12pt,center]{part title}
+  \usebeamerfont{section title}\insertsection\par
+\end{beamercolorbox}
+}
+\setbeamertemplate{subsection page}{
+\centering
+\begin{beamercolorbox}[sep=8pt,center]{part title}
+  \usebeamerfont{subsection title}\insertsubsection\par
+\end{beamercolorbox}
+}
+\AtBeginPart{
+  \frame{\partpage}
+}
+\AtBeginSection{
+  \ifbibliography
+  \else
+    \frame{\sectionpage}
+  \fi
+}
+\AtBeginSubsection{
+  \frame{\subsectionpage}
+}
+$endif$
+$endif$
+$if(links-as-notes)$
+% Make links footnotes instead of hotlinks:
+\DeclareRobustCommand{\href}[2]{#2\footnote{\url{#1}}}
+$endif$
+$if(strikeout)$
+\usepackage[normalem]{ulem}
+% avoid problems with \sout in headers with hyperref:
+\pdfstringdefDisableCommands{\renewcommand{\sout}{}}
+$endif$
+\setlength{\emergencystretch}{3em}  % prevent overfull lines
+\providecommand{\tightlist}{%
+  \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+$if(numbersections)$
+\setcounter{secnumdepth}{$if(secnumdepth)$$secnumdepth$$else$5$endif$}
+$else$
+\setcounter{secnumdepth}{0}
+$endif$
+$if(beamer)$
+$else$
+$if(subparagraph)$
+$else$
+% Redefines (sub)paragraphs to behave more like sections
+\ifx\paragraph\undefined\else
+\let\oldparagraph\paragraph
+\renewcommand{\paragraph}[1]{\oldparagraph{#1}\mbox{}}
+\fi
+\ifx\subparagraph\undefined\else
+\let\oldsubparagraph\subparagraph
+\renewcommand{\subparagraph}[1]{\oldsubparagraph{#1}\mbox{}}
+\fi
+$endif$
+$endif$
+$if(pagestyle)$
+\pagestyle{$pagestyle$}
+$endif$
+
+% set default figure placement to htbp
+\makeatletter
+\def\fps@figure{htbp}
+\makeatother
+
+$for(header-includes)$
+$header-includes$
+$endfor$
+$if(lang)$
+%\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
+  \usepackage[shorthands=off,$for(babel-otherlangs)$$babel-otherlangs$,$endfor$main=$babel-lang$]{babel}
+$if(babel-newcommands)$
+  $babel-newcommands$
+$endif$
+%\else
+%  % load polyglossia as late as possible as it *could* call bidi if RTL lang (e.g. Hebrew or Arabic)
+%  \usepackage{polyglossia}
+%  \setmainlanguage[$polyglossia-lang.options$]{$polyglossia-lang.name$}
+$for(polyglossia-otherlangs)$
+%  \setotherlanguage[$polyglossia-otherlangs.options$]{$polyglossia-otherlangs.name$}
+$endfor$
+%\fi
+$endif$
+$if(dir)$
+\ifxetex
+  % load bidi as late as possible as it modifies e.g. graphicx
+  $if(latex-dir-rtl)$
+  \usepackage[RTLdocument]{bidi}
+  $else$
+  \usepackage{bidi}
+  $endif$
+\fi
+\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
+  \TeXXeTstate=1
+  \newcommand{\RL}[1]{\beginR #1\endR}
+  \newcommand{\LR}[1]{\beginL #1\endL}
+  \newenvironment{RTL}{\beginR}{\endR}
+  \newenvironment{LTR}{\beginL}{\endL}
+\fi
+$endif$
+$if(natbib)$
+\usepackage[$natbiboptions$]{natbib}
+\bibliographystyle{$if(biblio-style)$$biblio-style$$else$plainnat$endif$}
+$endif$
+$if(biblatex)$
+\usepackage[$if(biblio-style)$style=$biblio-style$,$endif$$for(biblatexoptions)$$biblatexoptions$$sep$,$endfor$]{biblatex}
+$for(bibliography)$
+\addbibresource{$bibliography$}
+$endfor$
+$endif$
+
+$if(title)$
+\title{$title$$if(thanks)$\thanks{$thanks$}$endif$}
+$endif$
+$if(subtitle)$
+\providecommand{\subtitle}[1]{}
+\subtitle{$subtitle$}
+$endif$
+$if(author)$
+\author{$for(author)$$author$$sep$ \and $endfor$}
+$endif$
+$if(institute)$
+\providecommand{\institute}[1]{}
+\institute{$for(institute)$$institute$$sep$ \and $endfor$}
+$endif$
+\date{$date$}
+$if(beamer)$
+$if(titlegraphic)$
+\titlegraphic{\includegraphics{$titlegraphic$}}
+$endif$
+$if(logo)$
+\logo{\includegraphics{$logo$}}
+$endif$
+$endif$
+
+\begin{document}
+$if(title)$
+$if(beamer)$
+\frame{\titlepage}
+$else$
+\maketitle
+$endif$
+$if(abstract)$
+\begin{abstract}
+$abstract$
+\end{abstract}
+$endif$
+$endif$
+
+$for(include-before)$
+$include-before$
+
+$endfor$
+$if(toc)$
+$if(beamer)$
+\begin{frame}
+\tableofcontents[hideallsubsections]
+\end{frame}
+$else$
+{
+$if(colorlinks)$
+\hypersetup{linkcolor=$if(toccolor)$$toccolor$$else$$endif$}
+$endif$
+\setcounter{tocdepth}{$toc-depth$}
+\tableofcontents
+}
+$endif$
+$endif$
+$if(lot)$
+\listoftables
+$endif$
+$if(lof)$
+\listoffigures
+$endif$
+$body$
+
+$if(natbib)$
+$if(bibliography)$
+$if(biblio-title)$
+$if(book-class)$
+\renewcommand\bibname{$biblio-title$}
+$else$
+\renewcommand\refname{$biblio-title$}
+$endif$
+$endif$
+$if(beamer)$
+\begin{frame}[allowframebreaks]{$biblio-title$}
+\bibliographytrue
+$endif$
+\bibliography{$for(bibliography)$$bibliography$$sep$,$endfor$}
+$if(beamer)$
+\end{frame}
+$endif$
+
+$endif$
+$endif$
+$if(biblatex)$
+$if(beamer)$
+\begin{frame}[allowframebreaks]{$biblio-title$}
+\bibliographytrue
+\printbibliography[heading=none]
+\end{frame}
+$else$
+\printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$
+$endif$
+
+$endif$
+$for(include-after)$
+$include-after$
+
+$endfor$
+\end{document}