Erstellen der PDF-Datei funktioniert

.gitignore

 *~
 /resources/
 /public/
+/temp/
+/parts/pages_impressum.md
+/parts/latex_impressum.md
+/template/metadata.yml
+/leitfaden-opendata.pdf
+/content/_index.md

Makefile

+.PHONY: pdf
+pdf: clean temp/date.txt parts/latex_impressum.md | temp
+	@echo "generate metadata ..."
+	@ruby bin/include_markdown.rb -s txt -f temp -p template/metadata_yml.template > template/metadata.yml
+	@echo "combining parts ..."
+	@cat parts/latex_preamble.md leitfaden-opendata.md parts/latex_impressum.md > temp/pdf_source.md
+	@echo "replacing <br/> with double space ..."
+	@sed 's:<br/>:  :g' temp/pdf_source.md > temp/leitfaden-opendata_01.md
+	@echo "remove gfm image widths and centering ..."
+	@sed -e 's:{\:width=".*px"}::' temp/leitfaden-opendata_01.md | sed -e 's:{\: .centered }::' > temp/leitfaden-opendata_02.md
+	@echo "include markdown snippets ..."
+	@ruby bin/include_markdown.rb -p temp/leitfaden-opendata_02.md -s pandoc > temp/leitfaden-opendata_03.md
+	@echo "rewrite link targets ..."
+	@sed -E 's/@linktarget\(([^)]+)\)/\\hypertarget{\1}{\1}/' temp/leitfaden-opendata_03.md > temp/leitfaden-opendata_04.md
+	@echo "rewrite links ..."
+	@sed -E 's/@link\(([^)]+)\)/\\hyperlink{\1}{\1}/g' temp/leitfaden-opendata_04.md > temp/leitfaden-opendata_05.md
+	@echo "replacing star characters ..."
+	@sed -E 's/★/$$\\star$$/g' temp/leitfaden-opendata_05.md > temp/leitfaden-opendata_06.md
+	@echo "creating pdf ..."
+	@pandoc --listings -H template/listings-setup.tex -V lang=de --template=template/default.latex --variable urlcolor=cyan temp/leitfaden-opendata_06.md template/metadata.yml --pdf-engine=pdflatex --toc --resource-path=static -o temp/ergebnis.pdf
+	@echo "adding title page"
+	@pdfunite titelblatt.pdf temp/ergebnis.pdf leitfaden-opendata.pdf
+
+.PHONY: indesign
+indesign: clean temp/leitfaden-opendata.nolatex.md | temp
+	@echo "replacing <br/> with double space ..."
+	@sed 's:<br/>:  :g' temp/leitfaden-opendata.nolatex.md > temp/leitfaden-opendata.nolatex_01.md
+	@echo "creating indesign file ..."
+	@pandoc temp/leitfaden-opendata.nolatex_01.md -s -o leitfaden-opendata.icml
+
+.PHONY: web
+web: clean static/images/fluss.png parts/pages_impressum.md | temp
+	@echo "combining parts ..."
+	@cat leitfaden-opendata.md parts/pages_impressum.md > temp/leitfaden-opendata_01.md
+	@echo "move headers one level down ..."
+	@sed 's/^#/##/' temp/leitfaden-opendata_01.md > temp/leitfaden-opendata_01b.md
+	@echo "rewrite header anchors ..."
+	@sed -E 's/^(#+ )(.+) \{#(.+)\}$$/\1<a id="\3">\2<\/a>/' temp/leitfaden-opendata_01b.md > temp/leitfaden-opendata_02.md
+	@echo "rewrite image references ..."
+	@sed -e 's: (s\. Abb\.&nbsp;\\ref{fig\:.*}): (s. Abbildung):' temp/leitfaden-opendata_02.md > temp/leitfaden-opendata_03.md
+	@echo "remove image labels ..."
+	@sed -e 's:\\label{fig\:.*}]:]:' temp/leitfaden-opendata_03.md > temp/leitfaden-opendata_04.md
+	@echo "remove pdf image widths ..."
+	@sed -e 's:{width=.*px}::' temp/leitfaden-opendata_04.md > temp/leitfaden-opendata_05.md
+	@echo "remove pdf image heights ..."
+	@sed -e 's:{height=.*}::' temp/leitfaden-opendata_05.md > temp/leitfaden-opendata_06.md
+	@echo "remove suppress numbering commands from headings ..."
+	@sed -e 's: {-}::' temp/leitfaden-opendata_06.md > temp/leitfaden-opendata_07.md
+	@echo "include markdown snippets ..."
+	@ruby bin/include_markdown.rb -p temp/leitfaden-opendata_07.md -s gfm > temp/leitfaden-opendata_08.md
+	@echo "join header parts of multiline tables ..."
+	@sed 's:\\_ :\\_:g' temp/leitfaden-opendata_08.md > temp/leitfaden-opendata_09.md
+	@echo "rewrite link targets ..."
+	@sed -E 's/@linktarget\(([^)]+)\)/<a name="\1">\1<\/a>/' temp/leitfaden-opendata_09.md > temp/leitfaden-opendata_10.md
+	@echo "rewrite links ..."
+	@sed -E 's/@link\(([^)]+)\)/[\1](#\1)/g' temp/leitfaden-opendata_10.md > temp/leitfaden-opendata_11.md
+	@echo "unescape at-signs ..."
+	@sed 's/\\@/@/' temp/leitfaden-opendata_11.md > temp/leitfaden-opendata_12.md
+	@echo "add title matter ..."
+	@cat parts/pages_title.md temp/leitfaden-opendata_12.md > content/_index.md
+
+.PHONY: temp/leitfaden-opendata.nolatex.md
+temp/leitfaden-opendata.nolatex.md: | temp
+	@echo "removing latex commands ..."
+	@grep -e "^\\\\" -v leitfaden-opendata.md > temp/leitfaden-opendata.nolatex.md
+
+.PHONY: temp/images.csv
+temp/images.csv: | temp
+	@echo "extracting images from markdown ..."
+	@echo "path,Title,Description" > temp/images.csv
+	@grep '!\[' leitfaden-opendata.md | sed -E 's/^!\[(.+)\\label\{fig.+}\]\((.+) (".+")\).*$$/"\2","\1",\3/' >> temp/images.csv
+
+images/format-example-tree.png: images/format-example-tree.pdf
+	@echo "converting images/format-example-tree.pdf ..."
+	@automator -i images/format-example-tree.pdf -D OUTPATH=images bin/pdf2png.workflow
+
+images/metadaten_daten.png: images/metadaten_daten.pdf
+	@echo "converting images/metadaten_daten.pdf ..."
+	@automator -i images/metadaten_daten.pdf -D OUTPATH=images bin/pdf2png.workflow
+
+images/offene_daten_uebersicht.png: images/offene_daten_uebersicht.pdf
+	@echo "converting images/offene_daten_uebersicht.pdf ..."
+	@automator -i images/offene_daten_uebersicht.pdf -D OUTPATH=images bin/pdf2png.workflow
+
+images/output_datenrubrik.png: images/output_datenrubrik.pdf
+	@echo "converting images/output_datenrubrik.pdf ..."
+	@automator -i images/output_datenrubrik.pdf -D OUTPATH=images bin/pdf2png.workflow
+
+images/output_simplesearch.png: images/output_simplesearch.pdf
+	@echo "converting images/output_simplesearch.pdf ..."
+	@automator -i images/output_simplesearch.pdf -D OUTPATH=images bin/pdf2png.workflow
+
+images/schritt-für-schritt.png: images/schritt-für-schritt.pdf
+	@echo "converting images/schritt-für-schritt.pdf ..."
+	@automator -i images/schritt-für-schritt.pdf -D OUTPATH=images bin/pdf2png.workflow
+
+images/veroeffentlichungsweg_waehlen.png: images/veroeffentlichungsweg_waehlen.pdf
+	@echo "converting images/veroeffentlichungsweg_waehlen.pdf ..."
+	@automator -i images/veroeffentlichungsweg_waehlen.pdf -D OUTPATH=images bin/pdf2png.workflow
+
+parts/example_tabular_data.gfm: parts/example_tabular_data.pandoc
+	@echo "converting parts/example_tabular_data.pandoc to gfm ..."
+	@pandoc --to=gfm parts/example_tabular_data.pandoc > parts/example_tabular_data.gfm
+
+parts/pages_impressum.md: temp/date.txt
+	@echo "generate impressum ..."
+	@ruby bin/include_markdown.rb -s txt -f temp -p parts/pages_impressum.template.md > parts/pages_impressum.md
+
+parts/latex_impressum.md: temp/date.txt
+	@echo "generate impressum ..."
+	@ruby bin/include_markdown.rb -s txt -f temp -p parts/latex_impressum.template.md > $@
+
+.PHONY: temp/date.txt
+temp/date.txt: | temp
+	@echo "write current date ..."
+	@date "+%Y-%m-%d" > temp/date.txt
+
+.PHONY: clean
+clean: 
+	@echo "emptying temp folder ..."
+	@rm -rf temp
+
+.PHONY: serve-web
+serve-web: web
+	@echo "serving local version of online handbook ..."
+	@hugo serve serve
+
+temp:
+	@echo "creating temp directory ..."
+	@mkdir -p temp

bin/include_markdown.rb

+#! /usr/bin/env ruby
+
+require 'optparse'
+
+options = {
+    :parent_file => "index.md" ,
+    :parts_folder => "parts" ,
+    :suffix => "pandoc"
+}
+usage = "ruby include_markdown.rb [options]"
+
+OptionParser.new do |opts|
+    opts.banner = usage
+    opts.separator ""
+    opts.separator "Options:"
+  
+    opts.on("-p", "--parentfile STRING", String, "Path to the file in which snippets are to be included. Default is 'index.md'.") do |parentfile|
+      options[:parent_file] = parentfile
+    end
+
+    opts.on("-f", "--folder STRING", String, "Path to the folder containing snippets to be included. Default is 'parts'.") do |parts_folder|
+      options[:parts_folder] = parts_folder
+    end
+  
+    opts.on("-s", "--suffix STRING", String, "Suffix of the markdown files to be included. Default is 'pandoc'.") do |suffix|
+      options[:suffix] = suffix
+    end
+      
+end.parse!
+
+text = File.read(options[:parent_file])
+
+text.gsub!(/\@include\(([^)]+?)\)/) do |include_statement|
+    replacement_path = File.join(options[:parts_folder], "#{$1}.#{options[:suffix]}")
+    File.read(replacement_path)
+end
+
+puts text

parts/box_prefix.gfm

+<div class="bo-box">

parts/box_prefix.pandoc

+
+---
+

parts/box_suffix.gfm

+</div>

parts/box_suffix.pandoc

+
+---
+

parts/latex_impressum.template.md

+# Impressum {-}
+
+**Herausgeber:** Land Schleswig-Holstein<br>
+**Lizenz**: Der Text des Handbuchs ist unter einer <a href="https://creativecommons.org/licenses/by/4.0/deed.de">Creative Commons Namensnennung 4.0 International Lizenz</a> (CC BY 4.0) veröffentlicht.
+Bilder und andere Elemente, deren Urheberrecht bei Dritten liegen, sind ausgenommen.
+<a href="#quellenverzeichnis">Quellenverzeichnis</a> und <a href="#bildverzeichnis">Bildverzeichnis</a> mit entsprechenden Urheberrechtsangaben sind im Handbuch enthalten.
+
+**Quelle**: Der Quelltext für das Handbuch befindet sich in folgendem Repository: <https://github.com/berlinonline/open-data-handbuch>.
+Dort können über die _[Issue](https://github.com/berlinonline/open-data-handbuch/issues)_-Funktion auch Anregungen gemacht oder Fehler gemeldet werden (github-Account erforderlich). 
+Wer mag, kann auch gleich einen Pull Request stellen!<br/>
+**Stand**: @include(date) ([1.0.9](https://github.com/berlinonline/open-data-handbuch/blob/master/CHANGELOG.md#109))

parts/latex_preamble.md

+\pagenumbering{arabic}
+\setcounter{page}{1}
+

parts/pages_impressum.template.md

+# Impressum {-}
+
+**Herausgeber:** Land Schleswig-Holstein<br>
+**Lizenz**: Der Text des Handbuchs ist unter einer <a href="https://creativecommons.org/licenses/by/4.0/deed.de">Creative Commons Namensnennung 4.0 International Lizenz</a> (CC BY 4.0) veröffentlicht.
+Bilder und andere Elemente, deren Urheberrecht bei Dritten liegen, sind ausgenommen.
+<a href="#quellenverzeichnis">Quellenverzeichnis</a> und <a href="#bildverzeichnis">Bildverzeichnis</a> mit entsprechenden Urheberrechtsangaben sind im Handbuch enthalten.
+
+**Quelle**: Der Quelltext für das Handbuch befindet sich in folgendem Repository: <https://github.com/berlinonline/open-data-handbuch>.
+Dort können über die _[Issue](https://github.com/berlinonline/open-data-handbuch/issues)_-Funktion auch Anregungen gemacht oder Fehler gemeldet werden (github-Account erforderlich). 
+Wer mag, kann auch gleich einen Pull Request stellen!<br/>
+**Stand**: @include(date) ([1.0.9](https://github.com/berlinonline/open-data-handbuch/blob/master/CHANGELOG.md#109))

parts/pages_title.md

+# Open-Data-Leitfaden Schleswig-Holstein
+
+![Inhaltsübersicht über den Leitfaden Schleswig-Holstein in Form einer Landkarte von Schleswig-Holstein](images/title.png "Inhaltsübersicht über den Leitfaden Schleswig-Holstein")
+

template/default.latex

+\PassOptionsToPackage{unicode=true$for(hyperrefoptions)$,$hyperrefoptions$$endfor$}{hyperref} % options for packages loaded elsewhere
+\PassOptionsToPackage{hyphens}{url}
+$if(colorlinks)$
+\PassOptionsToPackage{dvipsnames,svgnames*,x11names*}{xcolor}
+$endif$
+$if(dir)$
+$if(latex-dir-rtl)$
+\PassOptionsToPackage{RTLdocument}{bidi}
+$endif$
+$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$}
+\usepackage[T1]{fontenc}
+\usepackage{microtype}
+$if(beamer)$
+$if(background-image)$
+\usebackgroundtemplate{%
+  \includegraphics[width=\paperwidth]{$background-image$}%
+}
+$endif$
+\usepackage{pgfpages}
+\setbeamertemplate{caption}[numbered]
+\setbeamertemplate{caption label separator}{: }
+\setbeamercolor{caption name}{fg=normal text.fg}
+\beamertemplatenavigationsymbols$if(navigation)$$navigation$$else$empty$endif$
+$for(beameroption)$
+\setbeameroption{$beameroption$}
+$endfor$
+% 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(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}
+\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{Scale=MatchLowercase}
+  \defaultfontfeatures[\rmfamily]{Ligatures=TeX,Scale=1}
+$if(mainfont)$
+  \setmainfont[$for(mainfontoptions)$$mainfontoptions$$sep$,$endfor$]{$mainfont$}
+$endif$
+$if(sansfont)$
+  \setsansfont[$for(sansfontoptions)$$sansfontoptions$$sep$,$endfor$]{$sansfont$}
+$endif$
+$if(monofont)$
+  \setmonofont[$for(monofontoptions)$$monofontoptions$$sep$,$endfor$]{$monofont$}
+$endif$
+$for(fontfamilies)$
+  \newfontfamily{$fontfamilies.name$}[$for(fontfamilies.options)$$fontfamilies.options$$sep$,$endfor$]{$fontfamilies.font$}
+$endfor$
+$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}}{}
+\IfFileExists{microtype.sty}{% use microtype if available
+  \usepackage[$for(microtypeoptions)$$microtypeoptions$$sep$,$endfor$]{microtype}
+  \UseMicrotypeSet[protrusion]{basicmath} % disable protrusion for tt fonts
+}{}
+$if(indent)$
+$else$
+\makeatletter
+\@ifundefined{KOMAClassName}{% if non-KOMA class
+  \IfFileExists{parskip.sty}{%
+    \usepackage{parskip}
+  }{% else
+    \setlength{\parindent}{0pt}
+    \setlength{\parskip}{6pt plus 2pt minus 1pt}}
+}{% if KOMA class
+  \KOMAoptions{parskip=half}}
+\makeatother
+$endif$
+$if(verbatim-in-note)$
+\usepackage{fancyvrb}
+$endif$
+\usepackage{xcolor}
+\IfFileExists{xurl.sty}{\usepackage{xurl}}{} % add URL line breaks if available
+\IfFileExists{bookmark.sty}{\usepackage{bookmark}}{\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$,
+  filecolor=$if(filecolor)$$filecolor$$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}
+\lstset{defaultdialect=[5.3]Lua}
+\lstset{defaultdialect=[x86masm]Assembler}
+$endif$
+$if(lhs)$
+\lstnewenvironment{code}{\lstset{language=Haskell,basicstyle=\small\ttfamily}}{}
+$endif$
+$if(highlighting-macros)$
+$highlighting-macros$
+$endif$
+$if(tables)$
+\usepackage{calc}
+\usepackage{longtable,booktabs,array}
+$if(beamer)$
+\usepackage{caption}
+% These lines are needed to make table captions work with longtable:
+\makeatletter
+\def\fnum@table{\tablename~\thetable}
+\makeatother
+$else$
+% Allow footnotes in longtable head/foot
+\IfFileExists{footnotehyper.sty}{\usepackage{footnotehyper}}{\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(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}{-2}
+$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=0 % if pdftex or luatex
+  \usepackage[shorthands=off,$for(babel-otherlangs)$$babel-otherlangs$,$endfor$main=$babel-lang$]{babel}
+$if(babel-newcommands)$
+  $babel-newcommands$
+$endif$
+\else % if xetex
+  % 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
+  \usepackage{bidi}
+\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)$
+$if(beamer)$
+$else$
+\usepackage{etoolbox}
+\makeatletter
+\providecommand{\subtitle}[1]{% add subtitle to \maketitle
+  \apptocmd{\@title}{\par {\large #1 \par}}{}{}
+}
+\makeatother
+$endif$
+\subtitle{$subtitle$}
+$endif$
+$if(author)$
+\author{$for(author)$$author$$sep$ \and $endfor$}
+$endif$
+\date{$date$}
+$if(beamer)$
+$if(institute)$
+\institute{$for(institute)$$institute$$sep$ \and $endfor$}
+$endif$
+$if(titlegraphic)$
+\titlegraphic{\includegraphics{$titlegraphic$}}
+$endif$
+$if(logo)$
+\logo{\includegraphics{$logo$}}
+$endif$
+$endif$
+
+\begin{document}
+$if(title)$
+$if(beamer)$
+\frame{\titlepage}
+$else$
+%\maketitle
+%\includegraphics{$titlegraphic$}
+\clearpage
+%% temporary titles
+% command to provide stretchy vertical space in proportion
+\newcommand\nbvspace[1][3]{\vspace*{\stretch{#1}}}
+% allow some slack to avoid under/overfull boxes
+\newcommand\nbstretchyspace{\spaceskip0.5em plus 0.25em minus 0.25em}
+% To improve spacing on titlepages
+\newcommand{\nbtitlestretch}{\spaceskip0.6em}
+\thispagestyle{empty}
+\begin{center}
+\bfseries
+\nbvspace[1]
+\Huge
+$title$
+% {\nbtitlestretch\huge
+% $title$}
+
+\nbvspace[1]
+\normalsize
+
+% TO WHICH IS ADDED MANY USEFUL ONE\\
+% LINERS AND CODE SO THAT\\
+% YOU CAN AWK LIKE A HAWK
+% \nbvspace[1]
+% \small BY\\
+% \Large PETERIS KRUMINS\\[0.5em]
+% \footnotesize AUTHOR OF ``A WORKING ALGEBRA,'' ``WIRELESS TELEGRAPHY,\\
+% ITS HISTORY, THEORY AND PRACTICE,'' ETC., ETC.
+
+\nbvspace[2]
+
+\includegraphics{$cover-image$}
+\nbvspace[3]
+\normalsize
+
+% DOHA\\
+\large
+$date$
+\nbvspace[1]
+\end{center}
+$endif$
+$if(abstract)$
+\begin{abstract}
+$abstract$
+\end{abstract}
+$endif$
+$endif$
+
+\pagestyle{plain}
+
+
+$for(include-before)$
+$include-before$
+
+$endfor$
+$if(toc)$
+$if(toc-title)$
+\renewcommand*\contentsname{$toc-title$}
+$endif$
+$if(beamer)$
+\begin{frame}
+$if(toc-title)$
+  \frametitle{$toc-title$}
+$endif$
+  \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}

template/listings-setup.tex

+\usepackage{xcolor}
+
+\lstset{
+    basicstyle=\small\ttfamily,
+    numbers=left,
+    numberstyle=\footnotesize,
+    stepnumber=2,
+    numbersep=5pt,
+    backgroundcolor=\color{black!10},
+    showspaces=false,
+    showstringspaces=false,
+    showtabs=false,
+    tabsize=2,
+    captionpos=b,
+    breaklines=true,
+    breakatwhitespace=false,
+    breakautoindent=true,
+    linewidth=\textwidth,
+    literate=%
+        {Ö}{{\"O}}1
+        {Ä}{{\"A}}1
+        {Ü}{{\"U}}1
+        {ß}{{\ss}}1
+        {ü}{{\"u}}1
+        {ä}{{\"a}}1
+        {ö}{{\"o}}1
+        {§}{{\S}}1
+}

template/metadata_yml.template

+---
+documentclass: book
+language: de
+date: @include(date)
+numbersections: true
+fontfamily: arev
+papersize: a4
+pagestyle: plain
+header-includes:
+ - \urlstyle{tt}
+---