remove typo

.gitignore

@@ -80,6 +80,7 @@ _minted*
 *.swo
 
 main.pdf
+listings-mode.tex
 exercise-mode.tex
 public
 exercises/*/*.pdf

Makefile

@@ -23,6 +23,7 @@ tasks: exercises/**/*
 # Compile a preview PDF containing all contents
 preview: main.tex
 	echo "\newcommand\exercisemode{any}" > exercise-mode.tex
+	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
 	pdflatex -shell-escape main.tex
 	@echo
 	@echo
@@ -43,6 +44,7 @@ publication-dir:
 # Compile a printable PDF without exercises
 publication-pdf-without-exercises: clean publication-dir main.tex
 	echo "\newcommand\exercisemode{none}" > exercise-mode.tex
+	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
 	pdflatex -shell-escape -jobname=script-only main.tex
 	pdflatex -shell-escape -jobname=script-only main.tex
 	pdflatex -shell-escape -jobname=script-only main.tex
@@ -51,6 +53,7 @@ publication-pdf-without-exercises: clean publication-dir main.tex
 # Compile a printable PDF with exercises and without solutions
 publication-pdf-with-exercises: clean publication-dir main.tex
 	echo "\newcommand\exercisemode{exercises}" > exercise-mode.tex
+	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
 	pdflatex -shell-escape -jobname=script-with-exercises main.tex
 	pdflatex -shell-escape -jobname=script-with-exercises main.tex
 	pdflatex -shell-escape -jobname=script-with-exercises main.tex
@@ -59,6 +62,7 @@ publication-pdf-with-exercises: clean publication-dir main.tex
 # Compile a printable PDF with exercises and solutions
 publication-pdf-with-solutions: clean publication-dir main.tex
 	echo "\newcommand\exercisemode{solutions}" > exercise-mode.tex
+	echo "\newcommand\listingsmode{minted}" > listings-mode.tex
 	pdflatex -shell-escape -jobname=script-with-solutions main.tex
 	pdflatex -shell-escape -jobname=script-with-solutions main.tex
 	pdflatex -shell-escape -jobname=script-with-solutions main.tex
@@ -67,7 +71,7 @@ publication-pdf-with-solutions: clean publication-dir main.tex
 # Build a ZIP file with tasks and without solutions
 publication-zip-with-exercises: clean publication-dir main.tex
 	rm -rf temp/*
-	cp --parents main.tex praeamble.tex commands.tex content/* graphics/* listings/**/*.{tex,pdf,bib,java} temp/
+	cp --parents main.tex praeamble.tex commands.tex setup.tex content/* graphics/* listings/**/*.{tex,pdf,bib,java,txt} temp/
 	cp --parents exercises/**/* temp/
 	rm -f temp/exercises/**/*.done.{tex,bib}
 	rm -f temp/exercises/**/*.rend.tex
@@ -78,7 +82,7 @@ publication-zip-with-exercises: clean publication-dir main.tex
 # Build a ZIP file with tasks and solutions
 publication-zip-with-solutions: clean publication-dir main.tex
 	rm -rf temp/*
-	cp --parents main.tex praeamble.tex commands.tex content/* graphics/* listings/**/*.{tex,pdf,bib,java} temp/
+	cp --parents main.tex praeamble.tex commands.tex setup.tex content/* graphics/* listings/**/*.{tex,pdf,bib,java,txt} temp/
 	cp --parents exercises/**/* temp/
 	rm -f temp/exercises/**/*.raw.{tex,bib}
 	find temp/ -name '*.done.*' -exec bash -c 'sed "s/\.done\./\./g" <<<{} | xargs mv {}' \;

README.md

@@ -1,6 +1,6 @@
 # LaTeX Script by Fachschaft WIAI
 
-This script introduces the most fundamental LaTeX mechanisms to get learners started. It is used both as a reference and as exercise material for our [LaTeX workshop](https://wiai.stuve-bamberg.de/latex-weekend), a **two-day tutorial aimed at students from various backgrounds**. At the moment, it is only available in German. The following topics are covered:
+This script introduces the most fundamental LaTeX mechanisms to get learners started. It is used both as a reference and as exercise material for our [LaTeX workshop](https://wiai.stuve-bamberg.de/latex-weekend), a **two-day tutorial aimed at students from various backgrounds**. The following topics are covered:
 
 * general introduction to the LaTeX system 
 * basic document structure
@@ -10,7 +10,7 @@ This script introduces the most fundamental LaTeX mechanisms to get learners sta
 * formatting paragraphs
 * lists
 * maths and formulas
-* sourcecode listings
+* source code listings (`minted` + `listings`)
 * graphics
 * tables
 * footnotes
@@ -19,17 +19,40 @@ This script introduces the most fundamental LaTeX mechanisms to get learners sta
 
 Most chapters contain exercises to be performed within the script itself, practically teaching the aspects that are introduced by the text.
 
-## Requirements
+## Getting started
 
-Compiling the script requires a working [LaTeX installation](https://tug.org/texlive/).
-For sourcecode listings, we are using [Pygments](https://pygments.org/) and [Python3](https://www.python.org/).
-The Makefile comes in handy for compiling the different versions of the script (see usage section).
-For learners, we recommend using [TeXstudio](https://www.texstudio.org/) to compile the script.
+### For beginners
+A PDF version of the script can be found [in the “releases” section](https://github.com/fs-wiai/latex-script/releases). It will give you an overview of how to approach any, but especially this LaTeX project. For this, have a look at the “First steps with LaTeX” section.
+
+**Optionally**, the `minted` package can be used for source code listings. This requires some additional configuration (including the installation of [Python3](https://www.python.org/)). Please refer to the chapter on “Source code listings” in the aforementioned PDF file.
+
+### Command line usage
+
+The project can be compiled by running a LaTeX compiler on `main.tex`. A simple command would be:
+
+```sh
+$ pdflatex main.tex
+```
+
+Run the command twice to generate the table of contents and other registers. Once the literature tasks are being worked on, compilation requires an additional call to BibTeX:
+
+```sh
+$ pdflatex main.tex
+$ bibtex main.aux
+$ pdflatex main.tex
+$ pdflatex main.tex
+```
+
+If you decide to use the optional `minted` package (see section above), don't forget to add the `--shell-escape` flag: 
+
+```sh
+$ pdflatex --shell-escape main.tex
+```
 
 ## Project Structure
 
 ```
-latex-skript/
+latex-script/
 ├── commands.tex
 ├── compile_listings
 ├── compile_tasks
@@ -53,33 +76,31 @@ latex-skript/
 ├── Makefile
 ├── praeamble.tex
 ├── public
+├── setup.tex
 └── README.md
 ```
 
-* **`main.tex`** is the entrypoint. It includes the preamble (`preamble.tex`), our custom commands (`commands.tex`) as well as all sections.
+## Relevant files for learners
+* **`main.tex`** is the entry point. It includes the preamble (`preamble.tex`), our custom commands (`commands.tex`) as well as all sections.
 * **`content`** comprises the individual chapters of this script.
 * Most chapters include a task that can be found in the **`exercises`** folder.
-* **`public`** is the folder where all packed-up versions of the script are moved to, once they have been created using the `Makefile` and the command `make publication`. There are two zip archives of this repository (one containing only the exercises and one with solutions included) as well as three PDF versions (one with the content only, one with exercises, and one with exercises and solutions).
-* `compile_listings` and `compile_commands` are two **utility bash scripts**. They produce a rendered and cropped PDF version of all `.tex` files within the `listings`/`exercises` folders and their subfolders. Rendered listings remain in `listings` whereas tasks are moved to the **`graphics`** folder afterwards. The compiled tasks are necessary for students who receive the project archive, but should not be given the sourcecode of tasks, e.g., if an exercise demands them to code up a table based on a pre-coded example.
 
-## Usage
+Please don't feel overwhelmed by the amount of files in this repository. You will get to know the most important parts of the project step by step by [following the script](https://github.com/fs-wiai/latex-script/releases) or our workshop. What's more, by using this larger projects you get accustomed to the complexity of real LaTeX projects – bachelor's/master's theses and the like.
 
-**For beginners**: A PDF version of the script can be found in the “releases” section. It will give you an overview of how to use any LaTeX project. For this, have a look at the “Erste Schritte mit LaTeX” section.
+## Further information for maintainers
 
-**Commandline usage**: The project can be compiled by running a LaTeX compiler on `main.tex`. Note that we make (heavy) use of the Pygments package, which requires additional installation (see section above) and a flag (`--shell-escape`) that has to be passed to the compiler. To configure TeXstudio with Pygments, see the chapter “Quelltext-Listings” (especially “10.2 – Compilerbefehl ändern”) in the script. A simple command would be:
+### Listings mode
+**`setup.tex`** is used to configure which package to use for source code listings. All listings in the script are set using custom commands that can internally switch between the `listings` and the `minted` package.
 
-```sh
-$ pdflatex --shell-escape main.tex
-```
+**`listings-mode.tex`** is the file that determines the listings mode. If this file is non-existent or contains the line `\newcommand\listingsmode{default}`, `listings` is used. `\newcommand\listingsmode{minted}` switches it to `minted`. We decided to add this abstraction to deal with learners having trouble to install Pygments on their machine.
 
-Run the command twice to generate the table of contents and other registers. Once the literature tasks are being worked on, compilation requires an additional call to BibTeX:
+### Including rendered images of source code
+**`compile_listings`** and **`compile_commands`** are two utility bash scripts. They produce a rendered and cropped PDF version of all `.tex` files within the `listings`/`exercises` folders and their sub folders. Rendered listings remain in `listings` whereas exercise renderings are moved to the **`graphics`** folder afterwards. 
 
-```sh
-$ pdflatex --shell-escape main.tex
-$ bibtex main.aux
-$ pdflatex --shell-escape main.tex
-$ pdflatex --shell-escape main.tex
-```
+The compiled tasks are necessary for students who receive the project archive, but should not be given the source code of tasks, e. g., if an exercise demands them to code up a table based on a pre-coded example.
+
+### Publishing the script
+**`public`** is the folder where all packed-up versions of the script are moved to, once they have been created using the `Makefile` and the command `make publication`. There are two zip archives of this repository (one containing only the exercises and one with solutions included) as well as three PDF versions (one with the content only, one with exercises, and one with exercises and solutions).
 
 ## Contributing
 
@@ -93,4 +114,4 @@ These are the main contributors so far:
 
 ## License
 
-The LaTeX Script was created by Fachschaft WIAI, the Student Council of the faculty of Information Systems and Applied Computer Sciences at University of Bamberg. It is licensed under the creative commons licence “Attribution-ShareAlike 4.0 International” (CC BY-SA 4.0): http://creativecommons.org/licenses/by-sa/4.0/. Usage permissions beyond the scope of this license might be granted upon request.
+The LaTeX Script has been assembled by the Student Council of the Faculty of Information Systems and Applied Computer Sciences (Fachschaft WIAI) at University of Bamberg. It is licensed under Creative Commons “Attribution-ShareAlike 4.0 International” (CC BY-SA 4.0): http://creativecommons.org/licenses/by-sa/4.0/. Upon request, allowances exceeding the limitations of this license may be granted.

commands.tex

@@ -34,6 +34,150 @@
 	\rule{\widefigurewidth}{0.4pt}
 }
 
+% Shell command
+% ==============
+% Mono-spaced text without syntax highlighting.
+% Intended for full commands. Wrapped by empty lines.
+\newcommand\shell[1]{%
+\vspace{.5cm}
+\noindent \hspace*{-1em}{\color{lightgray}\texttt{\$ }}\texttt{#1}
+\vspace{.5cm}
+}
+
+% Command parts
+% ===================
+% Mono-spaced text without syntax highlighting.
+% Intended for parts of shell commands.
+% Displayed inline.
+\newcommand\sh[1]{%
+	\texttt{#1}%
+}
+
+% Package names
+% =============
+% Mono-spaced text without syntax highlighting.
+% Intended for LaTeX package names.
+\newcommand\pkg[1]{%
+	\ifthenelse{\equal{\listingsmode}{minted}}{%
+		\texttt{#1}%
+	}{%
+		\texttt{#1}%
+	}%
+}
+
+% File paths
+% ==========
+% Mono-spaced text without syntax highlighting.
+% Intended for file names and paths.
+\newcommand\file[1]{%
+	\texttt{#1}%
+}
+
+% Mono-spaced words
+% =================
+% Mono-spaced text without syntax highlighting.
+% Intended for single words or small passages without special meaning.
+% These can be environments, file extensions, and many more.
+\newcommand\mono[1]{%
+	\texttt{#1}%
+}
+
+% Inline code
+% ===========
+% Code snippets with syntax highlighting.
+% TODO: Fix special character mess.
+%
+% Arguments:
+% 1. Language.
+% 2. Source code.
+\newcommand\code[2]{%
+	% \mintinline{#1}{#2}
+	\texttt{#2}%
+}
+
+% Code block 
+% ==========
+% Pastes in a non-inline code block using minted or lstlistings
+% first parameter: programming language
+% path to code file
+
+\lstdefinelanguage{latex}{%
+	language=[LaTeX]TeX
+}
+
+\lstdefinelanguage{csharp}{%
+	language=[Sharp]C
+}
+
+\lstdefinelanguage{bibtex}
+{keywords={%
+		@article,@book,@collectedbook,@conference,@electronic,@ieeetranbstctl,%
+		@inbook,@incollectedbook,@incollection,@injournal,@inproceedings,%
+		@manual,@mastersthesis,@misc,@patent,@periodical,@phdthesis,@preamble,%
+		@proceedings,@standard,@string,@techreport,@unpublished%
+	},
+	comment=[l][\itshape]{@comment},
+	sensitive=false,
+}
+
+
+\newcommand\codeblock[2]{%
+	\ifthenelse{\equal{\listingsmode}{minted}}{%
+		\inputminted[breaklines]{#1}{#2}
+	}{%
+		\ifthenelse{\equal{#1}{latex}}{%
+		
+			\lstset{language=#1, 
+				basicstyle=\footnotesize\ttfamily,
+				breaklines=true,
+				keywordstyle=\color{ForestGreen}\bfseries,
+				emph={%  
+					subsection, subsubsection, url, includegraphics, toprule, 
+					midrule, bottomrule, cref, setlength, maketitle, 
+					tableofcontents, foreignlanguage, paragraph, subparagraph, 
+					mint, mintinline, inputminted, usemintedstyle, definecolor, 
+					citep, enquote, lstinputlisting%
+				},
+				postbreak=\mbox{{$\hookrightarrow$}\space},
+				emphstyle={\color{ForestGreen}\bfseries},
+				commentstyle=\color{darkgray},
+				% Allow special characters in lstlistings.
+				literate=
+				{Ö}{{\"O}}1
+				{Ä}{{\"A}}1
+				{Ü}{{\"U}}1
+				{ß}{{\ss}}2
+				{ü}{{\"u}}1
+				{ä}{{\"a}}1
+				{ö}{{\"o}}1
+				{é}{{\'e}}1
+				{…}{\textellipsis}1
+			}
+					\lstinputlisting{#2}%
+%		
+		}{%
+			\lstset{
+				language=#1,
+				% Allow special characters in lstlistings.
+				literate=
+				{Ö}{{\"O}}1
+				{Ä}{{\"A}}1
+				{Ü}{{\"U}}1
+				{ß}{{\ss}}2
+				{ü}{{\"u}}1
+				{ä}{{\"a}}1
+				{ö}{{\"o}}1
+				{é}{{\'e}}1
+				{…}{\textellipsis}1
+			}
+			\lstinputlisting{#2}
+			
+		}	
+	}
+}
+
+
+
 % Simple code examples
 % ====================
 % Box for example code next to the rendered example.
@@ -64,7 +208,7 @@
 			\colrules
 			% Left content: code listing:
 			\begin{subfigure}{\widefigurewidth}
-				\inputminted[breaklines]{tex}{listings/#2.tex}
+				\codeblock{latex}{listings/#2.tex}
 			\end{subfigure}
 			\hspace{\widefiguregap}
 			% Right content: image or rendered example:
@@ -87,7 +231,7 @@
 			\hspace{\widefiguregap}
 			% Right caption:
 			\begin{subfigure}[t]{\widefigurewidth}
-				\caption{Ergebnis}
+				\caption{Result}
 				\label{#1-result}
 			\end{subfigure}
 		}
@@ -122,8 +266,8 @@
 		\definecolor{latexblue}{rgb}{0.9,0.925,0.95}
 		\pagecolor{latexblue}
 		%\definecolor{latexblue}{rgb}{0.73,0.84,0.92}
-		\section*{Übung \thechapter}
-		\addcontentsline{toc}{section}{Übung}%
+		\section*{Exercise \thechapter}
+		\addcontentsline{toc}{section}{Exercise}%
 		\input{exercises/#1/task.tex}
 		\newpage
 		\nopagecolor
@@ -150,13 +294,13 @@
 	\ifthenelse{\equal{\exercisemode}{any}}{
 		\IfFileExists{#1.raw.tex}{
 			\IfFileExists{#1.done.tex}{
-				\subsubsection*{Vorschau des ungelösten Materials}
+				\subsubsection*{Preview of the raw material}
 			}{}
 			\input{#1.raw.tex}
 		}{}
 		\IfFileExists{#1.done.tex}{
 			\IfFileExists{#1.raw.tex}{
-				\subsubsection*{Vorschau des gelösten Materials}
+				\subsubsection*{Preview of the solution}
 			}{}
 			\input{#1.done.tex}
 		}{}

compile_listings

@@ -2,22 +2,30 @@
 for D in listings/*; do
     if [ -d "${D}" ]; then
 			# Compile without cropping.
+			# References to other files are interpreted relative to the
+			# root directory.
     	for F in ${D}/*_page.tex; do
     		if [ -f "${F}" ]; then
 					echo "###### Compiling ${F} ######"
-    			pdflatex --output-directory "${D}" "${F}"
+    			pdflatex --shell-escape --output-directory "${D}" "${F}"
 		    fi
 	    done
 			# Compile with cropping.
+			# Careful: References to other files are interpreted relative
+			# to the file, not to the root directory.
 	    for F in ${D}/*_crop.tex; do
 	    	if [ -f "${F}" ]; then
 	    		echo "###### Compiling and cropping ${F} ######"
-	    		pdflatex --output-directory "${D}" "${F}"
-	    		pdfcrop "${D}/$(basename -s .tex ${F}).pdf" \
-	    				"${D}/$(basename -s .tex ${F}).pdf"
+					pushd "${D}"
+	    		pdflatex --shell-escape "$(basename $F)"
+	    		pdfcrop "$(basename -s .tex ${F}).pdf" \
+	    				"$(basename -s .tex ${F}).pdf"
+					popd
 	    	fi
 	    done
 			# Compile with BibTeX and cropping.
+			# References to other files are interpreted relative to the
+			# root directory.
 			for F in ${D}/*_bib.tex; do
 	    	if [ -f "${F}" ]; then
 	    		echo "###### Compiling and cropping ${F} ######"

content/basic-document-structure.tex

@@ -1,133 +1,131 @@
-\chapter{Grundstruktur}
+\chapter{Basic document structure}
 \label{sec:basic-document-structure}
 
-Wie sieht so ein \LaTeX-Dokument jetzt eigentlich aus?
-Im Kern besteht es immer aus zwei Teilen: einer Präambel zu Beginn sowie der unmittelbar folgenden Dokumentumgebung.
-Als \emph{Präambel} bezeichnen wir die ersten Befehle eines \LaTeX-Dokumentes, mit denen globale Einstellungen wie die Dokumentklasse, die Zeichenkodierung, die Sprache und das Seitenformat festgelegt werden.
-Die \emph{Dokumentumgebung} hingegen enthält den Inhalt, der später in der fertigen \acro{PDF}-Datei erscheinen soll.
+In essence, every \LaTeX{} document is composed of two parts: 
+We call the first commands within our \LaTeX{} document the \emph{preamble}.
+It specifies global properties of our document, such as the document class, the encoding, the language, the page format, and additional packages that we want to use.
+The \emph{document environment}, on the other hand, contains the actual content of our document, i.\,e., the things that we will later see in our generated \acro{PDF} file. 
 
-\Example{lst:latex-document-basic-structure}{basic-document-structure/hello-world}{basic-document-structure/hello-world_crop}{Beispielhafter Aufbau eines einfachen \LaTeX-Dokuments mit Präambel und Dokumentumgebung}
+\Example{lst:latex-document-basic-structure}{basic-document-structure/hello-world}{basic-document-structure/hello-world_crop}{Exemplary structure of a simple \LaTeX{} document with preamble and document environment}
 
-\section{Präambel}
-Beginnen wir mit der Präambel.
-Eine minimale Präambel sollte die folgenden Festlegungen treffen:
+\section{Preamble}
+Let's take a closer look at the preamble. 
+A minimal preamble should contain the following specifications: 
 
-\subsection{Dokumentklasse}\label{sec:document-class}
-\mintinline{latex}|\documentclass[<parameter>]{<dokumentklasse>}|
-definiert die Dokumentklasse. 
-Die verbreitetsten von \LaTeX\ standardmäßig unterstützten Dokumentklassen sind \mintinline{latex}{article} für kurze und \mintinline{latex}{report} für längere Dokumente, \mintinline{latex}{book} für Bücher, \mintinline{latex}{beamer}\footnote{Präsentationen in \LaTeX\ sind ein Thema für sich, auf das wir nicht näher eingehen. Bei Interesse sei diese Einführung von Overleaf empfohlen: \url{https://www.overleaf.com/learn/latex/Beamer}} für Präsentationen sowie \mintinline{latex}{letter}\footnote{Auch auf Briefe wird in diesem Skript nicht weiter eingegangen. WikiBooks gibt eine Einführung: \url{https://en.wikibooks.org/wiki/LaTeX/Letters}} für Briefe.
+\subsection{Document class}\label{sec:document-class}
+We can define a document class by using the command \code{latex}{\textbackslash documentclass[<para- meter>]\{<document class>\}}.
+The most commonly used document classes that are supported by default are \pkg{article} for short documents, and \pkg{report} for longer ones. 
+Furthermore, you can use \pkg{book} for books, \pkg{beamer}\footnote{We do not cover making presentations in \LaTeX{} in this tutorial. However, if you are interested in the topic, we recommend this introduction on Overleaf: \url{https://www.overleaf.com/learn/latex/Beamer}} for presentations, and \pkg{letter}\footnote{We also do not cover letters in this script. An introduction can be found on WikiBooks: \url{https://en.wikibooks.org/wiki/LaTeX/Letters}} for letters.
 
-Zusätzlich zu den Standard-Dokumentklassen entwickelten sich die \acro{KOMA}-Script-Klassen.\footnote{Einen umfassenden Überblick über die Möglichkeiten von \acro{KOMA}-Script gibt folgendes Handbuch: \url{https://komascript.de/~mkohm/scrguide.pdf}}
-Als Alternative zum \mintinline{latex}{article} steht \mintinline{latex}{scrartcl} bereit, \mintinline{latex}{report} wird durch \mintinline{latex}{scrreport} ersetzt, \mintinline{latex}{scrbook} kann anstelle von \mintinline{latex}{book} verwendet werden und \mintinline{latex}{scrlttr2} ist als Ersatz für \mintinline{latex}{letter} entstanden.
-Eine vollständige Liste aller möglichen \acro{KOMA}-Script-Dokumentklassen ist online\footnote{Erreichbar unter \url{https://komascript.de/komascriptbestandteile}} verfügbar.
-Die \acro{KOMA}-Klassen ändern das Layout des fertigen \acro {PDF}-Dokuments und bringen zusätzliche Funktionalitäten mit.
-Während die Standard-Klassen für den Gebrauch in Amerika gedacht sind, folgen \acro{KOMA}-Klassen europäischen Normen, etwa bei Brief"|formaten.
+In addition to the standard document classes, the \acro{KOMA} script classes have been developed. 
+They provide alternatives to the document classes mentioned above: 
+In lieu of \pkg{article} you can use \pkg{scrartcl}, \pkg{report} is replaced by \pkg{scrreprt},\footnote{Those vowels are indeed missing, do not try to insert them.} and \pkg{scrbook} can be used instead of \pkg{book}. 
+As a replacement for \pkg{letter}, one can use \pkg{scrlttr2}. 
+A complete list of all \acro{KOMA} script classes is available online.\footnote{Available at: \url{https://komascript.de/komascriptbestandteile}} 
+By using \acro{KOMA} document classes, the layout of the generated \acro{PDF} document is changed. 
+On top of that, they provide additional functionalities. 
+The standard document classes are designed according to US-American conventions
+whereas \acro{KOMA} classes adhere to European norms, e.\,g., for 
+writing letters. 
 
-Dem \mintinline{latex}{\documentclass}-Befehl können verschiedene optionale Parameter übergeben werden. 
-\mintinline{latex}{\documentclass[10pt,a5paper,landscape]{scrartcl}} etwa konfiguriert einen \acro{KOMA}-Script-Artikel mit Schriftgröße 10\,pt\footnote{Die Standardschriftgröße wäre hier 12\,pt.} auf A5-Papier\footnote{In der Voreinstellung handelte es sich um A4-Papier.} im Querformat.
-Auch die Sprache kann mit übergeben werden (vgl. dazu \cref{sec:language}).
+Each \code{latex}{\textbackslash documentclass} command can hold optional parameters in 
+square brackets. 
+\code{latex}{\textbackslash documentclass[10pt,a5paper,landscape]scrartcl\}}, 
+for instance, configures a \acro{KOMA} script article and sets its font size to 
+10\,pt,\footnote{The standard font size is 12\,pt.} the page size to 
+A5,\footnote{The default case would be A4.} and the orientation of the page to 
+landscape. 
+The language can be passed as an optional parameter, too (cf. \cref{sec:language}). 
 
-\subsection{Exkurs: Pakete}
+\subsection{Digression: packages}
 \label{sec:packages}
-\begin{minted}{latex}
-\usepackage[<optionen>]{<paketname>}
-\end{minted}
-Pakete sind \LaTeX-Erweiterungen, die zusätzliche Befehle und Funktionalitäten zur Verfügung stellen.
-Es existieren verschiedene Pakete für verschiedene Anwendungsfälle (z.\,B. Formelsatz, Listen, \textellipsis).
-Bevor sie verwendet werden können, müssen sie in der Präambel eingebunden werden. 
-Hierfür wird der obige Befehl verwendet.
-Die wichtigsten \LaTeX-Pakete sind im Comprehensive \TeX\ Archive Network,\footnote{Erreichbar unter \url{https://www.ctan.org/}} kurz \acro{CTAN}, abgelegt.
-Hier finden sich auch Dokumentationen zu den einzelnen Funktionalitäten.
 
-\subsection{Kodierung}
-\begin{minted}{latex}
-\usepackage[utf8]{inputenc}
-\usepackage[t1]{fontenc}
-\end{minted}
-Pakete werden zum Beispiel zur Auswahl der Zeichenkodierung benötigt.
-Die Zeichenkodierung\footnote{Vgl. \url{https://de.wikipedia.org/wiki/Zeichenkodierung}} entscheidet darüber, welcher Zeichensatz zur Verfügung steht.
-Der Standardzeichensatz in \LaTeX\ ist \acro{ASCII}.\footnote{Vgl. \url{https://de.wikipedia.org/wiki/American_Standard_Code_for_Information_Interchange}}
-Dieser amerikanische Standard enthält beispielsweise keine Umlaute und ist daher für die meisten Einsätze wenig geeignet.
-Als universelle Zeichenkodierung kann \acro{UTF-8}\footnote{Vgl. \url{https://de.wikipedia.org/wiki/UTF-8}} verwendet werden.
+\codeblock{latex}{listings/basic-document-structure/packages.tex}
+Packages provide additional commands and functionalities that we can use within our \LaTeX{} source code. 
+There are numerous packages for different use cases (e.\,g., typesetting formulas, lists, \textellipsis). 
+In order to use a package, it must be included within the preamble. 
+To do so, the above-mentioned command is used. 
+The most important \LaTeX{} packages can be found in the Comprehensive \TeX\ Archive Network, short: \acro{CTAN}.\footnote{Available at: \url{https://www.ctan.org/}} 
+You can also find documentation for the packages there. 
 
-In \LaTeX-Dokumenten sind zwei verschiedene Zeichenkodierungen von Belang.
-Das Input Encoding (kurz: \mintinline{latex}{inputenc}) bezieht sich auf den Quelltext, den wir eingeben, während das Font Encoding (kurz: \mintinline{latex}{fontenc}) das fertige \acro{PDF}-Dokument beeinflusst.
-Konkret beeinflusst \mintinline{latex}{fontenc} die Wahl der Schriftartdatei, die verwendet wird, um den Inhalt des Dokuments darzustellen, denn auch diese muss natürlich Sonderzeichen beinhalten.\footnote{Details zur Arbeitsweise von \mintinline{latex}{fontenc} gibt dieser Beitrag: \url{https://www.texwelt.de/fragen/5537/was-macht-eigentlich-usepackaget1fontenc}}
-\mintinline{latex}{T1} ist eine Kodierung, die mit einer begrenzten Anzahl an Zeichen europäische Sprachen abzubilden versucht.
+\subsection{Encoding}
+\codeblock{latex}{listings/basic-document-structure/encoding.tex}
+One use case for packages is specifying the encoding of our \LaTeX{} document. 
+The character encoding\footnote{cf. \url{https://en.wikipedia.org/wiki/Character_encoding}} determines the available character set.
+The standard encoding in \LaTeX{} is \acro{ASCII}.\footnote{cf. \url{https://en.wikipedia.org/wiki/ASCII}}
+It is an American character encoding and therefore does not contain German umlauts or most other special characters, which makes it unsuitable at least for non-english use cases. 
+Instead, \acro{UTF-8}\footnote{cf. \url{https://en.wikipedia.org/wiki/UTF-8}} can be used as a universal character encoding.
 
-\subsection{Sprache}\label{sec:language}
-\begin{minted}{latex}
-\usepackage[ngerman]{babel}
-\end{minted}
+In \LaTeX{}, we need to specify two character encodings: 
+The input encoding (\mono{inputenc}), which refers to our source code, and the font encoding (\mono{fontenc}), which determines what the content of our \acro{PDF} document looks like.\footnote{Details on \mono{fontenc} can be found at: \url{https://tex.stackexchange.com/questions/108417/font-encoding-in-latex}}
+\pkg{T1} is an encoding that tries to cover most European languages with a limited number of characters. 
 
-Das Paket \mintinline{latex}{babel} stellt sprachspezifische Informationen (z.\,B. Silbentrennung, Sonderzeichen, Wechsel zwischen Fonts, Übersetzung von Labels\footnote{Vgl. \cref{sec:references}} wie \enquote{Kapitel}, \enquote{Inhaltsverzeichnis} oder \enquote{Abbildung}) bereit.
-Als optionaler Parameter kann die Sprache übergeben werden.
-\mintinline{latex}{ngerman} steht hierbei für die Neue Deutsche Rechtschreibung.
-Manche Pakete erfordern es, dass die Sprachangabe schon als optionaler Parameter dem \mintinline{latex}{\documentclass}-Befehl\footnote{Vgl. \cref{sec:document-class}} übergeben wird.
-In diesem Fall wird der optionale Parameter beim Einbinden von \mintinline{latex}{babel} einfach weggelassen.
+\subsection{Language}\label{sec:language}
+\codeblock{latex}{listings/basic-document-structure/language.tex}
+The package \pkg{babel} provides language-specific information (e.\,g., on hyphenation, special characters, changing fonts, translation of labels\footnote{cf. \cref{sec:references}} like \enquote{Chapter,} \enquote{Table of Contents,} or \enquote{Figure.}
+The desired language can be passed as an optional parameter. 
+\pkg{ngerman}, for instance, is used for the new German spelling. 
+Some packages require that the language is already passed as an optional parameter in the \code{latex}{\textbackslash documentclass} command. 
+In this case, just leave out the optional parameter for the language within the \pkg{babel} inclusion command.
 
-In einem Dokument können auch mehrere Sprachen verwendet werden.
-Sie können einfach kommagetrennt als optionale Parameter aufgelistet werden.
-Im Dokument kann mit dem Befehl \mintinline{latex}{\selectlanguage{<sprache>}} zwischen den Sprachen umgeschaltet werden.
-Fremdsprachiger Text lässt sich alternativ auch über folgenden Befehl einbinden: 
-\begin{minted}{latex}
-\foreignlanguage{<sprache>}{<text>}
-\end{minted}
+We can also use multiple languages in our document. 
+To do so, we pass the languages, separated by commas, as an optional parameter to the babel inclusion command. 
+Within our document, we can switch between languages with the \code{latex}{\textbackslash selectlanguage\{<language>\}} command. 
+Alternatively, foreign-language text can be declared by using the following command: 
 
-\section{Dokumentumgebung}
+\codeblock{latex}{listings/basic-document-structure/foreign-language.tex}
 
-Zwischen \mintinline{latex}{\begin{document}} und \mintinline{latex}{\end{document}} gehören die Inhalte, die tatsächlich im Dokument erscheinen sollen.
+\section{Document environment}
+The actual content of the \acro{PDF} document needs to be put inside of an environment starting with \code{latex}{\textbackslash begin\{document\}} and ending with \code{latex}{\textbackslash end\{document\}}.
 
-\subsection{Fließtext}
-Der einfachste Inhalt der Dokumentumgebung ist Fließtext.
-Er kann direkt in den Quelltext geschrieben werden.
-Zeilenumbrüche und zu mehreren auftretende Leerzeichen werden dabei ignoriert.
-Leerzeilen erzeugen einen neuen Absatz, der standardmäßig mit einem Einzug beginnt.\footnote{Der Befehl \mintinline{latex}{\noindent} verhindert dies.}
-Manuelle Umbrüche können mit zwei Backslashes (\textbackslash\textbackslash) erzwungen werden.
-Dies sollte jedoch vermieden werden.
+\subsection{Continuous text}
+The easiest content that we can integrate into the document environment is continuous text. 
+We can write it directly into our source code. 
+Line breaks and multiple consecutive spaces are ignored by \LaTeX{}. 
+Blank lines create a new paragraph, that is indented by default.\footnote{The automatic indentation of new paragraphs can be prevented by using the command \code{latex}{\textbackslash noindent}.}
+Manual line breaks can be enforced with two backslashes (\textbackslash\textbackslash). 
+This should be avoided, though. 
 
-\subsection{Kommentare}
-Einige Zeichen sind für besondere Funktionen reserviert. 
-So bewirkt ein Prozent-Zeichen beispielsweise, dass der Rest einer Zeile vom Compiler ignoriert wird.
-Der Text erscheint also nicht im fertigen \acro{PDF}-Dokument.
-Dies kann nützlich sein, um während der Bearbeitung Notizen festzuhalten, ohne Einfluss auf das fertige Dokument zu nehmen.
-Wir sprechen hier von einem Kommentar.
+\subsection{Comments}
+Some characters are reserved for \LaTeX-specific commands, for instance, the percent sign. 
+Using a percent sign tells the \LaTeX{} compiler to ignore the rest of the line, so the text after the percent character will not appear in the generated \acro{PDF} document.
+This is called a \emph{comment}\textit{,}
+and it can be useful to take notes while working on a document without affecting the document itself. 
 
-Falls tatsächlich ein Prozentzeichen erscheinen soll, könnt ihr dies durch einen Backslash erreichen: \mintinline{latex}{\%}.
-Diese Lösung, die auch als Escaping bezeichnet wird, funktioniert auch für die Zeichen \#, \$, \&, \_, \{ und \}.
-Für den Backslash muss der Befehl \mintinline{latex}{\textbackslash} verwendet werden.\footnote{Eine Übersicht weiterer Sonderzeichen ist im zugehörigen \cref{sec:special-characters} zu finden.}
+There are a few more of these reserved characters, as we will see and learn to deal with in \cref{sec:more-special-characters}.
 
-\subsection{Abschnitte und Kapitel}
-Texte werden durch Überschriften in Abschnitte und Kapitel unterteilt.
-Immer nutzbar sind die in \cref{lst:headlines} dargestellten Befehle.
-\Example{lst:headlines}{basic-document-structure/headlines}{basic-document-structure/headlines_crop}{Überschriftenebenen}
-Je nach Dokumentklasse sind außerdem \mintinline{latex}{\chapter{Kapitel}} und \mintinline{latex}{\part{Teil}} verfügbar -- beispielsweise in Büchern.
-Mit Sternchen fallen bei allen diesen Befehlen die Nummerierung und der Eintrag im Inhaltsverzeichnis\footnote{Vgl. \cref{sec:table-of-contents}} weg: 
+\subsection{Sections and chapters}
+Continuous text can be structured by headings that divide the document into sections and chapters. 
+Needless to say, \LaTeX{} provides us with commands for that.
+The commands that are depicted in \cref{lst:headlines} can be used with any document class. 
 
-\begin{minted}{latex}
-\section*{Kommt nicht im Inhaltsverzeichnis vor}
-\end{minted}
+\Example{lst:headlines}{basic-document-structure/headlines}{basic-document-structure/headlines_crop}{Heading Levels}
 
-Ein alternativer Titel im Inhaltsverzeichnis kann als optionaler Parameter in eckigen Klammern zwischen dem Befehl und dem eigentlichen Titel angegeben werden. 
+Some document classes provide additional commands. In a \pkg{report}, you get \code{late}{\textbackslash chapter\{Chapter\}}, and in a \pkg{book}, additionally \code{latex}{\textbackslash part\{Part\}}.
+You can mark the command with an asterisk if you want to omit the numbering of a section and exclude it from the table of contents:\footnote{cf. \cref{sec:table-of-contents}}
 
-\begin{minted}{latex}
-\section[Titel im Verzeichnis]{Kapitelüberschrift}
-\end{minted}
+\codeblock{latex}{listings/basic-document-structure/section.tex}
 
-\subsection{Titelei}
-Ein einfacher Titel lässt sich im Dokument mit dem Befehl \mintinline{latex}{\maketitle} erzeugen.
-Die Werte für die Einträge müssen in der Präambel festgelegt werden. 
-Mehrere Autoren werden dabei mit \mintinline{latex}{\and} verbunden.
-Fehlt der Befehl \mintinline{latex}{\date}, wird per default das aktuelle Datum gesetzt.
-Die genaue Gestaltung hängt von der verwendeten Dokumentklasse ab.
+An alternative title for the table of contents can be declared as an optional 
+parameter in square brackets between the command and the actual title:
 
-\Example{lst:titles}{basic-document-structure/titles}{basic-document-structure/titles_crop}{Die Titelei}
+\codeblock{latex}{listings/basic-document-structure/title-in-toc.tex}
 
-\subsection{Verzeichnisse}\label{sec:table-of-contents}
+\subsection{Front matter}
+A simple front matter can be created by using the command \code{latex}{\textbackslash maketitle}. 
+The values to be inserted into the front matter must be specified within the preamble. 
+Multiple authors are joined by \code{latex}{\textbackslash and}.
+If the date is not specified by the \code{latex}{\textbackslash date} command, the current date will be inserted by default.
+The design of the front matter depends on the specified document class.
 
-Aus allen mit den oben genannten Befehlen eingefügten Abschnitten fügt der Befehl \mintinline{latex}{\tableofcontents} ein automatisch nummeriertes Inhaltsverzeichnis zusammen (wie zum Beispiel in \cref{lst:main-file} auf \cpageref{lst:main-file} zu sehen).
-Die Aufzählungszeichen, die Tiefe der Aufzählung und viele weitere Gestaltungselemente sind frei anpassbar.\footnote{Ein empfehlenswerter Blogpost hierzu ist unter \url{https://texblog.org/2011/09/09/10-ways-to-customize-tocloflot/} verfügbar.}
-Damit \LaTeX\ das Inhaltsverzeichnis vollständig baut, muss das Projekt zweimal kompiliert werden.
+\Example{lst:titles}{basic-document-structure/titles}{basic-document-structure/titles_crop}{The front matter}
 
-Neben dem Inhaltsverzeichnis stehen auch eine \mintinline{latex}{\listoffigures} (Abbildungsverzeichnis) und eine \mintinline{latex}{\listoftables} (Tabellenverzeichnis) zur Verfügung.
-Aufgeführt werden jeweils die Bild- oder Tabellenunterschriften.\footnote{Siehe hierzu \cref{sec:graphics} (Grafiken) und \cref{sec:tables} (Tabellen).}
+\subsection{Indices}\label{sec:table-of-contents}
+
+The command \code{latex}{\textbackslash tableofcontents} generates an automatically numbered table of contents by making use of the above-mentioned commands for dividing our text into sections and chapters (this can bee seen in \cref{lst:main-file} on \cpageref{lst:main-file}).
+
+The numbering style and depth, and many other options can, of course, be specified manually.\footnote{We recommend the following blogpost: \url{https://texblog.org/2011/09/09/10-ways-to-customize-tocloflot/}}
+For \LaTeX{} to create our table of contents properly, the project has to be compiled twice.
+
+Besides the table of contents, you can also generate a \code{latex}{\textbackslash listoffigures} (list of figures) and a \code{latex}{\textbackslash listoftables} (list of tables). 
+The captions of your figures and tables will appear within those indices.\footnote{cf. \cref{sec:graphics} (Graphics) and \cref{sec:tables} (Tables) for more information on captions}

content/basic-functionality.tex

@@ -1,77 +1,102 @@
-\chapter{Wie funktioniert \LaTeX?}
+\chapter{How does \LaTeX{} work?}
 \label{sec:basic-functionality}
 
-Programme zur Textverarbeitung und Dokumentenerstellung nutzen unterschiedliche Vorgehensweisen, um basierend auf einer bearbeiteten Datei ein Dokument zu erstellen.
-Bei der Arbeit mit Microsoft Word gilt die Regel: Ein als \acro{PDF} exportiertes Dokument sieht genauso aus wie das Quelldokument in Word. Dort wo eine Grafik in Word platziert wird, ist sie auch im \acro{PDF} aufzufinden. Anpassungen der Darstellung in MS Word und anderen bekannten Programmen führen also zu einer direkten optischen Veränderung im resultierenden Export. Diese Art der Formatierung wird \emph{What you see is what you get} genannt (kurz: \acro{WYSIWYG}). Inhalt und Struktur sind eng miteinander verbunden.
+Word processing and document creation programs have to decide how to translate user input into a document layout.
+There are different concepts to approach this topic.
+When working with Microsoft Word, the rule is: a document exported as \acro{PDF} looks exactly like the source document in Word. 
+Where a graphic is placed in Word, it is also found in the \acro{PDF}. 
+Adjustments to the appearance in Word and other popular programs thus result in a direct visual change. 
+This type of formatting is called \emph{What you see is what you get} (\acro{WYSIWYG} for short). 
+Content and formatting are closely linked.
 
-\LaTeX{} arbeitet hingegen nach dem Prinzip \emph{What you get is what you mean} (kurz: \acro{WYGIWYM}). Inhalt und Struktur sind stärker getrennt.
-Der Inhalt wird in einem Dokument in einfacher Textform platziert, zusammen mit sogenannten \emph{Befehlen}\textit{.} Die Kombination von inhaltlichem Text und Befehlen nennen wir auch Quelltext. Um die Darstellung des Inhalts anzupassen, ändern wir nicht den Text selbst, sondern fügen entsprechende Befehle hinzu. Diese werden von einem \emph{Compiler} verarbeitet, welcher die Darstellung je nach Befehl anpasst. Zeile für Zeile verarbeitet der Compiler Text und Befehle aus unserem Quelltext. Wenn der gesamte Quelltext von dem Compiler verarbeitet wurde, erhalten wir das finale Dokument. Es gibt zwar unterschiedliche Exportmöglichkeiten, meistens lassen wir uns das Dokument aber als \acro{PDF} ausgeben -- wie auch bei Word.
-% Alter Paragraph:
-%Der Compiler nimmt besagten Quelltext entgegen und liest ihn Zeile für Zeile.
-%Erkennt er einen Befehl, wird dieser verarbeitet. Verschiedene Befehle haben verschiedene Einflüsse auf das Endresultat, dazu später mehr. Wenn der gesamte Quelltext von dem Compiler verarbeitet wurde, erhalten wir das finale Dokument. Es gibt zwar unterschiedliche Exportmöglichkeiten, meistens lassen wir uns das Dokument aber als \acro{PDF} ausgeben -- wie auch bei Word.
+\LaTeX{}, on the other hand, works according to the principle \emph{What you get is what you mean} (\acro{WYGIWYM} for short). 
+Content and formatting are separated more clearly.
+The content is placed in a document in plain text form, together with so-called \emph{commands}. 
+The combination of text content and commands is also called \emph{source} code.
 
-Als kurzes Beispiel für einen Befehl dient uns hier das Hervorheben von Wörtern oder Sätzen. Der Befehl lautet \mintinline{latex}{\emph{}}. Den Text, den wir hervorheben möchten, schreiben wir im Quellcode innerhalb der geschweiften Klammern, etwa so: \mintinline{latex}{\emph{Guten Tag!}}. Im resultierenden \acro{PDF} erscheint dieser Text dann kursiv: \emph{Guten Tag!} Von dem Befehlsbezeichner und den Sonderzeichen ist keine Spur mehr zu sehen. Wir schreiben also keinen kursiven Text innerhalb des Quellcodes, sondern teilen dem Compiler einfach mit, dass bestimmte Wörter doch bitte hervorgehoben werden sollen.
+To customize the presentation of the content, we do not set the text appearance itself but add appropriate commands instead. 
+These are processed by a \emph{compiler}, which adjusts the resulting appearance depending on the command. 
+Line by line, the compiler processes text and commands from our source code. 
+When all the source code has been processed by the compiler, we get the final document. 
+There are different export options, but most of the time we output the document as a \acro{PDF}\,---\,just like in Word.
 
-Dieses einfache Beispiel verdeutlicht eine Stärke des \acro{WYGIWYM}-Prinzips. 
-Wir markieren Textelemente auf der semantischen Ebene und können die zugehörigen typographischen Anpassungen an zentraler Stelle vornehmen -- oder lassen \LaTeX{} die Konfiguration selbst erledigen.
-Wenn wir etwa die Art und Weise des Hervorhebens ändern möchten, dann können wir dies zentral konfigurieren. An allen Stellen, wo \mintinline{latex}{\emph{}} verwendet wird, wird das Endresultat entsprechend angepasst. Es besteht keine Notwendigkeit, an jeder einzelnen Stelle Anpassungen vorzunehmen. Das Prinzip ist ähnlich zu Formatvorlagen in Office-Programmen, wenn auch konsequenter und mächtiger. 
-% Überleitung zum nächsten Abschnitt??
+As a brief example for a command, we shall use the emphasis of words or sentences. 
+The command is \code{latex}{\textbackslash emph\{\}}. 
+We write the text we want to emphasize inside the curly braces in the source code, like this: 
+\code{latex}{\textbackslash emph\{Good morning!\}}. 
+In the resulting \acro{PDF}, this text will appear in italics: \emph{Good morning!} 
+There is no trace of the command identifier and the special characters. 
+You can see, we are not writing italic text inside the source code, we just tell the compiler that certain words should be emphasized by the use of a command.
 
-% TEMP/UNSURE
-%Wie man mit Word oder anderen Programmen ein \acro{PDF} generiert, wisst ihr vermutlich. Besonders kompliziert ist es nicht. Im Grunde benötigen wir nur das Programm selbst. 
-% OLD
-%Dieses einfache Beispiel verdeutlicht eine Stärke des \acro{WYGIWYM}-Prinzips. 
-%Wir markieren Textelemente auf der semantischen Ebene (\enquote{Dieser Text soll hervorgehoben werden.}) und können die zugehörigen typographischen Anpassungen (\enquote{Hervorgehobener Text wird kursiv gedruckt.}) an zentraler Stelle festlegen -- oder gleich \LaTeX{} überlassen.
-%Das Prinzip ist ähnlich zu Formatvorlagen in Office-Programmen, wenn auch konsequenter und mächtiger.
-%Basierend auf dem Text, den Befehlen und den Standard-Einstellungen des Compilers entsteht so das finale Dokument.
+This simple example illustrates a strength of the \acro{WYGIWYM} principle. 
+We mark text elements on a semantic level and can make the associated typographic adjustments centrally\,---\,or let \LaTeX{} do the configuration itself.
+For instance, if we want to change the way highlighting is done, we can configure this once. 
+At all places where \code{latex}{\textbackslash emph\{\}} is used, the final result will be adjusted accordingly. 
+There is no need to make adjustments at each occurrence of an emphasized word. 
+The principle is similar to style sheets in office programs, although more consistent and powerful.
 
-\section{Was brauchen wir dazu?}
+\section{What do we need to use \LaTeX{}?}
 \label{subsec:what-we-need}
 
-Möchten wir mit \LaTeX{} ein \acro{PDF}-Dokument generieren, so benötigen wir zumindest zwei Programme. Eines, um den Quelltext zu erstellen, und ein zweites, um den Quelltext zu verarbeiten. Letzteres ist der bereits erwähnte Compiler.
+If we want to generate a \acro{PDF} document with \LaTeX{}, we need at least two programs. 
+One to create the source code, and a second one to process the source code. 
+The latter is the already mentioned compiler.
 
-Grundsätzlich ist ein einfaches Textbearbeitungsprogramm zur Erstellung des Quelltextes ausreichend. Die meisten Betriebssysteme beinhalten solche Programme bereits. Vielleicht seid ihr schon mit Anwendungen wie Notepad++\footnote{Verfügbar unter \url{https://notepad-plus-plus.org/}.} vertraut, auch diese sind geeignet.
-Fortgeschrittene Programme wie TeXstudio\footnote{Verfügbar unter \url{https://www.texstudio.org/}.} oder Texmaker\footnote{Verfügbar unter \url{https://www.xm1math.net/texmaker/}.} integrieren zusätzliche Funktionen, welche die Verwendung von Befehlen erleichtern. Hier habt ihr freie Wahl.
-% Letzten Paragraphen irgendwie weniger abrupt beenden?
+In principle, a simple text editing program is sufficient for creating the source code. 
+Most operating systems provide such programs out of the box. 
+Maybe you are already used to applications like Notepad++,\footnote{Available at \url{https://notepad-plus-plus.org/}.} these are usable as well. 
+Then there are advanced programs like \TeX{}studio\footnote{Available at \url{https://www.texstudio.org/}.} or Texmaker\footnote{Available at \url{https://www.xm1math.net/texmaker/}.} which integrate additional functions that facilitate the use of commands.
+You are free to choose, but we recommend to use \TeX{}studio.
 
-Zum Kompilieren des Quelltexts wird, wie bereits erwähnt, ein Compiler benötigt.
-Der Compiler ist meist Teil einer Sammlung von Programmen und Paketen, die zusammen eine \LaTeX-Distribution bilden. 
-Auf die Hilfsprogramme werden wir für den Moment nicht näher eingehen.\footnote{Eines dieser Hilfsprogramme kommt später im Kapitel \ref{sec:literature} zum Einsatz, wenn wir Literatur referenzieren.} Die enthaltenen Pakete stellen verschiedene Befehle zur Verfügung.
+As mentioned before, we need a compiler to be able to compile our source code.
+The compiler is usually part of a collection of \emph{programs} and \emph{packages} which are together called a \LaTeX{} \emph{distribution}\textit{.} 
+The included packages provide various additional commands. 
+For now, we will skip over the many programs.\footnote{We will get to know one of these helper programs later on, in \ref{sec:literature}, when we are citing literature.}
 
-Wir verwenden den Compiler einer Distribution unserer Wahl. Bekannte Distributionen sind MiK\TeX,\footnote{Für Windows, macOS und Linux. Verfügbar unter \url{https://miktex.org/}.} Mac\TeX\footnote{Für macOS und Linux. Verfügbar unter \url{https://www.tug.org/mactex/}.} und \TeX{} Live.\footnote{Für Windows, macOS und Linux. Verfügbar unter \url{https://www.tug.org/texlive/}.}
-Installiert euch am besten gleich eine davon. Die Installation kann unter Umständen mehrere Stunden dauern. Manche Distributionen gibt es daher als kleine und als vollständige Variante zum Download. 
-Die vollständige Variante enthält alle Pakete, während in der normalen Version Pakete erst dann heruntergeladen werden, wenn sie benötigt werden.
-Die Entscheidung, ob ihr lieber zu Beginn oder später während des Arbeitens auf den Download wartet, können wir euch leider nicht abnehmen. 
+Multiple different \LaTeX{} distributions exist. 
+Some of the well-known ones are MiK\TeX,\footnote{For Windows, macOS and Linux. Available at \url{https://miktex.org/}.} Mac\TeX,\footnote{For macOS and Linux. Available at \url{https://www.tug.org/mactex/}.} and \TeX{} Live.\footnote{For Windows, macOS, and Linux. Available at \url{https://www.tug.org/texlive/}.}
+It is best to install one of them right away. 
+The installation may take several hours. 
+For this reason, some distributions are available for download in a small and a full version. 
+The full version contains all packages, while the small version downloads packages only when they are needed.
+Unfortunately, we cannot take away the decision if you would rather wait for the download at the beginning or later while you are working.
 
-\section{Die Befehle}
+\section{The commands}
 \label{subsec:command-structure}
-Die in Quelltext verwendeten Befehle folgen einem allgemeinen Aufbau:
-\begin{minted}{xml}
-\<befehl>[<optionale_parameter>]{<obligatorische_parameter>}
-\end{minted}
-Ein Befehl kann mehrere optionale und/oder obligatorische Parameter verwenden. Manche Befehle besitzen keine obligatorischen Parameter. Ein paar Beispiele sind in \cref{tbl:latex-commands} dargestellt.
+The commands used in source code follow a general structure:
+\codeblock{xml}{listings/basic-functionality/command-structure.txt}
+
+A command can use several optional and/or mandatory parameters. 
+Some commands have no mandatory parameters at all. 
+Some examples are shown in \cref{tbl:latex-commands}.
 
 \begin{table}[h!]
 	\widebox{
 		\begin{tabular}{@{}p{\widefigurewidth}p{\widefigurewidth}@{}}
 			\toprule
-			Befehl                                                  & Effekt                             \\
+			Command                                                  & Effect                             \\
 			\midrule
-			\mintinline{latex}{\newpage}                              & fügt eine neue Seite ein           \\
-			\mintinline{latex}{\textbf{Text}}                         & schreibt den übergebenen Text fett \\
-			\mintinline{latex}{\usepackage[utf8]{inputenc}}           & setzt die Textkodierung auf \acro{UTF-8}  \\
-			\mintinline{latex}{\documentclass[a4paper,12pt]{article}} & setzt die Dokumentenklasse         \\
-			\mintinline{latex}{\frac{3}{4}}               & fügt den mathematischen Bruch ein  \\
+			\code{latex}{\textbackslash newpage}                              & inserts a new page           \\
+			\code{latex}{\textbackslash textbf\{Text\}}                         & prints the text in bold font \\
+			\code{latex}{\textbackslash usepackage[utf8]\{inputenc\}}           & sets the text encoding to \acro{UTF-8}  \\
+			\code{latex}{\textbackslash documentclass[a4paper,12pt]\{article\}} & specifies the document class  \\
+			\code{latex}{\textbackslash frac\{3\}\{4\}}               & inserts a mathematical fraction  \\
 			\bottomrule
 		\end{tabular}
 	}
-	\caption{Beispiele für \LaTeX-Befehle}
+	\caption{Examples for \LaTeX-commands}
 	\label{tbl:latex-commands}
 \end{table}
 
-Sollte ein Befehl mehrere optionale Parameter erlauben, welche gleiche Eingabetypen akzeptieren, muss angegeben werden, welcher Parameter gemeint ist. Beispielsweise akzeptiert der Befehl für das Einbinden von Grafiken optionale Parameter für Breite und Höhe. Bei einer Eingabe von \mintinline{tex}|[12cm, 4cm]| wäre unklar, welcher Wert für welchen Parameter bestimmt ist. Um die Zuweisung zu konkretisieren, können die Parameter explizit angegeben werden:
-\begin{minted}{tex}
-\includegraphics[width=12cm, height=4cm]{bild.png}
-\end{minted}
+If a command allows multiple optional parameters that accept similar inputs, it is sometimes necessary to specify which parameter is meant. 
+For example, the command for embedding graphics accepts optional parameters for width and height. 
+If \mono{[12cm, 4cm]} were entered, it would be unclear which value is intended for which parameter. 
+To make the assignment more concrete, it is possible to specify the parameters 
+explicitly:
+\codeblock{latex}{listings/basic-functionality/parameters.tex}
+
+As the examples already show, many different commands can be used. 
+Some are intended for use in mathematical formulas, others allow the inclusion of graphics. 
+In the beginning, it will take some getting used to. 
+However, you don’t have to learn every single command by heart: As soon as you remember the most important commands, you can easily create simple documents and look up everything else.
 
-Wie die Beispiele bereits zeigen, können Befehle sehr unterschiedlich sein. Manche sind für Verwendung in mathematischen Formeln bestimmt, andere ermöglichen das Einbinden von Grafiken. Zu Anfang wird es gewöhnungsbedürftig sein, sich alle häufig vorkommenden Befehle zu merken -- aller Anfang ist bekanntlich schwer. Nach etwas Übung und Geduld sind einfache Dokumente aber im Handumdrehen erstellt. 

content/first-steps-with-latex.tex

@@ -1,44 +1,38 @@
-\chapter*{Erste Schritte mit \LaTeX}
-\addcontentsline{toc}{section}{Erste Schritte mit \LaTeX}
+\newpage
+\definecolor{latexblue}{rgb}{0.9,0.925,0.95}
+\pagecolor{latexblue}
 
-Dieses Skript dient als kurze Referenz zum Umgang mit LateX und als Übungsbeispiel für das LaTeX-Tutorium der Fachschaft WIAI.
-Viele Aufgaben erfordern es, das Skript selbst anzupassen.
-Das dafür benötigte Projektarchiv mit allen Quelltextdateien sowie die aktuellste Version dieses Skriptes sind auf Github\footnote{\url{https://github.com/fs-wiai/latex-script/releases}} zu finden. 
+\chapter*{First steps with \LaTeX}
+\addcontentsline{toc}{section}{First steps with \LaTeX}
 
-Bevor wir ins Arbeiten mit \LaTeX{} einsteigen können, müssen wir es natürlich zunächst installieren. 
-Außerdem müssen wir einige Anpassungen vornehmen, um mit diesem Projekt arbeiten zu können.
-Alle Schritte erläutern wir in den folgenden Kapiteln näher.
-Nach und nach werdet ihr so ein Verständnis der Arbeitsweise mit \LaTeX{} aufbauen.
-Für den Anfang folgt einfach der Anleitung.
-Achtet bitte darauf, dass ihr \emph{zuerst} den Compiler und \emph{danach} einen Editor installiert.
+This script serves as a short \LaTeX{} reference and as exercise material for the Fachschaft \acro{WIAI} \LaTeX{} workshop.
+All of the source files and the latest version of this script can be found on Github.\footnote{\url{https://github.com/fs-wiai/latex-script/releases}}
+
+The following instructions will equip you with the programs necessary to create documents with \LaTeX{}---they will be explained in the following chapters.
+Please, make sure to install the \emph{compiler first} and the \emph{editor afterwards}\textit{.}
 
 \section*{Compiler}
-Zunächst zum Compiler. Ihn brauchen wir, um den Quelltext, den wir schreiben, in ein \acro{PDF} umzuwandeln. Hier gibt es für verschiedene Betriebssysteme unterschiedliche Compiler, wie etwa MikTeX für Windows,\footnote{\url{https://miktex.org/download}} MacTex für MacOS\footnote{\url{http://tug.org/mactex/}} und TeXLive für Linux-Distributionen.\footnote{Sofern ihr eine debianbasierte Linux-Distribution verwendet, kann der Compiler mittels \mintinline{bash}{sudo apt install texlive-full} installiert werden. Für andere Distributionen findet ihr eine Anleitung unter \url{https://tug.org/texlive/doc/texlive-en/texlive-en.html\#installation}.} Bestenfalls installiert ihr die volle Version mit allen Paketen.
+Let’s start with the compiler.
+(Seriously!)
+We will need it to convert our \LaTeX{} documents into \acro{PDF}s.
+There are different compilers for different operating systems;
+for example, MikTeX for Windows,\footnote{\url{https://miktex.org/download}} Mac\TeX{} for macOS,\footnote{\url{http://tug.org/mactex/}} and \TeX{}Live for Linux distributions.\footnote{On Debian-based Linux distributions, install the compiler by executing \sh{sudo apt install texlive-full.}
+For other distributions, see \url{https://tug.org/texlive/doc/texlive-en/texlive-en.html\#installation}.}
+In case you get to choose, it is best to install the full version with all packages.
 
 \section*{Editor}
-Sobald ihr das gemacht habt, könnt ihr euch auch schon einen Editor 
-herunterladen, in dem ihr eure \LaTeX-Dokumente gerne schreiben möchtet. Dafür 
-ist eigentlich jeder Editor geeignet (notepad++, Atom, VS Code, usw.). Wir 
-empfehlen für Anfänger jedoch ein Programm, das \LaTeX-spezfische Funktionen 
-besitzt, wie etwa TeXstudio.\footnote{Eine aktuelle Version findet ihr unter 
-\url{https://www.texstudio.org/}.}
+As soon as you have installed the compiler, you can download an editor that you are going to use to write your \LaTeX{} documents.
+Any editor will do (notepad++, Atom, VS Code, etc.).
+However, for beginners, we recommend using \TeX{}studio,\footnote{You find the latest version on \url{https://www.texstudio.org/}.} a program that supports you with \LaTeX-specific features.
 
-\section*{Compilerbefehl ändern}
-Damit es beim Kompilieren dieses Dokuments nicht zu Fehlern kommt, müsst ihr 
-nun den Compilerbefehl ändern. Klickt dazu in TeXstudio zunächst auf die 
-Schaltfläche \emph{Optionen} und anschließend auf \emph{TeXstudio 
-konfigurieren \textellipsis}. Danach wird sich ein neues Fenster öffnen. Dort navigiert 
-ihr zum Bereich \emph{Befehle} und setzt bei \emph{PdfLaTeX} das Flag 
-\mintinline{bash}{-shell-escape}. In anderen Worten: Der Text bei 
-\emph{PdfLaTeX} sollte folgendermaßen lauten: 
-\mint{bash}{pdflatex -synctex=1 -interaction=nonstopmode -shell-escape 
-%.tex}
+\section*{Compiling for the first time}
+Open up the file \file{main.tex} in \TeX{}studio. 
+It can be found in our project directory.
+By pressing \faForward, it is converted into a a file called \file{main.pdf}.
+You should be able to find the latter by looking at the project directory in your file explorer.
+If your installation is not working yet, \TeX{}studio will show you an error message.
+Feel free to contact us in this case.\footnote{Find us at \url{https://www.uni-bamberg.de/wiai/fs}.}
+Otherwise, you are now ready to go!
 
-
-\section*{Das erste Mal kompilieren}
-Öffnet nun die Datei \mintinline{bash}{main.tex} im Wurzelverzeichnis des 
-Projektes und kompiliert sie durch Druck auf \faForward. 
-In dem Ordner, in dem die Datei liegt, sollten verschiedene neue Dateien erschienen sein.
-Die Datei \mintinline{bash}{main.pdf} enthält das kompilierte Dokument.
-Außerdem sind einige Hilfsdateien aufgetaucht, die der Compiler zum Beispiel nutzt, um das Inhaltsverzeichnis zu generieren.
-Damit seid ihr startklar!
+\newpage
+\nopagecolor

content/footnotes.tex

@@ -1,15 +1,18 @@
-\chapter{Fußnoten}
+\chapter{Footnotes}
 \label{sec:footnotes}
 
-Für Fußnoten gibt es den Befehl \mintinline{latex}{\footnote{text}}, der an der Stelle des Aufrufs automatisch die richtige Ziffer einfügt und den übergebenen Text in der Fußzeile erscheinen lässt.
-In Kombination mit dem Paket \mintinline{latex}{hyperref} sind die Fußnoten sowie URLs\footnote{Sofern sie über den Befehl \mintinline{latex}{\url{…}} gesetzt wurden.} zudem anklickbar.
-Beispiele findet ihr im gesamten Dokument.
-
-Das Paket \mintinline{latex}{footmisc} stellt verschiedene weitere Optionen für die Darstellung von Fußnoten zur Verfügung, die als optionale Parameter an den Befehl \mintinline{latex}{\usepackage} übergeben werden können:
+Whenever we want to include footnotes into our \LaTeX{} document, we can use 
+the command \code{latex}{\textbackslash footnote{<text>}}. At the position where we use 
+the command, the correct number will be inserted automatically, and the text 
+within the curly braces will appear in the footer. In combination with the 
+package \pkg{hyperref}, \acro{URL}s within footnotes become 
+clickable.\footnote{if we use the command \code{latex}{\textbackslash url{…}}}
+We can see examples for that in the whole document.
 
+The package \pkg{footmisc} provides us with additional options for how to display footnotes. They can be passed as optional parameters to the command \code{latex}{\textbackslash usepackage}:
 \begin{itemize}
-  \item \mintinline{latex}{\usepackage[perpage]{footmisc}} sorgt dafür, dass die Zählung der Fußnoten auf jeder Seite neu beginnt.
-  \item \mintinline{latex}{\usepackage[para]{footmisc}} lässt die Fußnoten in der Fußzeile als Fließtext (gegebenenfalls auch nebeneinander) erscheinen.
-  \item \mintinline{latex}{\usepackage[symbol]{footmisc}} bewirkt eine Nummerierung mit Symbolen (z.\,B. \textdagger, \textdaggerdbl) statt Ziffern.
+  \item \code{latex}{\textbackslash usepackage[perpage]\{footmisc\}} ensures that the count of footnotes begins at 1 for each new page.
+  \item \code{latex}{\textbackslash usepackage[para]\{footmisc\}} lets the footnotes within the footer appear as continuous text (i.\,e., the footnotes can also appear next to each other).
+  \item \code{latex}{\textbackslash usepackage[symbol]\{footmisc\}} causes a numbering with symbols (e.\,g.,  \textdagger, \textdaggerdbl) instead of numbers.
 \end{itemize}
 

content/formatting-paragraphs.tex

@@ -1,29 +1,32 @@
-\chapter{Absatzformatierung} % (fold)
+\chapter{Formatting Paragraphs} % (fold)
 \label{sec:formatting-paragraphs}
 
-\section*{Flattersatz}
+\section*{Ragged alignment}
 \label{sec:ragged-alignment}
-Standardmäßig setzt \LaTeX{} Fließtext im Blocksatz. 
-Flattersatz\footnote{Bekannt als links, rechts oder zentriert ausgerichteter Text in Programmen wie Word.} ist aber auch möglich. 
-Die Befehle \mintinline{tex}|\raggedright|, \mintinline{tex}|\raggedleft| und \mintinline{tex}|\centering| können dazu verwendet werden. 
-Diese Befehle beeinflussen die Umgebung, in der sie verwendet werden. 
-Dies kann zum Beispiel die \texttt{document}-Umgebung sein, dementsprechend würde sämtlicher Text des Dokuments beeinflusst werden.
-Alternativ existieren Umgebungen, welche die Absatzformatierung beeinflussen (\cref{lst:ragged-alignment}).
+By default, \LaTeX{} sets continuous text in full justification. 
+However, we can also switch to ragged alignment by using the commands 
+\code{latex}{\textbackslash raggedright}, \code{latex}{\textbackslash raggedleft}, and 
+\code{latex}{\textbackslash centering}. 
+These commands influence the environment that they are used in, e.\,g., the 
+\mono{document} environment. Correspondingly, the text within the whole 
+document is affected. 
+Alternatively, we can use dedicated environments in order to influence the 
+formatting
+of certain paragraphs (\cref{lst:ragged-alignment}).
 
-\example{lst:ragged-alignment}{formatting-paragraphs/ragged-alignment}{Flattersatz}
+\example{lst:ragged-alignment}{formatting-paragraphs/ragged-alignment}{Ragged 
+alignment}
 
-\section*{Einzüge und Abstände}
+\section*{Indentation and spacing}
 \label{sec:indents-and-parskips}
-Absätze werden standardmäßig durch Einzüge in der ersten Zeile des Absatzes verdeutlicht (\mintinline{tex}{\parindent}). 
-Stattdessen können auch vertikale Abstände zwischen den Absätzen verwendet werden (\mintinline{tex}{\parskip}). 
-Für beide Varianten gibt es einstellbare Parameter:
-\begin{minted}{tex}
-\setlength{\parindent}{0pt}
-\setlength{\parskip}{1em
-    plus .5em   % erlaubte Dehnung
-    minus .5em  % erlaubte Stauchung
-}
-\end{minted}
-Mit dem Befehl \mintinline{tex}{\noindent} kann für nur einen Absatz der Einzug abgeschaltet werden. 
-Für den ersten Absatz nach einer Überschrift wird standardmäßig automatisch kein Einzug eingefügt.
+Usually, we illustrate a new paragraph by indenting the first line of it 
+(\code{latex}{\textbackslash parindent}). 
+Alternatively, paragraph spacing, i.\,e., vertical space between paragraphs, 
+can be used (\code{latex}{\textbackslash parskip}).
+For both variants, there are adjustable parameters:
+\codeblock{latex}{listings/formatting-paragraphs/indentation.tex}
+
+\noindent We can use \code{latex}{\textbackslash noindent} to turn off the indentation for only one 
+paragraph. 
+For the first paragraph after a heading, there is usually no indentation. 
 

content/graphics.tex

@@ -1,64 +1,50 @@
-\chapter{Grafiken}
+\chapter{Graphics}
 \label{sec:graphics}
 
-Da wir in \LaTeX{} mit Plaintext-Dateien arbeiten, können wir Grafiken nicht – wie von Textverarbeitungsprogrammen gewohnt – einfach einbetten.
-Stattdessen werden externe Bilddateien über Befehle referenziert und dann erst beim Kompilieren eingebunden und positioniert.
+Since in \LaTeX{} we work with plain text, we cannot simply embed graphics into our text as we may be used to from other word processing programs. 
+Instead, we reference external image files by a command. The figure is then embedded and positioned at compile time.
 
-\section{Grafiken einfügen}
+\section{Inserting graphics}
 \label{sec:display-graphics}
-Damit Grafiken referenziert werden können, muss das Paket \texttt{graphicx} eingebunden werden. Zum Einfügen können dann folgende Befehle verwendet werden:  
+In order to be able to reference graphics, the package \texttt{graphicx} has to be included. For inserting a figure, we can use the following commands:
 
-\begin{minted}[tabsize=4]{latex}
-\begin{figure}
-	\includegraphics{<dateipfad>}
-	\caption[<kurztitel>]{<bildunterschrift>}
-\end{figure}
-\end{minted}
+\codeblock{latex}{listings/graphics/insert-graphics.tex}	
 
-\noindent Soll die Bildgröße angepasst werden, kann der \texttt{includegraphics}-Befehl abgeändert werden. 
-Die erwünschte Höhe und Breite können hier separat angegeben werden, etwa wie folgt: 
+\noindent The command \mono{includegraphics} can be used to change the image size. The desired height and width of the figure can be indicated separately, as illustrated by the following example:
 
-\begin{minted}{latex}
-\includegraphics[width=0.5\textwidth,height=5cm]{<dateipfad>}
-\end{minted}
+\codeblock{latex}{listings/graphics/image-size.tex}
 
-\section{Platzierung}
+\section{Positioning}
 \label{sec:graphics-placement}
-Ein interessanter Aspekt des What-you-get-is-what-you-mean-Paradigmas ist die Art und Weise, wie Grafiken positioniert werden können. 
-Standardmäßig erfolgt eine automatische Platzierung an einer vom Compiler berechneten, potenziell optimalen Stelle.
-Dabei werden verschiedene Layouts erstellt und danach bewertet, wie ansprechend das Ergebnis ist.
-Durch das Verschieben von Grafiken können typografische Schönheitsfehler wie Schusterjungen und Hurenkinder\footnote{Die erste (letzte) Zeile eines Absatzes steht allein als letzte (erste) Zeile auf der vorherigen (nächsten) Seite, vgl. \url{https://de.wikipedia.org/wiki/Hurenkind_und_Schusterjunge}.} weitestgehend vermieden werden. 
+One interesting aspect of the  what-you-get-is-what-you-mean paradigm is the way how graphics can be positioned. 
+The compiler creates multiple layouts and evaluates them. 
+By default, graphics are placed at the potentially optimal position that is calculated by the compiler.
+By moving them around, typographic blemishes like widows and orphans\footnote{The first (last) line of a paragraph appears alone as last (first) line on the previous (next) page, cf. \url{https://en.wikipedia.org/wiki/Widows_and_orphans}.} can be avoided. 
 
-Dies bedeutet aber auch, dass eine Grafik nicht notwendigerweise zwischen den zwei Textblöcken wie im Quelltext erscheint, sondern an anderer Stelle.
-Um im Text einen klaren Bezug zu einer gegebenenfalls anderswo platzierten Grafik herzustellen, können wir Labels verwenden, die wir in \cref{sec:references} erklären.
-Wir können diese Verschiebungen außerdem durch Hinzufügen eines optionalen Parameters zur \mintinline{latex}{figure}-Umgebung mehr oder minder rigoros begrenzen.
-Die verfügbaren Positionskürzel werden in \cref{tbl:placement-abbreviations} aufgelistet.
+As a consequence, graphics are not necessarily placed between the two text blocks that we specify, but at another position. 
+In order to reference a picture, that possibly is placed on another page, we can use labels, which are covered in \cref{sec:references}. 
+On top of that, we can limit the positioning of our image more or less rigorously by adding optional parameters to the \texttt{figure} environment. The available positioning shortcuts can be found in \cref{tbl:placement-abbreviations}.
 
 \begin{table}[h!]
-	\center
+	\centering
 	\begin{tabular}{cl}
 		\toprule
-		Kürzel & Position                              \\
+		Shortcut & Position                              \\
 		\midrule
-		h      & möglichst hier, wenn es gefällt           \\
-		t      & oberer Seitenrand \emph{(top)}        \\
-		b      & unterer Seitenrand \emph{(bottom)}    \\
-		p      & auf einer eigenen Seite \emph{(page)} \\
-		H      & Definitiv an dieser Stelle! (benötigt Paket \texttt{float}) \\
+		h      & here, if possible						\\
+		t      & on top of the page \emph{(top)}        \\
+		b      & at the bottom of the page \emph{(bottom)}    \\
+		p      & on its own page \emph{(page)} \\
+		H      & definitely here (requires package \texttt{float}) \\
 		\bottomrule
 	\end{tabular}
-	\caption{Kürzel zur Platzierung von Abbildungen}
+	\caption{Shortcuts for positioning graphics}
 	\label{tbl:placement-abbreviations}
 \end{table}
 
-\begin{minted}[tabsize=4]{latex}
-\begin{figure}[<positionskürzel>]
-	\centering
-	\includegraphics{<dateipfad>}
-\end{figure}
-\end{minted}
+\codeblock{latex}{listings/graphics/positioning.tex}
 
-Neben der vertikalen Positionierung spielt gegebenenfalls auch die horizontale Ausrichtung eine Rolle.
-Standardmäßig sind Grafiken linksbündig orientiert.
-Der Befehl \mintinline{latex}{\centering} zentriert alle folgenden Objekte bis zum Ende der aktuellen Umgebung.
-Soll sich die Zentrierung nur auf ein Objekt beziehen, kann dieses stattdessen mit \mintinline{latex}{\begin{center}} und \mintinline{latex}{\end{center}} umschlossen werden.
+Besides the vertical positioning, also the horizontal orientation may be of importance. 
+By default, graphics are left-justified. 
+The command \code{latex}{\textbackslash centering} centers all following objects in the current environment.
+If we want the centering to affect only one object, we can alternatively wrap it with \code{latex}{\textbackslash begin\{center\}} and \code{latex}{\textbackslash end\{center\}}.

content/lists.tex

@@ -1,22 +1,23 @@
-\chapter{Aufzählungen}
+\chapter{Lists}
 \label{sec:lists}
 
-Von Haus aus unterstützt \LaTeX\ drei Aufzählungstypen: ungeordnete und geordnete Listen sowie Definitionslisten.
-Zu jedem dieser Typen existieren eigene Umgebungen, die aber grundsätzlich gleich aufgebaut sind.
+Inherently, \LaTeX{} supports three types of lists: unordered, ordered, and description lists.
+For each of these types, there are dedicated environments whose structure is very similar.
 
-\example{lst:unordered-list}{lists/nested-list}{Beispielhafte ungeordnete Aufzählung}
+\example{lst:unordered-list}{lists/nested-list}{Examplary unordered list}
 
-In \cref{lst:unordered-list-code} werden verschiedene Listenelemente (\mintinline{latex}{\item}) von einer \mintinline{latex}{itemize}-Umgebung eingerahmt.
-Innerhalb eines Listenelements kann eine neue Listen\-umgebung eröffnet werden, um eine verschachtelte Liste zu erhalten.
-Ersetzt man \mintinline{latex}{itemize} durch \mintinline{latex}{enumerate}, erhält man bei sonst gleichem Quelltext eine geordnete Liste.
-Für etwas weniger gebräuchliche Definitionslisten muss die Umgebung \mintinline{latex}{description} verwendet werden.
-Außerdem erhalten die Elemente in eckigen Klammern den zu definierenden Begriff (\cref{lst:definition-list}).
+In \cref{lst:unordered-list-code}, different list items (\code{latex}{\textbackslash item}) are framed by an \mono{itemize} environment.
+Within a list item, we can open a new list environment to create a nested list.
+If we replace \mono{itemize} by \mono{enumerate}, the list becomes ordered without changing the source code any further.
+To make use of the less common description lists, we have to specify the environment \mono{description}.
+Moreover, the items need to be extended by the term to be defined, put in brackets (\cref{lst:description-list}).
 
-\Example{lst:definition-list}{lists/definition-list}{lists/definition-list_crop}{Beispielhafte Definitionsliste}
+\Example{lst:description-list}{lists/description-list}{lists/description-list_crop}{Exemplary description list}
 
-Die sehr großen Abstände zwischen einzelnen Listenelementen können durch das Paket \mintinline{latex}{paralist}\footnote{\url{https://www.ctan.org/pkg/paralist}} verringert werden.
-Hierzu wird nur der Umgebungsname ersetzt: \mintinline{latex}{compactitem} statt \mintinline{latex}{itemize}, \mintinline{latex}{compactenum} statt \mintinline{latex}{enumerate} und \mintinline{latex}{compactdesc} statt \mintinline{latex}{description}.
-Soll die Aufzählung im Fließtext erscheinen, bringt \mintinline{latex}{paralist} dafür die Umgebungen \mintinline{latex}{inparaenum} und \mintinline{latex}{inparaitem} mit.
+The exuberant spacing between list items can be reduced by utilizing the \mono{paralist}\footnote{\url{https://www.ctan.org/pkg/paralist}} package.
+To do so, we simply adjust the environment name: sh{compactitem} replaces sh{itemize}, sh{compactenum} replaces sh{enumerate}, and sh{compactdesc} replaces sh{description}.
+If the list ought to appear within a text body, \pkg{paralist} provides the extra environments \mono{inparaenum} and \mono{inparaitem}.
 
-Um das Aufzählungszeichen oder die Nummerierung anzupassen, kann das Paket \mintinline{latex}{enumitem}\footnote{\url{https://www.ctan.org/pkg/enumitem}} verwendet werden.
-\mintinline{latex}{\begin{enumerate}[label=\roman*]} erzeugt eine Liste mit römischen Zahlen. Für alphabetische Nummerierung sorgt der Parameter \mintinline{latex}{[label=\alph*]}.
+We can customize bullet and list numbering styles via the \pkg{enumitem}\footnote{\url{https://www.ctan.org/pkg/enumitem}} package.
+\code{latex}{\textbackslash begin\{enumerate\}[label=\textbackslash roman*]} produces a list with Roman numerals. 
+The parameter \code{latex}{[label=\textbackslash alph*]} inserts alphabetical numbering.

content/literature.tex

@@ -1,74 +1,68 @@
-\chapter{Literaturverwaltung}
+\chapter{Reference management}
 \label{sec:literature}
 
-Um die ersten Studien- oder Abschlussarbeiten in \LaTeX\ zu setzen, fehlt uns jetzt nur noch eine Möglichkeit, Literatur zu referenzieren.
-Unsere Literatursammlung liegt in der sogenannten .bib-Datei.
-Wenn wir aus unserem \LaTeX-Dokument darauf verweisen, kann uns das Programm Bib\TeX{} (ähnlich zum Compiler \acro{PDF}\LaTeX) an der richtigen Stelle die richtigen Zitationen in einem vorher festgelegten Bibliografiestil einfügen.
+For typesetting our first thesis in \LaTeX{}, the last core functionality to learn is citing literature.
+Our references are gathered in a bibliography file.
+Once we reference one of its entries from our \LaTeX{} document, Bib\TeX{} (a 
+program similar to the standard \sh{pdflatex} compiler)
+can insert automatically generated citations.
+It will format them in a bibliography style of our choice.
 
-\section{Die Bibliografie-Datei}
-In der .bib-Datei sammeln wir unsere Literatureinträge in einem Format, das durch Bib\TeX{} verarbeitbar ist.
-Einen beispielhaften Eintrag aus einer .bib-Datei zeigt \cref{lst:bibfile-sample-entry}.
+\section{The bibliography file}
+Our \textbf{bibliography collection} consists of multiple literature entries in a pre-defined format, such that they can be processed by Bib\TeX{}.
+An exemplary item can be seen in \cref{lst:bibfile-sample-entry}.
 
 \begin{figure}[H]
-  \begin{minted}[autogobble]{latex}
-  @article{turing1990, % Dokumentenart und Bezeichner für den \cite-Befehl
-    title={The chemical basis of morphogenesis}, % Titel
-    author={Turing, Alan Mathison}, % Autor
-    journal={Bulletin of mathematical biology}, % Titel des Journals
-    volume={52}, % Band des Journals
-    pages={153--197}, % Seitenzahl im Journal
-    year={1990}, % Erscheinungsjahr
-    publisher={Springer} % Verleger des Journals
-  }
-  \end{minted}
-  \caption{Beispielhafter Eintrag einer .bib-Datei}
+  \codeblock{bibtex}{listings/literature/bibliography-entry.bib}
+
+  \caption{Exemplary bibliography entry}
   \label{lst:bibfile-sample-entry}
 \end{figure}
 
-Nach einem \texttt{@}-Zeichen wird die Art des Literaturverzeichniseintrags angegeben (z.\,B. article, book, proceedings).
-Es folgt eine Auflistung wichtiger Attribute wie Titel, Autor:in und – abhängig vom Eintragstyp – weiterer Felder.
-Der erste Eintrag nach der öffnenden geschwungenen Klammer ist der wichtigste: 
-Unter diesem Kürzel wird der Eintrag später in \LaTeX{} angesprochen.
-Diese sogenannten Bib\TeX-Keys müssen eindeutig sein und können frei vergeben werden.
-Üblich sind Kombinationen aus Autor:innen, Publikationsjahren und Themen.
+The type of the bibliography entry is specified after the opening \mono{@} sign (article, book, proceedings, …).
+What follows is a list of important attributes like title and author.
+Whether they are required or not depends on the type of the entry.
+In any case, we will need the first entry after the opening braces: the Bib\TeX{} key.
+This is the identifier that we will use to reference the entry in our \LaTeX{} document.
+Bib\TeX{} keys can be chosen freely, but have to be unique.
+Typically, they will consist of a combination of authors, publication dates, and topics.\newpage
 
-Die .bib-Datei kann manuell zusammengetragen werden.
-Viel häufiger allerdings werden dafür Programme wie JabRef,\footnote{Vgl. \url{https://www.jabref.org/}.} Zotero\footnote{Vgl. \url{https://www.zotero.org/}.} oder das weit verbreitete Citavi\footnote{Vgl. \url{https://www.citavi.com/de}.} verwendet.
-Während JabRef direkt eine .bib-Datei als Datenbank verwendet, lassen sich Zotero- und Citavi-Projekte\footnote{Vgl. \url{https://www1.citavi.com/sub/manual5/de/exporting_to_bibtex.html}.} in .bib-Dateien exportieren.
+\textbf{Bibliography files} can be compiled manually, yet it is more common to use programs like JabRef,\footnote{Cf. \url{https://www.jabref.org/}.} Zotero\footnote{Cf. \url{https://www.zotero.org/}.} or the widely-used software Citavi\footnote{Vgl. \url{https://www.citavi.com/de}.}.
+While JabRef operates directly on your bibliography file, Zotero and Citavi projects\footnote{Vgl. \url{https://www1.citavi.com/sub/manual5/de/exporting_to_bibtex.html}.} can be exported to bibliography files to use them in \LaTeX{} documents.
 
-.bib-Datei-Einträge werden unter anderem auch von Google Scholar zur Verfügung gestellt (vgl. \cref{fig:google-scholar-bibtex}).
-Hierbei ist es wichtig, darauf zu achten, dass die Einträge einheitlich und möglichst vollständig sind.
-Als hochwertige (wenn auch leider nicht vollständige) Quelle für Bib\TeX-Einträge kann die dblp Computer Science Library\footnote{Verfügbar unter \url{https://dblp.org/search}.} dienen.
+\textbf{Bibliography entries} are provided by many academic search engines, including Google Scholar (cf. \cref{fig:google-scholar-bibtex}).
+When using them, make sure that the entries are cohesive across your reference collection and complete with regard to their attributes.
+A high-quality (although, unfortunately, incomplete) source for Bib\TeX{} entries is the dblp computer science bibliography.\footnote{Available at \url{https://dblp.org/search}.}
 
 \begin{figure}[H]
   \includegraphics[width=\textwidth]{graphics/google_bibtex1.jpg}  
   \includegraphics[width=\textwidth]{graphics/google_bibtex2.jpg}  
-  \caption{Bib\TeX-Einträge in Google Scholar abrufen}
+  \caption{Loading Bib\TeX{} entries from Google Scholar}
   \label{fig:google-scholar-bibtex}
 \end{figure}
 
-\section{Zitieren}
-Durch Bib\TeX{} wird \LaTeX{} um einige Befehle zum Zitieren erweitert (vgl. \cref{tbl:bibtex-commands}). 
-Zusätzlich benötigt wird das Paket \mintinline{sh}{natbib}.
+\section{Citing}
+Bib\TeX{} extends \LaTeX{} by several commands (cf. \cref{tbl:bibtex-commands}). 
+Make sure to include the \pkg{natbib} package for this purpose.
 
 \begin{table}[H]
   \centering
   \begin{tabular}{ll}
   \toprule
-  Funktion                 & Befehl \\ \midrule
-  Quelle zitieren          & \mintinline{latex}{\cite{<quelle>}} \\
-  Seite zitieren           & \mintinline{latex}{\cite[S. 15]{<quelle>}} \\
-  Weitere Zusätze zitieren & \mintinline{latex}{\cite[<präfix>][<suffix>]{<quelle>}} \\
-  .bib-Datei einbinden     & \mintinline{latex}{\bibliography{<.bib-datei>}} \\
-  Zitierstil ändern        & \mintinline{latex}{\bibliographystyle{<zitierstil>}} \\ \bottomrule
+  Function                 & Command \\ \midrule
+  Citing sources           & \code{latex}{\textbackslash cite\{<source>\}} \\
+  Citing pages             & \code{latex}{\textbackslash cite[p. 15]\{<source>\}} \\
+  Custom citations         & \code{latex}{\textbackslash cite[<prefix>][<suffix>]\{<source>\}} \\
+  Including the bibliography     & \code{latex}{\textbackslash bibliography\{<bibliographyfile>\}} \\
+  Setting the bibliography style & \code{latex}{\textbackslash bibliographystyle\{<style>\}} \\ \bottomrule
   \end{tabular}
-  \caption{Befehle zum Zitieren von Literatur}
+  \caption{Commands for citations}
   \label{tbl:bibtex-commands}
 \end{table}
 
-Als \mintinline{latex}{<quelle>} einer Zitation wird immer der Bib\TeX-Key angegeben.
-Verfügbare Zitierstile\footnote{Eine vollständigere Liste ist bei Overleaf zu finden: \url{https://www.overleaf.com/learn/latex/Biblatex_citation_styles}} sind zum Beispiel alpha, natdin und apa.
-Das Literaturverzeichnis erscheint immer an der Stelle, an der der Befehl \mintinline{latex}{\bibliography{…}} aufgerufen wurde.
-Zum Befehl \mintinline{latex}{\cite} existieren zahlreiche weitere Varianten.\footnote{Vgl. \url{https://www.economics.utoronto.ca/osborne/latex/BIBTEX.HTM.}}
+The \code{latex}{<source>} of a citation is always a Bib\TeX key.
+The list of available citation styles\footnote{Head to Overleaf for a rather complete list: \url{https://www.overleaf.com/learn/latex/Biblatex_citation_styles}} includes \mono{alpha}, \mono{natdin}, and \mono{apa}.
+The table of references will always appear where the \code{latex}{\textbackslash bibliography\{…\}} command was put.
+The \code{latex}{\textbackslash cite} command comes with many variants.\footnote{cf. \url{https://www.economics.utoronto.ca/osborne/latex/BIBTEX.HTM}}
 
-\Example{lst:natdin-example}{literature/natdin-example}{literature/natdin-example_bib}{Beispiel für Zitationen im Stil \mintinline{latex}{natdin}.}
+\Example{lst:natdin-example}{literature/natdin-example}{literature/natdin-example_bib}{Exemplary citations in the \mono{natdin} style.}

content/maths.tex

@@ -1,30 +1,33 @@
-\chapter{Mathematische Formeln}
+\chapter{Mathematical formulas}
 \label{sec:maths}
 
-Mathematische Formeln können nur im sogenannten Mathmode gesetzt werden, der innerhalb einer Zeile (auch als inline bekannt) durch zwei Dollarzeichen aktiviert wird.
-Außerdem gibt es eine Blockumgebung (vgl. \cref{lst:sample-math-environment}).
-Wichtige Pakete für mathematische Zeichen sind \mintinline{latex}{amsmath}, \mintinline{latex}{amsthm} und \mintinline{latex}{amssymb} der American Mathematical Society sowie \mintinline{latex}{mathtools}.
-Wie bei allen Umgebungen kann durch Angabe eines Asterisks (\textasteriskcentered) die Nummerierung der Gleichungen ausgeschaltet werden.
+Mathematical formulas are always set in \emph{math mode}, which, within a paragraph (referred to as \emph{inline}), can be turned on or off with a dollar sign.
+There is also a \emph{block} environment (cf. \cref{lst:sample-math-environment}).
+Important packages for mathematical features are the \texttt{amsmath}, 
+\pkg{amsthm}, and \pkg{amssymb} packages of the American Mathematical 
+Society, as well as \pkg{mathtools}.
+As with many other environments, adding an asterisk turns off the numbering.
 
-\example{lst:sample-math-environment}{maths/sample-math-environment}{Beispielhafte Matheumgebungen}
+\example{lst:sample-math-environment}{maths/sample-math-environment}{Exemplary math environments}
 
-\section{Einige Beispiele}
+\section{A few examples}
 %Die \cref{tbl:maths-common-commands,tbl:maths-logic-sets-braces} listen einige häufig in Formeln verwendeten Befehle auf.
 
 \begin{table}[H]
   \centering
   \begin{tabular}{ll}
   \toprule
-  Quelltext & Ergebnis \\ \midrule
-  \mintinline{latex}{\sqrt{16}} & $\sqrt{16}$ \\
-  \mintinline{latex}{\frac{3}{4}} & $\frac{3}{4}$ \\
-  \mintinline{latex}{e^{\pi}} & $e^{\pi}$ \\
-  \mintinline{latex}{\sum_{i=1}\^{n}x^2} & $\sum_{i=1}^{n}x^2$ \\
-  \mintinline{latex}{12 \leq 4 x^2 + 13} & $12 \leq 4 x^2 + 13$ \\
-  \mintinline{latex}{{n \choose k}} & ${n \choose k}$ \\
+  Source code & Result \\ \midrule
+  \code{latex}{\textbackslash sqrt\{16\}} & $\sqrt{16}$ \\
+  \code{latex}{\textbackslash frac\{3\}\{4\}} & $\frac{3}{4}$ \\
+  \code{latex}{e\textasciicircum\{\textbackslash pi\}} & $e^{\pi}$ \\
+  \code{latex}{\textbackslash sum\_\{i=1\}\textasciicircum\{n\}x\textasciicircum 2} & $\sum_{i=1}^{n}x^2$ \\
+  \code{latex}{12 \textbackslash leq 4 x\textasciicircum 2 + 13} & $12 \leq 4 x^2 + 13$ \\
+  \code{latex}{{n \textbackslash choose k}} & ${n \choose k}$ \\
   \bottomrule
   \end{tabular}
-  \caption{Häufig verwendete Befehle (Wurzel, Bruch, Exponent, Summe, Vergleichszeichen, Binomialkoeffizient). Durch \mintinline{latex}{^{…}} und \mintinline{latex}{_{…}} werden die Inhalte in den Klammern hoch- oder tiefgestellt.}
+	\caption{Frequently used commands (square root, fraction, power, sum, inequation, binomial coefficient). 
+	By \code{latex}{\textasciicircum\{…\}} and \code{latex}{\_\{…\}}, the content is set in super- or subscript.}
   \label{tbl:maths-common-commands}
 \end{table}
 
@@ -33,47 +36,48 @@ Wie bei allen Umgebungen kann durch Angabe eines Asterisks (\textasteriskcentere
     \centering
     \begin{tabular}{ll}
     \toprule
-    Quelltext & Ergebnis \\ \midrule
-    \mintinline{latex}{(x), [x], \lbrace x \rbrace, \lvert x \rvert} & $(x), [x], \lbrace x\rbrace, \lvert x\rvert$\\
-    \mintinline{latex}{\exists,\forall,\in,\notin,\infty} & $\exists,\forall,\in,\notin,\infty$ \\
-    \mintinline{latex}{\alpha, \beta, \Gamma, \Delta, \varepsilon, \pi} & $\alpha, \beta, \Gamma, \Delta, \varepsilon, \pi$ \\
-    \mintinline{latex}{\rightarrow, \leftarrow, \Rightarrow, \Leftarrow, \Leftrightarrow} & $\rightarrow, \leftarrow, \Rightarrow, \Leftarrow, \Leftrightarrow$ \\
-    \mintinline{latex}{(A \cup B) \cap C} & $(A \cup B) \cap C$ \\
-    \mintinline{latex}{(A \lor B) \land C} & $(A \lor B) \land C$ \\
-    \mintinline{latex}{(A \cdot B) \times C} & $(A \cdot B) \times C$ \\ \bottomrule
+    Source code & Result \\ \midrule
+    \code{latex}{(x), [x], \textbackslash lbrace x \textbackslash rbrace, \textbackslash lvert x \textbackslash rvert} & $(x), [x], \lbrace x\rbrace, \lvert x\rvert$\\
+    \code{latex}{\textbackslash exists,\textbackslash forall,\textbackslash in,\textbackslash notin,\textbackslash infty} & $\exists,\forall,\in,\notin,\infty$ \\
+    \code{latex}{\textbackslash alpha, \textbackslash beta, \textbackslash Gamma, \textbackslash Delta, \textbackslash varepsilon, \textbackslash pi} & $\alpha, \beta, \Gamma, \Delta, \varepsilon, \pi$ \\
+    \code{latex}{\textbackslash rightarrow, \textbackslash leftarrow, \textbackslash Rightarrow, \textbackslash Leftarrow, \textbackslash Leftrightarrow} & $\rightarrow, \leftarrow, \Rightarrow, \Leftarrow, \Leftrightarrow$ \\
+    \code{latex}{(A \textbackslash cup B) \textbackslash cap C} & $(A \cup B) \cap C$ \\
+    \code{latex}{(A \textbackslash lor B) \textbackslash land C} & $(A \lor B) \land C$ \\
+    \code{latex}{(A \textbackslash cdot B) \textbackslash times C} & $(A \cdot B) \times C$ \\ \bottomrule
     \end{tabular}
-    \caption{Klammerungen, Quantoren, griechische Buchstaben, Pfeile, Operatoren}
+    \caption{Brackets, quantifiers, greek letters, arrows, operators}
     \label{tbl:maths-logic-sets-braces}
   }
 \end{table}
 
-\section{Mitwachsende Klammern}
+\section{Growing brackets}
 
-Im Zusammenspiel mit Brüchen kommt es vor, dass Klammern mit ihrem Inhalt wachsen sollen.
-Hierfür muss dem Befehl zum Erzeugen der Klammern (\mintinline{latex}{(}, \mintinline{latex}{)}, \mintinline{latex}{[}, \mintinline{latex}{]}, \mintinline{latex}{\lbrace} und \mintinline{latex}{\rbrace}) jeweils ein Positionsmarker (\mintinline{latex}{\left} oder \mintinline{latex}{\right}) vorangestellt werden.
+Especially in combination with fractions, brackets should grow according to their content.
+This can be achieved by pre-pending each bracket (\code{latex}{(}, \code{latex}{)}, \code{latex}{[}, \code{latex}{]}, \code{latex}{\textbackslash lbrace} and \code{latex}{\textbackslash rbrace}) with a position marker (\code{latex}{\textbackslash left} or \code{latex}{\textbackslash right}).
 
-\example{lst:growing-brackets}{maths/growing-brackets}{Beispiel für mitwachsende Klammern}
+\example{lst:growing-brackets}{maths/growing-brackets}{Example for growing brackets}
 
-\section{Darstellung von Grenzen}
+\section{Lower and upper bounds}
 
-Mit dem Befehl \mintinline{latex}{\limits} lassen sich die Grenzen von Integralen unter und über dem Integralzeichen darstellen.
-Bei Summen, Produkten und Grenzwerten geschieht das automatisch (vgl. \cref{lst:limits}).
-Im Fließtext eignet sich \mintinline{latex}{\limits} nur bedingt.
+The \code{latex}{\textbackslash limits} command renders lower and upper bounds of integrals above and below the integral sign.
+Sums, products, and limits do this 
+automatically (cf. \cref{lst:limits}).
+For inline formulas, \code{latex}{\textbackslash limits} are of bounded suitability.
 
-\example{lst:limits}{maths/limits}{Grenzen von Summen, Produkten, Grenzwerten und Integralen}
+\example{lst:limits}{maths/limits}{Lower and upper bounds of sums, products, limits and integrals}
 
-\section{Ausrichtung mehrerer Gleichungen}
+\section{Aligning equations}
 
-Die Umgebung \mintinline{latex}{align} erlaubt es, Gleichungen zum Beispiel am \texttt{=}-Zeichen auszurichten (vgl. \cref{lst:math-alignment-example}).
-Ausgerichtet wird dabei analog zu Tabellen am \texttt{\&}-Zeichen.
-Zeilenumbrüche werden durch zwei Backslashes markiert.
+The \mono{align} environment allows to align multiple equations horizontally, e.\,g., at the \mono{=} sign (\cref{lst:math-alignment-example}).
+As in tables, the \mono{\&} sign is used to specify anchorage points.
+Line breaks are denoted by two backslashes.
 
-\Example{lst:math-alignment-example}{maths/align-example}{maths/align-example_crop}{Am Gleichheitszeichen ausgerichtete Gleichungen}
+\Example{lst:math-alignment-example}{maths/align-example}{maths/align-example_crop}{Equations aligned at equals signs}
 
-\section{Mengenschreibweise}
+\section{Text in math mode}
 
-Manchmal ist es notwendig, im Zusammenhang mit der Mengenschreibweise Prädikate unter Verwendung von textuellen Beschreibungen oder längeren Funktionsnamen zu definieren.
-Im Mathmode wird die Zeichensetzung von \LaTeX{} nicht auf Fließtext, sondern auf Formeln ausgerichtet, was zu ungünstigen Anordnungen zusammenhängender Buchstabenketten führt.
-Für diesen Fall gibt es den Befehl \mintinline{latex}{\mathrm{}} (\enquote{math roman}, vgl. \cref{lst:set-builder-notation}).
+Sometimes sets have to be defined in terms of textual descriptions or longer function names.
+The \LaTeX{} math mode assumes that letters are variables rather than text, which creates problems when they are indeed supposed to be entire words.
+For this case, there is the \code{latex}{\textbackslash mathrm\{\}} command (\enquote{math roman}, c.\,f. \cref{lst:set-builder-notation}).
 
-\example{lst:set-builder-notation}{maths/set-builder-notation}{Probleme in der Mengenschreibweise und ihre Lösung}
+\example{lst:set-builder-notation}{maths/set-builder-notation}{Problems arising from intensional set notation and their solution}

content/project-structure.tex

@@ -1,21 +1,26 @@
-\chapter{Projektstruktur}
+\chapter{Project structure}
 \label{sec:project-structure}
 
-In den bisherigen Kapiteln haben wir nur sehr kurze \LaTeX{}-Beispiele gesehen. Natürlich kann \LaTeX{} aber auch verwendet werden, um größere Dokumente und Projekte zu erstellen, wie etwa eine Abschlussarbeit. 
-Um nicht den Überblick im Quellcode zu verlieren und zu vermeiden, dass Quelldateien zu lang werden, ist eine sinnvolle Strukturierung eines größeren \LaTeX{}-Projektes ratsam. Hierfür wird der Quellcode in verschiedene Dateien aufgeteilt, welche in den folgenden Abschnitten näher beleuchtet werden.
+In the previous chapters, we have only seen very short \LaTeX{} examples. \LaTeX{} can of course also be used to create larger documents and projects, such as a thesis. 
+In order not to lose the overview in the source code and to avoid that source files become too long, a reasonable structuring of a larger \LaTeX{} project is advisable. For this purpose, the source code is divided into different files, which will be discussed in more detail in the following sections.
 
-\section{Hauptdatei} Typischerweise wird bei größeren Projekten mit einer Hauptdatei gearbeitet, die gerne \texttt{main.tex} genannt wird. Sie ist sozusagen das Skelett des Projektes und enthält damit dessen Grundgerüst inklusive der Präambel. In dieser Hauptdatei werden Titel, Inhaltsverzeichnis sowie die einzelnen Kapitel einer Arbeit eingebunden (vgl. \cref{lst:main-file}). Die Einbindung der einzelnen Abschnitte kann entweder mittels \mintinline{latex}{\input{...}} oder \mintinline{latex}{\include{...}} erfolgen. Beide verlangen als Argument den Pfad zur Datei, die eingebunden werden soll. Auf die Unterschiede zwischen den beiden Befehlen gehen wir später noch ein (vgl. \cref{sec:input-vs-include}).
-  
-\example{lst:main-file}{project-structure/main-file}{Typische Struktur einer Hauptdatei in \LaTeX{}}
- 
-\section{Abschnittsdateien}
- Abschnittsdateien sind Dateien, die innerhalb der Hauptdatei eingebunden werden. Diese können in einer Abschlussarbeit beispielsweise einzelne Kapitel sein. Grundsätzlich ist man aber ganz frei in der Entscheidung, wie granular die Aufteilung des Inhaltes in einzelne Dateien gestaltet werden soll.
- Die Dateien, die durch die Hauptdatei eingebunden werden, enthalten keine Präambel, da diese ja schon in der Hauptdatei vorhanden ist. Auch die Befehle \mintinline{latex}{\begin{document}} und \mintinline{latex}{\end{document}} tauchen nicht noch mal auf.
- 
-\section{Input oder Include?}
+\section{Main file}
+
+In large projects, we typically use one main file, which is often called \file{main.tex}. It is, in a sense, the structural skeleton of the project, as it contains the basic structure including the preamble. The title, table of contents, as well as the individual chapters of a work are integrated in this main file (cf.\ \cref{lst:main-file}). The inclusion of the individual sections can be done either by \code{latex}{\textbackslash input\{...\}} or \code{latex}{\textbackslash include\{\textellipsis\}}. Both require the path to the file to be included as an argument. We will discuss the differences between the two commands later (see \cref{sec:input-vs-include}).
+
+\example{lst:main-file}{project-structure/main-file}{Typical structure in a main file \LaTeX{}}
+
+\section{Section files}
+Section files are files that are included within the main file. In a thesis, for example, these can be individual chapters. You are free to decide how granular the division of the content into individual files should be.
+The files that are included by the main file do not contain a preamble, since this is already present in the main file. Neither do the commands \code{latex}{\textbackslash begin\{document\}} and \code{latex}{\textbackslash end\{document\}} appear again.
+
+\section{Input or include?}
 \label{sec:input-vs-include}
-Kommen wir nun zu den Unterschieden zwischen den beiden möglichen Befehlen zum Einbinden von \LaTeX-Dateien. Kurz zusammengefasst weisen \mintinline{latex}{\include} und \mintinline{latex}{\input} Unterschiede in den folgenden drei Aspekten auf: Die Art und Weise, wie der Pfad zur einzubindenden Datei angegeben wird, die Möglichkeit der Schachtelung von Einbindungen und ob für jeden Abschnitt eine neue Seite angefangen wird.
- 
-Benutzt man den Befehl \mintinline{latex}{\input}, kann die Dateiendung \texttt{.tex} angegeben werden, sie ist aber nicht zwingend notwendig. Außerdem kann man die Einbindung von Dateien schachteln: Eine Datei, die mit \mintinline{latex}{\input} eingebunden wurde, kann wiederum mit dem gleichen Befehl eine andere Datei einbinden. Die Dateien, die eingebunden wurden, werden im fertigen Dokument eingefügt, ohne dass dabei eine neue Seite für den eingebundenen Abschnitt angefangen wird (vgl. \cref{lst:main-file}).
- 
-Anders verhält sich der Befehl \mintinline{latex}{\include}: Hier wird die Dateiendung \texttt{.tex} für die eingebundenen Kapitel \emph{nicht} mit angegeben. Die Schachtelung von Einbindungen ist nicht möglich. Für jede eingebundene Datei wird außerdem eine neue Seite erzeugt. 
+
+Let us now turn to the differences between the two possible commands for including \LaTeX{} files. Briefly summarized, \code{latex}{\textbackslash include} and \code{latex}{\textbackslash input} have differences in the following three aspects: The way in which the path to the file to be included is specified, the possibility of nesting inclusions, and whether a new page is started for each section.
+
+If you use the command \code{latex}{\textbackslash input}, you can specify the file extension \mono{.tex}, but it is not mandatory. It is also possible to nest the inclusion of files: A file included with \code{latex}{\textbackslash input} can in turn include another file with the same command. The files that have been included are inserted in the finished document without starting a new page for the included section (cf. \cref{lst:main-file}).
+
+The command \code{latex}{\textbackslash include} behaves differently: Here, the file 
+extension \mono{.tex} \emph{must} be omitted. Nesting of embeddings is not 
+possible. Also, a new page is created for each included file.

content/prospects.tex

@@ -1,13 +1,12 @@
-\chapter{Ausblick}
+\chapter{Prospects}
 \label{sec:prospects}
 
-Natürlich konnten wir euch in diesem knappen Rahmen nicht ansatzweise zeigen, was \LaTeX{} alles zu bieten hat.
-In diesem letzten Abschnitt haben wir daher ein paar Informationen gesammelt, die euch dabei helfen sollen, selbständig tiefer einzusteigen.
+Obviously, in this script, we were not able to show you the least of what \LaTeX{} has to offer. 
+Therefore, in this last section, we gathered some information to help you to go further into depth by yourself.
 
-\section{Pakete}
+\section{Packages}
 
-Eine Auswahl an Paketen haben wir euch bereits vorgestellt, es gibt aber noch ein paar tausend weitere.
-Für einige häufig benötigte Features haben wir euch hier eine kurze Liste passender Pakete zusammengestellt:
+We already have presented a selection of packages. However, there are thousands more of them. In the following sections we have put together some packages for frequently needed features: 
 
 \begin{figure}[p]
 	\widebox{
@@ -26,14 +25,14 @@ Für einige häufig benötigte Features haben wir euch hier eine kurze Liste pas
 		\colrules
 		% Left caption:
 		\begin{subfigure}[t]{\widefigurewidth}
-			\caption{Vektorgrafiken mit TikZ}
+			\caption{Vector graphics with \pkg{TikZ}}
 			\centering\tiny{\url{https://texample.net/tikz/examples/coffee-cup/}}
 			\label{fig:tikz-example}
 		\end{subfigure}
 		\hspace{\widefiguregap}
 		% Right caption:
 		\begin{subfigure}[t]{\widefigurewidth}
-			\caption{Konstituentenbäume mit qtree}
+			\caption{Parse trees with \pkg{qtree}}
 			\centering\tiny{\url{https://www.ling.upenn.edu/advice/latex/qtree/}}
 			\label{fig:qtree-example}
 		\end{subfigure}
@@ -54,87 +53,90 @@ Für einige häufig benötigte Features haben wir euch hier eine kurze Liste pas
 		\colrules
 		% Left caption:
 		\begin{subfigure}[t]{\widefigurewidth}
-			\caption{Beweisbäume mit prftree}
+			\caption{Proof trees with \pkg{prftree}}
 			\centering\tiny{\url{https://ftp.gwdg.de/pub/ctan/macros/latex/contrib/prftree/}}
 			\label{fig:prftree-example}
 		\end{subfigure}
 		\hspace{\widefiguregap}
 		% Right caption:
 		\begin{subfigure}[t]{\widefigurewidth}
-			\caption{Chemische Strukturformeln mit chemfig}
+			\caption{Chemical structural formulas with \pkg{chemfig}}
 			\centering\tiny{\url{http://latex-cookbook.net/cookbook/examples/benzene-ring/}}
 			\label{fig:chemfig-example}
 		\end{subfigure}
 		\medskip
 	}
 	% General caption:
-	\caption{Beispiele zu verschiedenen Paketen}
+	\caption{Examples for some packages}
 	\label{fig:package-examples}
 \end{figure}
 
 
 \begin{description}
-	\item[Stichwortverzeichnisse]
-		können mit \texttt{makeidx} automatisiert erstellt werden.\footnote{\url{https://www.ctan.org/pkg/makeidx}}
-		Mit \mintinline{tex}{\index{…}} werden im Text einzelne Stichwörter ausgezeichnet, der Befehl \mintinline{tex}{\printindex} sammelt sie in einem Verzeichnis mit Referenzen.
-	\item[Vektorgrafiken]
+	\item[Indices]
+		can be created automatically with \pkg{makeidx}.\footnote{\url{https://www.ctan.org/pkg/makeidx}}
+		By using \code{latex}{\textbackslash index\{…\}}, one can mark entries for the index. With \code{latex}{\textbackslash printindex}, an index with references is compiled out of them.
+	\item[Vector graphics]
 		(\cref{fig:tikz-example})
-		lassen sich mit \texttt{TikZ} (rekursives Akronym für \emph{TikZ ist kein Zeichenprogramm}) direkt im \LaTeX{}-Code erstellen.\footnote{\url{https://www.ctan.org/pkg/pgf}}
-		Achtung: Dieses Paket ist sehr mächtig, aber nicht unbedingt einsteigerfreundlich.
-		Bevor ihr damit etwas von Grund auf selbst gestaltet, empfehlen wir euch, mit einigen der Beispiele bei \TeX{}ample\footnote{\url{https://texample.net/tikz/examples/}} zu experimentieren.
-		Für bestimmte Anwendungsfälle gibt es aber auch spezielle Pakete, die dann meist einfacher zu handhaben sind:
-	\item[Konstituentenbäume,]
-		die Sätze in ihre grammatikalischen Bestandteile zerlegen (\cref{fig:qtree-example}), erzeugt \texttt{qtree}.\footnote{\url{https://ctan.org/pkg/qtree}}
-	\item[Beweisbäume,]
-		wie sie in der Logik benötigt werden (\cref{fig:prftree-example}), erzeugt \texttt{prftree}.\footnote{\url{https://www.ctan.org/pkg/prftree}}
-	\item[Chemische Strukturformeln]
+				can be \enquote{drawn} directly in the \LaTeX{} source code with \pkg{TikZ} (recursive acronym for \emph{TikZ ist kein Zeichenprogramm}, in English: \emph{TikZ is not a drawing program}).\footnote{\url{https://www.ctan.org/pkg/pgf}}
+		Caution: This package is very powerful, but not necessarily beginner-friendly.
+		Before creating vector graphics from scratch, we recommend you to experiment with some of the examples at \TeX{}ample\footnote{\url{https://texample.net/tikz/examples/}}. 
+		Also, for certain use cases, there are special packages that are easier to handle than \enquote{raw} TikZ:
+	\item[Parse trees]
+		that divide sentences into their grammatical components (\cref{fig:qtree-example}) can be created with \pkg{qtree}.\footnote{\url{https://ctan.org/pkg/qtree}}
+	\item[Proof trees,]
+		that are often used in logics (\cref{fig:prftree-example}), can be drawn with the package \pkg{prftree}.\footnote{\url{https://www.ctan.org/pkg/prftree}}
+	\item[Chemical structural formulas]
 		(\cref{fig:chemfig-example})
-		können unter anderem mit dem Paket \texttt{chemfig} erzeugt werden.\footnote{\url{https://www.ctan.org/pkg/chemfig}}
-	\item[Farbe]
-		bringt \texttt{xcolor} in eure Dokumente.\footnote{\url{https://www.ctan.org/pkg/xcolor}}
-	\item[Notizen,]
-		die ihr bei der Abgabe garantiert nicht überseht, fügt \texttt{todonotes} ein.\footnote{\url{https://www.ctan.org/pkg/todonotes}}
-		Damit könnt ihr markieren, was ihr noch \todo{Nicht ändern, das ist ein Beispiel.}ändern oder einfügen wollt.
-	\item[Seiten aus anderen \acro{PDF}-Dateien]
-		integriert ihr mit \texttt{pdfpages}.\footnote{\url{https://www.ctan.org/pkg/pdfpages}}
-		Das eignet sich sehr gut, um Ausgaben anderer Programme in eure Arbeit zu integrieren, beispielsweise in einem Anhang. 
-		Einmal kompilieren, und schon ist auch der Anhang wieder auf dem neuesten Stand, wenn das externe Programm etwas geändert hat.
-	\item[Verschachtelte Abbildungen]
-		und die nahezu beliebige Positionierung von Bildunterschriften ermöglicht \texttt{subcaption}.\footnote{\url{https://www.ctan.org/pkg/subcaption}}
-		Davon haben wir auch in diesem Dokument ausgiebig Gebrauch gemacht.
-	\item[Tabellen]
-		können noch sehr viel flexibler gestaltet werden, als wir es hier gezeigt haben.
-		Dabei helfen unter anderem die Pakete
-		\texttt{colortbl},\footnote{\url{https://www.ctan.org/pkg/colortbl}}
-		\texttt{tabularx},\footnote{\url{https://www.ctan.org/pkg/tabularx}}
-		\texttt{multirow},\footnote{\url{https://www.ctan.org/pkg/multirow}}
-		\texttt{makecell}.\footnote{\url{https://www.ctan.org/pkg/makecell}}
+		can, amongst others, be created with  \pkg{chemfig}.\footnote{\url{https://www.ctan.org/pkg/chemfig}}
+	\item[Colors]
+		for your documents are provided by \pkg{xcolor}.\footnote{\url{https://www.ctan.org/pkg/xcolor}}
+	\item[Notes]
+		that you cannot overlook can be created with \pkg{todonotes}.\footnote{\url{https://www.ctan.org/pkg/todonotes}}
+		With this package, you can mark what you still \todo{Please do not change. This is an example.} have to change within your document.
+	\item[Pages of other \acro{PDF} files]
+		can be integrated into the source code with the \texttt{pdfpages}\footnote{\url{https://www.ctan.org/pkg/pdfpages}} package.
+		It comes in very handy whenever one needs the output of external programs in the document, for example, in the appendix.
+		Just compile the document one more time and the appendix is up to date again, if the external program has changed something.
+	\item[Nested graphics]
+		and the positioning of captions at almost any place are provided by  
+		\pkg{subcaption}.\footnote{\url{https://www.ctan.org/pkg/subcaption}}
+		We also made extensive use of this package.
+	\item[Tables]
+		can be designed much more flexibly than what we have shown here. 
+		The following packages can help you with that:
+		\pkg{colortbl},\footnote{\url{https://www.ctan.org/pkg/colortbl}}
+		\pkg{tabularx},\footnote{\url{https://www.ctan.org/pkg/tabularx}}
+		\pkg{multirow},\footnote{\url{https://www.ctan.org/pkg/multirow}}
+		\pkg{makecell}.\footnote{\url{https://www.ctan.org/pkg/makecell}}
 \end{description}
 
-\noindent Eigentlich kein Paket, sondern eine weitere Dokumentenklasse ist \textbf{beamer:} Damit könnt ihr \textbf{Bildschirmpräsentationen} mit \LaTeX{} erstellen.
-Informationen und Beispiele dazu gibt es bei Overleaf\footnote{\url{https://www.overleaf.com/learn/latex/Beamer}} –
-womit wir schon beim nächsten Abschnitt sind:
+\noindent \mono{beamer}, which is not a package, but another document class, can be used to create \textbf{slide shows}
+with \LaTeX{}. Information on the document class and examples are available at Overleaf,\footnote{\url{https://www.overleaf.com/learn/latex/Beamer}} which brings us to the next section:
 
-\section{Hilfe und Informationen}
+\section{Help and information}
 
-Eine deutlich ausführlichere Einführung in \LaTeX{} bieten die \textbf{Wikibooks.}
-Das deutschsprachige Wikibook\footnote{\url{https://de.wikibooks.org/wiki/LaTeX-Kompendium}} ist dabei noch etwas unvollständiger als das englischsprachige.\footnote{\url{https://en.wikibooks.org/wiki/LaTeX}}
-Beide verweisen bei Bedarf auf zusätzliche Pakete.
+\textbf{Wikibooks} provides you with a much more detailed introduction into \LaTeX{}. Note that the German version\footnote{\url{https://de.wikibooks.org/wiki/LaTeX-Kompendium}} is less complete than the English one.\footnote{\url{https://en.wikibooks.org/wiki/LaTeX}}
+If required, both refer to additional packages.
 
-Falls ihr mehr Informationen zu einem bestimmten Paket sucht, ist \acro{\textbf{CTAN}}\footnote{\url{https://ctan.org/}} die zentrale Anlaufstelle.
-Dort findet ihr zu jedem Paket die offizielle Dokumentation als \acro{PDF}-Dokument.
-Darin sind vor allem die ersten Abschnitte interessant, weiter hinten folgen Implementierungsdetails, die ihr normalerweise nicht braucht.
+Whenever you need information on certain packages, \acro{\textbf{CTAN}}\footnote{\url{https://ctan.org/}} is your place to go. 
+For each package, you can find the official documentation as a \acro{PDF} file there.
+Within this file, the first paragraphs are usually the most interesting. They are 
+followed by implementation details, that you normally do not need.
 
-Wenn die Dokumentation zu theoretisch ist und ihr auf der Suche nach praktischen Beispielen seid, kann \textbf{Overleaf}\footnote{\url{https://www.overleaf.com/}} weiterhelfen.
-Das Portal ist primär ein kollaborativer Online-\LaTeX-Editor, ihr findet dort aber auch einige Vorlagen\footnote{\url{https://www.overleaf.com/latex/templates}} für verschiedene Arten von Dokumenten (Lebensläufe, Abschlussarbeiten u.\,v.\,m.).
-Speziell zu TikZ bietet \textbf{\TeX{}ample}\footnote{\url{https://texample.net/}} eine Vielzahl an Beispielen.
+If the official documentation is too theoretical, and you prefer a more hands-on approach, \textbf{Overleaf}\footnote{\url{https://www.overleaf.com/}} can help you out.
+Primarily, it is a collaborative online \LaTeX{} editor. However, you can find 
+multiple templates\footnote{\url{https://www.overleaf.com/latex/templates}} for 
+different types of documents (CVs, theses, \textellipsis) there.
 
-Bei konkreten Fragen oder Problemen hilft – wie üblich – die Frage-Antwort-Plattform \textbf{Stackexchange} weiter:
-Es gibt dort auch eine \TeX-Community.\footnote{\url{https://tex.stackexchange.com/}}
-Und selbstverständlich könnt ihr euch auch immer gerne uns wenden:
+If you are looking for examples dedicated to TikZ, \textbf{\TeX{}ample}\footnote{\url{https://texample.net/}} provides you with multiple of them.
+
+For concrete questions, the question-answering platform \textbf{Stackexchange} is a good place to go: There even is a \TeX{} community there.\footnote{\url{https://tex.stackexchange.com/}}
+
+~\newline\noindent Of course, you can always contact us with your questions:
 \begin{compactitem}
-	\item per Mail an \href{mailto:fachschaft-wiai.stuve@uni-bamberg.de}{fachschaft-wiai.stuve@uni-bamberg.de},
-	\item telefonisch unter +49951\,863\,1219
-	\item oder in unserem Büro in WE5/02.104.
+	\item via mail to \href{mailto:fachschaft-wiai.stuve@uni-bamberg.de}{fachschaft-wiai.stuve@uni-bamberg.de},
+	\item via phone at +49951\,863\,1219,
+	\item or just come to our bureau at WE5/02.104.
 \end{compactitem}
 

content/references.tex

@@ -1,45 +1,41 @@
-\chapter{Referenzen}
+\chapter{References}
 \label{sec:references}
 
-Für Querverweise der Form \enquote{Wie man in Abbildung 23 sieht, \textellipsis} bringt \LaTeX\ von Haus aus den Befehl \mintinline{latex}{\ref{label}} mit, der lästige Anpassungen an der Nummerierung der Grafiken, Tabellen etc. erspart.
-Er erhält als Argument ein eindeutiges Label, das auch dem referenzierten Element zugeordnet werden muss.
-Anschließend erscheint an der Stelle des Befehlsaufrufs die fortlaufende Nummer des referenzierten Elements.
+If we want to make references, like \enquote{\textellipsis , which you can see in figure 21, \textellipsis}, \LaTeX{} by default provides us with the command \code{latex}{\textbackslash ref\{<label>\}}. No more adapting of the numbering for graphics, tables, etc. needed!
+The command expects a unique label as argument, that needs to be assigned to 
+the referenced element. After that, wherever we call the command, the number of 
+our referenced object appears in the text.
+\Example{lst:fooboar-learning-latex}{references/ref}{references/ref_crop}{Example for a reference}
 
-\Example{lst:fooboar-learning-latex}{references/ref}{references/ref_crop}{Beispiel für eine Referenzierung}
+A smarter package for references is \pkg{cleverref}.\footnote{with only one \enquote{r}!}
+It provides us with the command \code{latex}{\textbackslash cref\{<label>\}}, which can also handle multiple labels separated by commas.
+This automatically generates elegant references like \enquote{sections 1 to 3, and 5.}\footnote{for the source code \code{latex}{\textbackslash cref\{sec:section1,sec:section2,
+sec:section3,sec:section5\}}}
+Furthermore, \code{latex}{\textbackslash ref\{<label>\}} automatically inserts a suited abbreviation, e.\,g., \enquote{fig.} for figures.
 
-Noch smarter ist das Paket \mintinline{latex}{cleveref}.\footnote{mit nur einem \enquote{r}!}
-Es bringt den Befehl \mintinline{latex}{\cref{label}} mit, dem auch -- durch Kommata getrennt -- mehrere Labels übergeben werden können.
-Daraus entstehen dann automatisiert Angaben wie \enquote{Abschnitte 1 bis 3 und 5}.\footnote{für den Quelltext \mintinline{latex}{\cref{sec:section1,sec:section2,
-sec:section3,sec:section5}}}
-Zudem fügt \mintinline{latex}{\cref{label}} eigenständig die richtige Abkürzung ein, beispielsweise \enquote{Abb.} für Grafiken.
-
-Referenziert werden können neben Grafiken und Tabellen unter anderem auch Abschnitte, Bilder, Quelltext-Listings und Gleichungen.
-Viele Pakete nutzen das Label, um herauszufinden, zu welchem Objekttyp es gehört.
-Aus diesem Grund ist es üblich, jedem Label ein Präfix voranzustellen (\cref{lst:reference-prefixes}).
+We can reference graphics, tables, sections, chapters, source code listings, and equations. 
+Many packages use the label in order to find out the object type of the referenced element.
+For this reason, it is common to insert a prefix before each label (\cref{lst:reference-prefixes}).
 
 \begin{table}[H]
   \centering
   \begin{tabular}{@{}llll@{}}
     \toprule
-    Präfix & Objekttyp & Präfix & Objekttyp \\ \midrule
-    fig: & Abbildungen & tbl:    & Tabellen            \\ 
-    sec: & Abschnitte  & subsec: & Unterabschnitte     \\
-    ch:  & Kapitel     & itm:    & Aufzählungselemente \\
-    eq:  & Gleichungen & lst:    & Quelltext-Listings  \\ \bottomrule
+    Prefix & Object type & Prefix & Object type \\ \midrule
+    fig: & figures & tbl:    & tables            \\ 
+    sec: & sections  & subsec: & subsections     \\
+    ch:  & chapters     & itm:    & items \\
+    eq:  & equations & lst:    & source code listings  \\ \bottomrule
   \end{tabular}
-  \caption{Präfixe für Labels}
+  \caption{Prefixes for labels}
   \label{lst:reference-prefixes}
 \end{table}
 
-Bei der Verwendung von \mintinline{latex}{\cref{label}} ist zu beachten, dass die generierten Passagen in einigen Dokumentklassen erst dann auf Deutsch erscheinen, wenn bereits in der Dokumentklasse die Sprache festgelegt wurde: 
+Note that if we use \code{latex}{\textbackslash cref\{<label>\}}\,---\,for some document classes\,---\,the generated passages only appear in the desired language (e.\,g., German) when the language is specified already within the document class command:
 
-\begin{minted}{latex}
-\documentclass[ngerman]{article}
-\end{minted}
+\codeblock{latex}{listings/references/set-language.tex}
 
-\noindent Von Abschnitten abgesehen, müssen Beschriftungen\footnote{\mintinline{latex}{\caption{…}}} außerdem \emph{immer vergeben und vor dem Label platziert} werden, damit sie anschließend referenziert werden können.
-Bei Abschnitten wird das Label direkt hinter dem Befehl angefügt:
+	\noindent Except for sections, captions\footnote{\code{latex}{\textbackslash caption\{…\}}} \emph{always need to be specified and positioned before the label}\textit{.} Otherwise, they cannot be referenced later on in the text.
+	Labels for sections are inserted directly after the command:
 
-\begin{minted}{latex}
-\section{Hinweise}\label{sec:hints}
-\end{minted}
+\codeblock{latex}{listings/references/sections.tex}

content/source-code-listings-listings.tex

@@ -0,0 +1,32 @@
+\newpage
+\section{Using listings}
+
+\subsection{Installation}
+\pkg{listings} is a \LaTeX{} package of itself and does not require any additional installation as long as the \pkg{xcolor} package is installed as well.
+We can therefore jump straight into typesetting source code.
+
+\subsection{Defining listings}
+Similar to \pkg{minted}, you can define listings using a dedicated environment (cf.\ \cref{lst:listings-environment}) and you can use another command to import source code directly from external files (cf.\ \cref{lst:listings-external}).
+
+\example{lst:listings-environment}{source-code-listings/listings-environment}{Exemplary source code listing}
+\example{lst:listings-external}{source-code-listings/listings-import}{Including from a separate file}
+
+\noindent Both commands need a language specification\footnote{See this guide on Overleaf for a list of all languages: \url{https://www.overleaf.com/learn/latex/Code_listing\#Reference_guide}} as an optional parameter to apply syntax highlighting.
+
+\subsection{Configuring listings}
+The \pkg{listings} package can also be tweaked in an almost infinite number of ways.
+Numerous optional parameters give you a lot of freedom.
+
+Once again, Overleaf and the package documentation\footnote{Available at \url{https://www.overleaf.com/learn/latex/Code_listing\#Code_styles_and_colours} and \url{https://ctan.org/pkg/listings}, respectively.} come in handy.
+
+\example{lst:listings-external-styled}{source-code-listings/listings-import-styled}{Themes and further options}
+
+\subsection{Drawbacks and caveats}
+As mentioned earlier, \pkg{listings} is not our first choice for source code listings.
+Its renderings are of rather peculiar appearance. 
+
+With some amount of configuration, we can overcome the most disturbing default settings.
+Although \pkg{listings} is not shipped with any pre-defined themes, you can define your own and use them throughout your project with the \mono{lstdefinestyle} command.\footnote{Have a look at it in the package documentation. For the very impatient, here is a solarized theme for \pkg{listings}: \url{https://github.com/jez/latex-solarized}}
+
+The package is also a bit older than its alternative, causing \acro{UTF8} special characters to break. 
+If this happens to you, have a look at the \mono{literate} option of the \pkg{listings} commands.

content/source-code-listings-minted.tex

@@ -0,0 +1,95 @@
+\section{Using minted}
+
+\subsection{Installation}
+Using \pkg{minted} requires a working installation of the programming language Python 3 (henceforth referred to as Python).
+On some operating systems, Python comes pre-installed, in which case entering the command \sh{python -{}-version} or \sh{python3 -{}-version} in a terminal of your choice\footnote{Opening a terminal on Windows: \faWindows\ + R → Type \enquote{cmd} → Enter} should print out the installed Python version.
+
+If Python is yet to be installed, then you can find the installation files on the project website\footnote{Available at \url{https://www.python.org/downloads/}.}.
+There are extensive articles that cover all relevant steps to install Python on 
+Windows,\footnote{Pawandeep, How to install Python in Windows?. Tutorialspoint. March 10, 2021. Available at 
+\url{https://www.tutorialspoint.com/how-to-install-python-in-windows}. 
+Windows users will have to adjust the system path during the installation process. Forgetting this step has 
+been the number one installation problem in past workshops.} 
+Linux,\footnote{\url{https://docs.python-guide.org/starting/install3/linux/}} 
+or macOS.\footnote{\url{https://docs.python-guide.org/starting/install3/osx/}}
+
+After a successful installation, you should be able to execute the aforementioned command in a terminal, confirm by pressing Enter, and see approximately the following result: 
+
+\shell{python -{}-version \\ Python 3.8.5}
+
+\noindent If the version number is equal to the one stated here, or higher, then everything should be set up correctly.
+Next, enter the command \sh{pip install Pygments}\footnote{On some operating systems, you might have to use the command \sh{pip3 install Pygments}} in the same terminal window to install the Pygments package for Python.
+Once the installation is complete, you are ready to include the \LaTeX{} package \pkg{minted} into your documents by adding \code{latex}{\textbackslash usepackage\{minted\}} to your preamble.
+
+
+\subsection{Changing the compiler command}
+There is one last adjustment needed before you can actually compile your documents---we will have to adjust the compile command.
+Out of the box, your editor will probably execute the following command after you clicked the green compile arrow:
+
+\shell{pdflatex main.tex}
+
+\noindent The exact command can be found and configured in \TeX{}studio under Options\,→\,Configure \TeX{}studio\,→\,Commands.
+It is stated next to the Pdf\LaTeX{} label.
+The file that is to be compiled will replace the placeholder \sh{\%.tex} upon compilation.
+Typically, there are two additional options configured.
+You can recognize them by the hyphen before their names (\sh{-synctex=1} and \sh{-interaction=\allowbreak{}nonstopmode}).
+These options are called flags and they configure the program \sh{pdflatex}. 
+We will have to add another flag.
+Place the string \sh{-shell-escape} before the file placeholder (\sh{\%.tex}):
+
+\shell{pdflatex -synctex=1 -interaction=nonstopmode -shell-escape \%.tex}
+
+\noindent After a click on \enquote{Okay} the configuration is finished.
+Other editors usually provide similar options to configure the compilation command.
+We recommend you to have a look at the settings or to use of a search engine to figure it out.
+
+\paragraph{An important note on the shell-escape flag.} \pkg{minted}'s syntax highlighting is done by a Python package, which adds the necessity to communicate between the compiler and the Python runtime.
+The shell-escape flag adds this communication path.
+When enabled, \LaTeX{} can execute any command in a terminal, which can be very useful.
+Nonetheless, it would also be possible to execute malign code on your computer via \LaTeX{}, especially when you are compiling unknown documents from the Internet.
+Therefore, do not compile downloaded documents with the shell-escape flag if you do not trust the authors and did not check the packages and commands they include.
+
+\subsection{Defining listings}
+We are finally ready to marvel at the aesthetic quality of the listings \pkg{minted} produces.
+You can define listings using a dedicated environment:
+
+% Render listing directly, if minted is available.
+% Otherwise, include pre-rendered images.
+\ifthenelse{\equal{\listingsmode}{minted}}{%
+  \example{lst:minted-environment}{source-code-listings/minted-environment}{Exemplary source code listing}
+  }{%
+  \Example{lst:minted-environment}{source-code-listings/minted-environment}{source-code-listings/minted-environment_crop}{Exemplary source code listing}
+}
+
+% Render listing directly, if minted is available.
+% Otherwise, include pre-rendered images.
+\ifthenelse{\equal{\listingsmode}{minted}}{%
+  \example{lst:minted-variants}{source-code-listings/minted-variants}{Shorthand and inline listing}
+  }{%
+  \Example{lst:minted-variants}{source-code-listings/minted-variants}{source-code-listings/minted-variants_crop}{Shorthand and inline listing}
+}
+
+\noindent There is also a shorthand and an inline variant of the command (cf.\ \cref{lst:minted-variants}).
+To avoid redundancy, it may be practical to import source code directly from the source file.
+To accomplish this, we only have to pass the programming language and the file path to the \code{latex}{\textbackslash inputminted} command (cf.\ \cref{lst:minted-external}).
+
+% Render listing directly, if minted is available.
+% Otherwise, include pre-rendered images.
+\ifthenelse{\equal{\listingsmode}{minted}}{%
+  \example{lst:minted-external}{source-code-listings/minted-import}{Including from a separate file}
+  }{%
+  \Example{lst:minted-external}{source-code-listings/minted-import}{source-code-listings/minted-import_crop}{Including from a separate file}
+}
+
+\subsection{Configuring minted}
+Optional parameters allow us to add line numbers, line breaks, and colors.
+Moreover, there are numerous themes available (\cref{lst:minted-external-styled}).
+The introduction on Overleaf and the package documentation\footnote{Available at \url{https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted} and \url{https://ctan.kako-dev.de/macros/latex/contrib/minted/minted.pdf}, respectively.} give an extensive overview.
+
+% Render listing directly, if minted is available.
+% Otherwise, include pre-rendered images.
+\ifthenelse{\equal{\listingsmode}{minted}}{%
+  \example{lst:minted-external-styled}{source-code-listings/minted-import-styled}{Themes and further options}
+  }{%
+  \Example{lst:minted-external-styled}{source-code-listings/minted-import-styled}{source-code-listings/minted-import-styled_crop}{Themes and further options}
+}

content/source-code-listings.tex

@@ -1,69 +1,25 @@
-\chapter{Quelltext-Listings}
+\chapter{Source code listings}
 \label{sec:source-code-listings}
 
-Um Quelltext in eigenen Arbeiten darzustellen, gibt es in \LaTeX verschiedene Wege.
-Wir verwenden hierfür gern das Paket \mintinline{latex}{minted}, das zwar etwas zusätzlichen Installationsaufwand verursacht, dafür aber ansprechende Ergebnisse generiert und gut zu handhaben ist.
+There are many ways in \LaTeX{} to display source code.
+We have come to appreciate the package \pkg{minted}, which causes some additional installation overhead, but generates very appealing source code renderings.
 
-\section{Installation}
-Zur Verwendung von \mintinline{latex}{minted} ist eine Installation der Programmiersprache Python 3 notwendig. Je nachdem, welches Betriebsystem ihr nutzt, kann es sein, dass Python 3 bei euch schon installiert ist. Das könnt ihr durch die Engabe des Befehls \mintinline{bash}{python --version} oder \mintinline{bash}{python3 --version} in einem Terminal\footnote{Navigation unter Windows: \faWindows\ + R → \enquote{cmd} eingeben → Enter} herausfinden 
+However, especially on macOS, the installation of \pkg{minted} has caused a lot of headache in the early days of this workshop.
+That's why we will also have a look at an alternative called \pkg{listings}. 
 
-Sollte Python bei euch  noch nicht installiert sein, sind die Installationsdateien auf der Projekt-Website\footnote{Verfügbar unter \url{https://www.python.org/downloads/}.} zu finden.
-Ein ausführlicherer Beitrag zur Installation unter Windows,\footnote{Jason Fitzpatrick, How to Install Python on Windows. How-To Geek. July 11, 2017. Verfügbar unter \url{https://www.howtogeek.com/197947/how-to-install-python-on-windows/}.} Linux\footnote{ \url{https://docs.python-guide.org/starting/install3/linux/}} oder MacOS\footnote{\url{https://docs.python-guide.org/starting/install3/osx/}} führt euch durch die verschiedenen Schritte, die speziell für euer Betriebssystem notwendig sind.\footnote{Insbesondere das Anpassen des Systempfads sollte unter Windows nicht vergessen werden.}
+\paragraph{A note on colors.} Both of these packages require you to define colors. 
+We can recommend using the \pkg{xcolor} package.
+There are very helpful resources\footnote{If you would like to specify your own colors , these pages might help you: \url{https://www.overleaf.com/learn/latex/Using_colours_in_LaTeX} for a list of pre-defined colors in the \pkg{xcolor} package, \url{https://mmoredo.github.io/latex-color-converter/} for defining your own colors} available online such that we will not go into details here.
 
-Nach der erfolgreichen Installation solltet ihr, je nach Betriebssystem, in der Eingabeaufforderung den oben genannten Befehl noch mal eingeben und mit Enter bestätigen können und in etwa folgendes Ergebnis erhalten:
+\section*{Source code listings within this script}
 
-\begin{minted}[]{bash}
-$ python --version
-Python 3.8.5
-\end{minted}
+This script uses the package \pkg{listings} as default way for displaying source code listings, since, as mentioned above, it causes less headache, especially on macOS. As we introduce \pkg{minted} as an alternative package, naturally, this script can also display source code listings rendered by \pkg{minted}. 
 
-\noindent Sollte die Versionsnummer höher sein, ist alles bestens. 
-Im gleichen Fenster gebt ihr jetzt den Befehl \mintinline{bash}{pip install Pygments}\footnote{Achtung: In einigen Betriebssystem lautet der Befehl \mintinline{bash}{pip3 install Pygments}} ein, womit das Pygments-Paket für Python installiert wird.
-Nach Abschluss dieses Vorgangs könnt ihr das \LaTeX-Paket \mintinline{latex}{minted} über \mintinline{latex}{\usepackage{minted}} einbinden.
+To switch between the packages, you can change the listings mode to \pkg{minted} like so: First of all, follow the respective installation instructions. Afterwards, create a new file called \file{listings-mode.tex} in the root directory of this project, and insert the following line into the newly created file: 
 
+\codeblock{latex}{./listings/source-code-listings/change-listings-mode.tex}
 
-\section{Compiler-Befehl ändern}
-Bevor es allerdings richtig losgehen kann, müssen wir noch eine Kleinigkeit im Compile-Prozess anpassen.
-Normalerweise ruft euer Editor beim Klick auf den grünen Pfeil etwa den folgenden Befehl auf: 
+After compiling the script, you should see differently rendered source code listings. If you want to return to \pkg{listings} as package for rendering your source code listings, just replace \sh{minted} with \sh{default} in the \file{listings-mode.tex} file. Source code listings within this script are then displayed using the \pkg{listings} package again.
 
-\begin{minted}[]{bash}
-$ pdflatex main.tex
-\end{minted}
-
-\noindent Welcher Befehl das bei euch genau ist, könnt ihr in \TeX{}studio unter \enquote{Optionen → \TeX{}studio konfigurieren → Befehle} einsehen.
-Neben Pdf\LaTeX{} seht ihr den Befehl.
-Die Datei, die kompiliert werden soll, wird hier durch \mintinline{bash}{%.tex} angegeben.
-Außerdem sind üblicherweise noch zwei zusätzliche Angaben enthalten, jeweils mit einem Bindestrich davor (\mintinline{bash}{-synctex=1 -interaction=nonstopmode}).
-Diese Angaben heißen Flags und konfigurieren das Programm \mintinline{bash}{pdflatex}. 
-Eine solche Flag müssen wir ergänzen.
-Platziert die Angabe \mintinline{bash}{-shell-escape} vor der Datei-Angabe (\mintinline{bash}{%.tex}):
-
-\begin{minted}[]{bash}
-pdflatex -synctex=1 -interaction=nonstopmode -shell-escape %.tex
-\end{minted}
-
-\noindent Nach Klick auf \enquote{Okay} ist der Einrichtungsschritt abgeschlossen.
-Auch andere Editoren bieten die Möglichkeit, den Kompilierbefehl anzupassen.
-Schaut am besten mal in die Einstellungen oder bemüht eine Suchmaschine.
-
-\section{Quelltext setzen}
-Jetzt kann der eigentliche Spaß losgehen.
-Quelltext könnt ihr von nun an unter Angabe der Sprache in einer eigenen Umgebung setzen:
-
-\example{lst:minted-environment}{source-code-listings/minted-environment}{Beispielhaftes Quelltext-Listing}
-
-\example{lst:minted-variants}{source-code-listings/minted-variants}{Kurzschreibweise und Inline-Listing}
-
-\noindent Außerdem gibt es eine Kurzschreibweise und eine Inline-Variante des Befehls (vgl. \cref{lst:minted-variants}).
-Um Redundanz zu vermeiden, ist es manchmal praktisch, den Quelltext direkt aus der Quelldatei einzulesen.
-Hierzu müssen nur die verwendete Programmiersprache und der Dateipfad an den Befehl \mintinline{latex}{\inputminted} übergeben werden (vgl. \cref{lst:minted-external}).
-
-\example{lst:minted-external}{source-code-listings/minted-import}{Einbinden aus einer externen Datei}
-
-\section{Minted konfigurieren}
-
-Durch optionale Parameter können Zeilennummerierung, Umbrüche und Farben ausgewählt werden. 
-Außerdem sind zahlreiche Themes verfügbar (\cref{lst:minted-external-styled}).
-Einen umfänglichen Überblick geben die Einführung von Overleaf und die Dokumentation.\footnote{Verfügbar unter \url{https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted} bzw. \url{https://ctan.kako-dev.de/macros/latex/contrib/minted/minted.pdf}.}
-
-\example{lst:minted-external-styled}{source-code-listings/minted-import-styled}{Themes und weitere Optionen}
+\input{./content/source-code-listings-minted}
+\input{./content/source-code-listings-listings}

content/special-characters.tex

@@ -1,142 +1,146 @@
-\chapter{Sonderzeichen}
+\chapter{Special characters}
+
 \label{sec:special-characters}
 
-\section{Leerzeichen}
+\section{Spaces}
 
-Das am häufigsten benötigte Sonderzeichen ist ein einfaches Leerzeichen als Wortzwischenraum.
-Dieses Zeichen entsteht in \LaTeX, wenn im Quellcode zwischen anderen Zeichen Leerzeichen oder einzelne Zeilenumbrüche stehen.
-Es gibt aber auch einige andere Arten von Leerzeichen.
-Wie sie verwendet werden können, wird in \cref{lst:spaces} veranschaulicht.
+The special character used most frequently is a simple space between words.
+\LaTeX{} creates it whenever the source code contains spaces or single newlines (by hitting the enter key once) between other characters.
+The word space is not the only one, though\,---\,there are a few more types of spaces.
+\Cref{lst:spaces} illustrates how they are used.
 
-\example{lst:spaces}{special-characters/spaces}{Unterschiedliche Leerzeichen in \LaTeX}
+\example{lst:spaces}{special-characters/spaces}{Different spaces in \LaTeX}
 
 \paragraph{English Spacing}
-In englischsprachigen Dokumenten verwendet LaTeX das traditionelle English Spacing, also doppelte Leerzeichen nach dem Satzende.
-Der Befehl \mintinline{tex}|\frenchspacing| vor dem ersten Absatz verhindert das.
-Der Befehl \mintinline{tex}|\nonfrenchspacing| schaltet wieder zurück.
-Bei English Spacing versucht \LaTeX, Abkürzungen zu erkennen und danach trotzdem normale Wortzwischenräume zu setzen.
-Das solltet ihr aber kontrollieren – und, wo nötig,
-Wortzwischenräume (\mintinline[showspaces]{tex}{.\ }) oder Satzenden (\mintinline[showspaces]{tex}{\@. }) erzwingen.
+In documents written in English, \LaTeX{} uses traditional English Spacing by default. That is, double spaces after each sentence.
+We can prevent this by using the command \code{tex}{\textbackslash frenchspacing} above the first paragraph.
+With \code{latex}{\textbackslash nonfrenchspacing}, we can reset the behavior.
+When using English Spacing, \LaTeX{} tries to recognize abbreviations and to use normal spaces after those.
+We should still check this and\,---\,where necessary\,---\,enforce word spaces (\mono{.\textbackslash␣}) or sentence spaces (\mono{\textbackslash @.␣}).
 
-\section{Striche}
-Es gibt verschiedene horizontale Striche.
-Am häufigsten werden der Bindestrich (-), der Halbgeviertstrich (–) und der Geviertstrich\footnote{Ein Geviert ist die Zeilenhöhe, die eine Bleiletter aus dem Buchdruck einnimmt.} (—) verwendet.
-Diese drei Striche werden in \LaTeX{} durch unterschiedlich viele Bindestriche im Quelltext erzeugt, wie \cref{tbl:bars} zeigt.
+\section{Hyphens and dashes}
+There are different kinds of horizontal lines being used as punctuation,
+most frequently the hyphen (-), the en dash (–) and the em dash (—).\footnote{They are named after the letters N and M,
+that occupy roughly the same space.
+The letter M is also about as wide as it is tall, and the amount is called a \emph{Geviert} in German, hence the German terms \emph{Halbgeviertstrich} and \emph{Geviertstrich} for the two dashes.}
+These three characters are created in \LaTeX{} by different numbers of consecutive hyphens in the source code,
+as shown in \cref{tbl:bars}.
 
 \begin{longtable}{@{}llp{7.8cm}@{}}
 	\toprule
-	Code       & Strich            & Verwendung \\
+	Code       & Character            & Usage \\
 	\midrule
-	\mintinline{tex}|-|   & Bindestrich       & \LaTeX-Wochenende \\
-	\mintinline{tex}|--|  & Halbgeviertstrich & als Gedankenstrich – mit Leerzeichen außenrum – oder als Bis-Strich: 10\,–\,12 Uhr \\
-	\mintinline{tex}|---| & Geviertstrich     & a dash\,—\,mostly used in American English \\
+	\code{latex}{-}   & Hyphen  & a small-sized stroke \\
+	\code{latex}{--}  & En dash & a range mark (8\,--\,10\,am) or an interruptor at sentence level – the latter surrounded by spaces and used in most European languages (including British English) \\
+	\code{latex}{---} & Em dash & an interrupter at sentence level\,---\,mostly used in American English and without or with thin spaces \\
 	\bottomrule
-	\caption{Striche in \LaTeX}
+	\caption{Hyphens and dashes in \LaTeX}
 	\label{tbl:bars}
 \end{longtable}
 
-Der Bindestrich wird zwar auch zur Silbentrennung verwendet, ihr solltet ihn dafür aber nicht explizit im Quellcode eingeben.
-An den meisten Stellen trennt \LaTeX{} automatisch richtig, wenn ihr das passende \texttt{babel}-Paket eingebunden habt.\footnote{Vgl. \cref{sec:language}.}
-Wenn dabei etwas schiefgeht, könnt ihr mit den Codes in \cref{tbl:separators} eingreifen:\footnote{Auch dafür muss \texttt{babel} eingebunden sein.}
+The hyphen is obviously also used for hyphenation, but for this purpose, we should not insert it explicitly in our source code.
+In most places, \LaTeX{} does the hyphenation automatically if we are using the correct \texttt{babel} configuration.\footnote{c.\,f. \cref{sec:language}.}
+In case something goes wrong, we can intervene using the codes from \cref{tbl:separators}:\footnote{Those also require the \texttt{babel} package.}
 
 \begin{longtable}{@{}lp{11cm}@{}}
 	\toprule
-	Code      & Erläuterung \\
+	Code      & Explanation \\
 	\midrule
 	\endhead
-	\mintinline{tex}|\-| & Ausschließliche Trennstelle: Das Wort darf nur an dieser Stelle getrennt werden (kann auch mehrfach in einem Wort vorkommen, dann sind alle Stellen erlaubt). \\
-	\mintinline{tex}|"-| & Zusätzliche Trennstelle: Das Wort darf neben den von \LaTeX{} erkannten Trennstellen auch hier getrennt werden. \\
-	\mintinline{tex}|-|  & Exklusiver Bindestrich: Wird für Komposita verwendet und unterbindet die automatische Silbentrennung im Wort (das ist typografisch erwünscht). \\
-	\mintinline{tex}|"=| & Nichtexklusiver Bindestrich: Wird für lange Komposita verwendet, bei denen die Silbentrennung aktiv bleiben soll, weil der Umbruch sonst nicht klappt. \\
-	\mintinline{tex}|""| & Trennstelle ohne Strich: Kann beispielsweise verwendet werden, um \textsc{url}s ohne Bindestrich zu trennen. \\
-	\mintinline{tex}|"~| & Bindestrich ohne Trennstelle: Wird verwendet, um den Bindestrich zusammen mit dem folgenden Wort umbrechen zu lassen: \emph{Vorlesungszeit und "~raum} \\
+	\code{latex}{\textbackslash -} & Exclusive hyphenation: The word may only be hyphenated at this position (can also be used multiple times within one word\,---\,all of those positions are then allowed). \\
+	\code{latex}{"-} & Additional hyphenation: The word may be hyphenated here, as well as at the default positions. \\
+	\code{latex}{-}  & Exclusive hyphen: Is only used for compound words and prevents the automatic hyphenation for the rest of the word (which is typographically desirable). \\
+	\code{latex}{"=} & Non-exclusive hyphen: Is used for long compound words when the text wrapping would not work without additional automatic hyphenation. \\
+	\code{latex}{""} & Cut-off point without a hyphen: Allows something like a \acro{url} to wrap without inserting a potentially misleading hyphen. \\
+	\code{latex}{"~} & Non-wrapping hyphen: Keeps the hyphen together with the following word, very useful in German: \foreignlanguage{ngerman}{\emph{Vorlesungszeit und "~raum}} \\
 	\bottomrule
-	\caption{Ausnahmen für die Silbentrennung}
+	\caption{Exceptions for hyphenation}
 	\label{tbl:separators}
 \end{longtable}
 
-\section{Anführungszeichen}
-Anführungszeichen können grundsätzlich mit den Codes in \cref{tbl:quotation-marks} erzeugt werden.
-Entscheidend ist dabei jeweils das Aussehen und nicht die Semantik, weshalb zum Beispiel im Deutschen die französichen Guillemets verkehrt herum verwendet werden (»french left quoation mark« rechts und umgekehrt).
+\section{Quotation marks}
+Quotation marks can generally be created using the codes from \cref{tbl:quotation-marks}.
+The decisive factor is the appearance, not the semantics, which is why the French Guillemets are used the wrong way around in German
+(the \emph{french left quotation mark} on the right and vice versa).
 
 \begin{table}[H]
 	\center
 	\begin{tabular}{lcccc}
 		\toprule
-		Sprache & \multicolumn{2}{c}{Erste Ebene} & \multicolumn{2}{c}{Zweite Ebene} \\ 
+		Language & \multicolumn{2}{c}{First level} & \multicolumn{2}{c}{Second level} \\
 		\cmidrule(lr){2-3} \cmidrule(lr){4-5}
-		& Code & Ergebnis & Code & Ergebnis \\
+		& Code & Result & Code & Result \\
 		\midrule
-		Deutsch & \mintinline{tex}|\glqq...\grqq| & \glqq…\grqq & \mintinline{tex}|\glq…\grq| & \glq…\grq \\
-		Deutsch alternativ & \mintinline{tex}|\frqq...\flqq| & \frqq…\flqq & \mintinline{tex}|\frq…\flq| & \frq…\flq \\
-		Englisch (\acro{A.\,E.}) & \mintinline{tex}|``...''| & ``…'' & \mintinline{tex}|`...'| & `…' \\
-		Englisch (\acro{B.\,E.}) & \mintinline{tex}|`...'| & `…' & \mintinline{tex}|``...''| & ``…'' \\
+		English (\acro{A.\,E.}) & \code{latex}{``...''} & ``…'' & \code{latex}{`...'} & `…' \\
+		English (\acro{B.\,E.}) & \code{latex}{`...'} & `…' & \code{latex}{``...''} & ``…'' \\
+		German & \code{latex}{\glqq...\grqq} & \glqq…\grqq & \code{latex}{\glq…\grq} & \glq…\grq \\
+		German (alternatively) & \code{latex}{\frqq...\flqq} & \frqq…\flqq & \code{latex}{\frq…\flq} & \frq…\flq \\
 		\bottomrule
 	\end{tabular}
-	\caption{Anführungszeichen}
+	\caption{Quotation marks}
 	\label{tbl:quotation-marks}
 \end{table}
 
-Deutlich flexibler seid ihr aber mit dem Paket \mintinline{tex}{csquotes}, das den Befehl \mintinline{tex}|\enquote{<zitat>}| zur Verfügung stellt.
-Abhängig von der Sprache werden die passenden Anführungszeichen verwendet; bei verschachtelten \texttt{enquote}s wird zwischen erster und zweiter Ebene gewechselt.
-Mit der Option \mintinline{tex}|autostyle=true| beim Paketimport setzt der Befehl \mintinline{tex}|\foreignquote{<sprache>}{<zitat>}| je nach Sprache abweichende Anführungszeichen.
+We can get more flexibility using the \pkg{csquote} package, which provides the \code{latex}{\enquote{<quote>}} command.
+It chooses the correct quotation marks depending on the language being used; also, nested \texttt{enquote}s automatically switch back and forth between first and second level.
+When enabling the \code{latex}{autostyle=true} option on package import, \code{latex}{\textbackslash foreignquote\{<language>\}\{<quote>\}} selects varying quotation marks for each quotation.
 
-\section{Diakritika}
-Wenn ihr Buchstaben mit diakritischen Zeichen direkt über die Tastatur eingeben könnt – beispielsweise die deutschen Umlaute oder gängige Akzente auf einer deutschen Tastatur –, könnt ihr das auch direkt im Quelltext tun.
-Die Zeichen bleiben dann im Output erhalten.
-Ansonsten können die Diakritika auch per Escape-Codes erzeugt werden.
-\cref{tbl:diacritics} gibt nur einige Beispiele an – die Buchstaben lassen sich natürlich austauschen, es gibt aber auch noch viele andere Diakritika.
+\section{Diacritics}
+If we are able to insert letters with diacritics via our keyboard\,---\,e.\,g., the German Umlauts or common accents\,---\,we can do this within our source code, as well:
+The characters will remain intact in the output.
+If not, we can also create the diacritics via escape codes.
+\Cref{tbl:diacritics} shows just a few examples\,---\,the letters can of course be swapped out, but there is still a huge amount of different diacritics.
 
 \begin{table}[H]
 	\center
 	\begin{tabular}{lccclccclcc}
 		\toprule
-			\verb|\`{o}| & -- & \`{o} & $\quad$ & \verb|\c{c}| & -- & \c{c} & $\quad$ & \verb|\d{u}| & -- & \d{u} \\
-			\verb|\'{o}| & -- & \'{o} & & \verb|\k{a}| & -- & \k{a} & & \verb|\r{a}| & -- & \r{a} \\
-			\verb|\^{o}| & -- & \^{o} & & \verb|\l{}| & -- & \l{} & & \verb|\u{o}| & -- & \u{o} \\
-			\verb|\"{o}| & -- & \"{o} & & \verb|\={o}| & -- & \={o} & & \verb|\v{s}| & -- & \v{s} \\
-			\verb|\H{o}| & -- & \H{o} & & \verb|\b{o}| & -- & \b{o} & & \verb|\t{oo}| & -- & \t{oo} \\
-			\verb|\~{o}| & -- & \~{o} & & \verb|\.{o}| & -- & \.{o} & & \verb|\o| & -- & \o \\
+			\code{latex}{\textbackslash `{o}} & -- & \`{o} & $\quad$ & \code{latex}{\textbackslash c{c}} & -- & \c{c} & $\quad$ & \code{latex}{\textbackslash d{u}} & -- & \d{u} \\
+			\code{latex}{\textbackslash '\{o\}} & -- & \'{o} & & \code{latex}{\textbackslash k\{a\}} & -- & \k{a} & & \code{latex}{\textbackslash r\{a\}} & -- & \r{a} \\
+			\code{latex}{\textbackslash \^\{o\}} & -- & \^{o} & & \code{latex}{\textbackslash l\{\}} & -- & \l{} & & \code{latex}{\textbackslash u\{o\}} & -- & \u{o} \\
+			\code{latex}{\textbackslash "\{o\}} & -- & \"{o} & & \code{latex}{\textbackslash =\{o\}} & -- & \={o} & & \code{latex}{\textbackslash v\{s\}} & -- & \v{s} \\
+			\code{latex}{\textbackslash H\{o\}} & -- & \H{o} & & \code{latex}{\textbackslash b\{o\}} & -- & \b{o} & & \code{latex}{\textbackslash t\{oo\}} & -- & \t{oo} \\
+			\code{latex}{\textbackslash ~\{o\}} & -- & \~{o} & & \code{latex}{\textbackslash .\{o\}} & -- & \.{o} & & \code{latex}{\textbackslash o} & -- & \o \\
 		\bottomrule
 	\end{tabular}
-	\caption{Diakritika}
+	\caption{Diacritics}
 	\label{tbl:diacritics}
 \end{table}
 
-\section{Andere Sonderzeichen}
-Einige Sonderzeichen, beispielsweise das Prozentzeichen, sind für die \LaTeX{}-Syntax reserviert und können nicht als normale Zeichen verwendet werden.
-Diese und viele, viele weitere Sonderzeichen können über eigene Befehle erzeugt werden.
-Dabei ist zu beachten, dass manche Sonderzeichen nur in Mathe-Umgebungen (siehe \cref{sec:maths}) funktionieren, andere brauchen zusätzliche Pakete.
+\section{More special characters}\label{sec:more-special-characters}
+Some special characters, like the percent sign, are reserved as part of the \LaTeX{} syntax and cannot be used as normal characters.
+These and many, many more can be created by their own commands.
+Please note that some of them only work in maths environments (c.\,f. \cref{sec:maths}), others might require additional packages.
 
 \begin{table}[H]
 	\center
 	\begin{tabular}{cll}
 		\toprule
-		Zeichen & Code & Bemerkung \\
+		Sign & Code & Remarks \\
 		\midrule
 		?`/!` & \verb|?`/!`| & \\
-		\textasciicircum & \verb|\textasciicircum| & \\
-		\textasciitilde & \verb|\textasciitilde| & \\
-		\textasteriskcentered & \verb|\textasteriskcentered| & \\
-		\textbackslash & \verb|\textbackslash| & \\
-		%\textbar & \verb|\textbar| & \\
-		%\textbullet & \verb|\textbullet| & \\
-		\textcopyright & \verb|\textcopyright| & \\
-		\textdagger & \verb|\textdagger| & \\
-		%\textdaggerdbl & \verb|\textdaggerdbl| & \\
-		\textellipsis & \verb|\textellipsis| & \\
-		\textless/\textgreater & \verb|\textless/\textgreater| & \\
-		\textperthousand & \verb|\textperthousand| & \\
-		\textsection & \verb|\textsection| & \\
-		$\delta, \pi, \Sigma$ & \verb|\delta, \pi, \Sigma|, … & nur in Mathe-Umgebung \\
-		\euro & \verb|\euro| & nur mit Paket \texttt{eurosym} \\
-		\textteshlig & \verb|\textteshlig| & nur mit Paket \texttt{tipa} \\
-		\textmusicalnote & \verb|\textmusicalnote| & nur mit Paket \texttt{textcomp} \\
+		\textasciicircum & \code{latex}{\textbackslash textasciicircum} & \\
+		\textasciitilde & \code{latex}{\textbackslash textasciitilde} & \\
+		\textasteriskcentered & \code{latex}{\textbackslash textasteriskcentered} & \\
+		\textbackslash & \code{latex}{\textbackslash textbackslash} & \\
+		%\textbar & \code{latex}{\textbackslash textbar} & \\
+		%\textbullet & \code{latex}{\textbackslash textbullet} & \\
+		\textcopyright & \code{latex}{\textbackslash textcopyright} & \\
+		\textdagger & \code{latex}{\textbackslash textdagger} & \\
+		%\textdaggerdbl & \code{latex}{\textbackslash textdaggerdbl} & \\
+		\textellipsis & \code{latex}{\textbackslash textellipsis} & \\
+		\textless/\textgreater & \code{latex}{\textbackslash textless/\textbackslash textgreater} & \\
+		\textperthousand & \code{latex}{\textbackslash textperthousand} & \\
+		\textsection & \code{latex}{\textbackslash textsection} & \\
+		$\delta, \pi, \Sigma$ & \verb|\delta, \pi, \Sigma|, … & only in maths environments \\
+		\euro & \code{latex}{\textbackslash euro} & requires the \pkg{eurosym} package \\
+		\textteshlig & \code{latex}{\textbackslash textteshlig} & requires the \pkg{tipa} package \\
+		\textmusicalnote & \code{latex}{\textbackslash textmusicalnote} & requires the \pkg{textcomp} package \\
 		\bottomrule
 	\end{tabular}
-	\caption{Einige Sonderzeichen}
+	\caption{Some special characters}
 	\label{tbl:special-characters}
 \end{table}
-Falls ihr mal ein Sonderzeichen braucht, von dem ihr nicht genau wisst, wie es heißt, hilft euch \emph{Detexify}\footnote{\url{http://detexify.kirelabs.org/classify.html}} – ihr könnt das Symbol zeichnen und bekommt alle nötigen Infos.
-Dass es von Keilschrift bis zu technischen Symbolen wirklich \emph{alles} gibt, stellt ihr fest, wenn ihr durch die \emph{Comprehensive \LaTeX{} Symbol List}\footnote{\url{http://tug.ctan.org/info/symbols/comprehensive/symbols-a4.pdf}} blättert.
+Whenever you need a certain symbol and don’t know its name, \emph{Detexify}\footnote{\url{http://detexify.kirelabs.org/classify.html}} comes to the rescue: You can draw the symbol and get all necessery information.
+From cuneiforms to technical symbols, there is absolutely \emph{everything}\textit{,} as you can see scrolling through the \emph{Comprehensive \LaTeX{} Symbol List}\textit{.}\footnote{\url{http://tug.ctan.org/info/symbols/comprehensive/symbols-a4.pdf}}
 

content/tables.tex

@@ -1,50 +1,50 @@
-\chapter{Tabellen}
+\chapter{Tables}
 \label{sec:tables}
 
-Für Tabellen gibt es zwei grundlegende Umgebungen.
-Die erste, \texttt{table}, ist dafür zuständig, die Tabelle insgesamt in das übrige Dokument einzubauen.
-Die Positionierung erfolgt dabei analog zur Positionierung von Grafiken.
-Auch bei Tabellen kann der Befehl \mintinline{tex}{\caption} verwendet werden, um der Tabelle eine Beschriftung zuzuordnen.
+There are two fundamental environments for tables.
+The first one, called \mono{table}, is responsible for integrating the table as a whole into the document.
+Positioning is done the same way as it is with graphics.
+The \code{latex}{\textbackslash caption} command is the same, as well.
 
-Beim Tabelleninhalt hören die Gemeinsamkeiten auf:
-Während Grafiken aus externen Dateien stammen und nicht durch \LaTeX{} interpretiert werden, muss die innere Struktur von Tabellen im Code aufgeschlüsselt werden.
-Dazu dient die Umgebung \texttt{tabular}, die als verpflichtenden Parameter eine Spaltendefinition erwartet.
-Die Spaltendefinition besteht aus je einem Buchstaben pro Tabellenspalte, der die Textausrichtung der Spalte angibt: 
-\texttt{l} für linksbündig, \texttt{r} für rechtsbündig, \texttt{c} für zentriert.
+At the table \emph{content}, the similarities end:
+While graphics are embedded from external files and not interpreted by \LaTeX{},
+the inner structure of tables has to be encoded explicitly.
+This is done with the \mono{tabular} environment that expects a column definition as an obligatory parameter.
+The column definition consists of one letter per column specifying its text alignment:
+\mono{l} for left-justified, \mono{r} for right-justified, \mono{c} for centered.
 
-Innerhalb der \texttt{tabular}-Umgebung folgt dann der eigentliche Tabelleninhalt.
-Dabei werden Tabellenzeilen genau wie Zeilenumbrüche durch \mintinline{tex}{\\} markiert, Zellengrenzen durch \mintinline{tex}{&}.
+Within the \mono{tabular} environment, the actual table content follows.
+Table rows are separated by \code{latex}{\textbackslash \textbackslash}, just like line breaks, and cells by an \code{latex}{\&}.
 
-Für typografisch ansprechende Tabellen empfehlen wir das Paket \texttt{booktabs}.\footnote{Alle bisher genannten Befehle funktionieren auch ohne dieses Paket, das Ergebnis sieht dann aber deutlich unprofessioneller aus.}
-Dieses Paket bringt die Befehle \mintinline{tex}{\toprule}, \mintinline{tex}{\midrule} und \mintinline{tex}{\bottomrule} mit, die jeweils passende horizontale Linien für den Tabellenbegin, für Gruppierungen innerhalb der Tabelle sowie für das Tabellenende zeichnen.
+For typographically pleasing tables, we recommend the \pkg{booktabs} package.\footnote{All commands previously mentioned also work without this package, but the result will look far less professional.}
+This package brings along the commands \code{latex}{\textbackslash toprule}, \code{tex}{\textbackslash midrule} and \code{tex}{\textbackslash bottomrule} that draw appropriate horizontal lines above, within and below the table, respectively.
 
-Vertikale Linien können als senkrechter Strich (\texttt{|}) in die Spaltendefinition eingefügt werden, davon ist aber abzuraten.
-Wenn ihr den zusätzlichen Weißraum entfernen möchtet, der standardmäßig die Spalten umgibt, könnt ihr – ebenfalls zwischen den Buchstaben der Spaltendefinition – die Zeichenkette \mintinline{tex}{@{}} einfügen.
+Vertical lines can be inserted as a vertical bar character (\mono{|}) in the column definition, but this is \emph{not} recommended.\footnote{The
+whitespace within the table separates the columns clearly enough, additional lines just make for visual clutter.}
+If you want to remove the additional whitespace that surrounds the columns by default (e.\,g., to the left of the first column and to the right of the last), you can add the string \mono{@\{\}} at the corresponding places within the column definition.
 
-Die komplette Tabelle kann dann beispielsweise so aussehen wie in \cref{lst:sample-table} abgebildet.
+A complete table can then look like the one shown in \cref{lst:sample-table}.
 
-\Example{lst:sample-table}{tables/table-example}{tables/table-example-renderable}{Eine komplette Tabelle}
+\Example{lst:sample-table}{tables/table-example}{tables/table-example-renderable}{A complete table}
 
-\paragraph{Überlänge}
-Für Tabellen, die über eine Seite hinausgehen, oder die Zeilenumbrüche innerhalb einzelner Tabellenzellen erfordern, kann zusätzlich das Paket \texttt{longtable} eingebunden werden, mit dem \texttt{booktabs} ebenfalls kompatibel ist.
-Die \texttt{longtable}-Umgebung vereint die \texttt{table}- und die \texttt{tabular}-Umgebung.
-Damit ergibt sich folgende Grundstruktur:
+\paragraph{Excess length}
+For tables exceeding one page or requiring line breaks within individual cells,
+the \pkg{longtable} package can be used additionally (also supported by \pkg{booktabs}).
+The \pkg{longtable} environment combines the \mono{table} and \mono{tabular} environments.
+With it, you get the following basic structure:
 
-\begin{minted}{latex}
-\begin{longtable}
-    % Inhalte
-    \caption{<Beschriftung>}
-\end{longtable}
-\end{minted}
+\begin{samepage}
+	\codeblock{latex}{listings/tables/excess-length.tex}
+\end{samepage}
 
-\paragraph{Überbreite}
-Soll stattdessen eine sehr breite Tabelle dargestellt werden, empfiehlt es sich auf hochkant ausgerichteten Seiten, die Tabelle um 90\textdegree{} zu drehen.
-Das geht mithilfe des Pakets \texttt{rotating}.
-Der einzige Unterschied zu einer normalen Tabelle ist, dass die \texttt{table}- Umgebung durch eine \texttt{sidewaystable}-Umgebung ersetzt wird.
-Die Positionierung und die enthaltene \texttt{tabular}"=Umgebung funktionieren unverändert.
+\paragraph{Excess width}
+If you want to present a very wide table instead, it is preferable on pages in portrait orientation to turn the table by 90\textdegree{}.
+This can be done with the help of the \pkg{rotating} package.
+The only difference between this and a normal table is that the \mono{table} environment gets replaced by a \mono{sidewaystable} environment.
+Positioning and the \mono{tabular} stay unaffected.
 
-\paragraph{Weitere Möglichkeiten}
-Natürlich bietet \LaTeX{} noch viele weitere Features für ausgefeiltere Tabellen, beispielsweise zeilen- oder spaltenübergreifende Zellen. 
-Dafür, oder wenn ihr euch einfach Tipparbeit sparen wollt, empfehlen wir euch den \emph{Tables Generator,}\footnote{\url{https://tablesgenerator.com/}} in dem ihr Tabellen in \textsc{wysiwyg}-Manier zusammenklicken könnt und kopierfertigen \LaTeX-Code erhaltet.
+\paragraph{More possibilities}
+Of course, \LaTeX{} offers lots of additional features for sophisticated tables, e.\,g., row- or column-spanning cells.
+For something like this\,---\,or just to save some typing\,---\,we recommend the \emph{Tables Generator}\textit{,}\footnote{\url{https://tablesgenerator.com/}} that allows you to click your tables together in \textsc{wysiwyg} style and provides you with \LaTeX{} code ready for copying into your document.
 
 

content/text-markup.tex

@@ -1,67 +1,68 @@
-\chapter{Textauszeichnung}
+\chapter{Text markup}
 
-Bei der Textauszeichnung wird zwischen semantischer und optischer Hervorhebung unterschieden.
-Wir empfehlen, so oft wie möglich semantische Auszeichnung zu verwenden, die nur angibt, \emph{warum} etwas ausgezeichnet wird, und \LaTeX{} überlässt, \emph{wie} es aussehen soll.
-Die einfachste semantische Auszeichnung, die auch im vorherigen Satz verwendet wurde, ist eine Betonung mit \mintinline{latex}{\emph{…}}.
-Der Befehl lässt sich auch schachteln und setzt Text normalerweise kursiv bzw. in zweiter Ebene wieder gerade.
-Diese Art der Hervorhebung wird erst beim Lesen wahrgenommen und zieht nicht schon vorher Aufmerksamkeit an, wie es der farbige Befehl in diesem Absatz tut, oder Fettsatz, der eher zur Gliederung geeignet ist.
+Text markup can be done in two ways: semantically or visually.
+We recommend that you use semantic markup whenever possible.
+In contrast to visual markup, it only states \emph{why} something is special and entrusts to \LaTeX{} \emph{how} it is going to look.
+The simplest semantic markup, that was also used in the previous sentence, is an emphasis: \code{latex}{\textbackslash emph\{…\}}.
+By default, this command sets text in italics.
+When it is nested, the second level of emphasis is set straight again.
+This kind of formatting is only perceived when reading the text and does not attract attention beforehand, as colored or bold text does (which is more appropriate for higher-level structuring purposes).
 
-Einige optische Auszeichnungen werden in \cref{tbl:visual-markup} aufgelistet, sollten aber sehr vorsichtig verwendet werden.
-Grundsätzlich lassen sie sich auch untereinander schachteln, bei einigen Kombinationen werden aber die passenden Schriftschnitte fehlen.
-Viele andere Programme fangen in solchen Fällen an, vorhandene Schnitte zu verzerren, um den fehlenden Schnitt zu imitieren.
-Gut sieht so etwas aber nicht aus, deshalb verzichtet \LaTeX{} darauf.
+Some types of visual markup are listed in \cref{tbl:visual-markup}, but you should use them very carefully.
+In principle, they can also be nested, however, for some combinations, the corresponding fonts will be missing.
+Many other programs try to distort existing fonts to imitate the missing one.
+As this does not look particularly good, \LaTeX{} will not do it.
+So do not be surprised when your carefully nested selection of four different markups is just ignored and does not do anything at all.
 
 \begin{table}[H]
 	\center
 	\begin{tabular}{lll}
 		\toprule
-		Auszeichnung & Befehl & Darstellung \\
+		Markup & Command & Rendering \\
 		\midrule
-		fett & \mintinline{latex}{\textbf{bold face}} & \textbf{bold face} \\
-		kursiv & \mintinline{latex}{\textit{italics}} & \textit{italics} \\
-		Kapitälchen & \mintinline{latex}{\textsc{small caps}} & \textsc{small caps} \\
-		dicktengleich & \mintinline{latex}{\texttt{typewriter text}} & \texttt{typewriter text} \\
-		schräg & \mintinline{latex}{\texttt{slanted}} & \textsl{slanted} (bitte nicht!) \\
-		unterstrichen & \mintinline{latex}{\underline{underlined}} & \underline{underlined} \\
-		tiefgestellt & \mintinline{latex}{\textsubscript{subscript}} & x\textsubscript{subscript} \\
-		hochgestellt & \mintinline{latex}{\textsubscript{superscript}} & x\textsuperscript{superscript} \\
+		bold & \code{latex}{\textbackslash textbf\{bold face\}} & \textbf{bold face} \\
+		italics & \code{latex}{\textbackslash textit\{italics\}} & \textit{italics} \\
+		small caps & \code{latex}{\textbackslash textsc\{small caps\}} & \textsc{small caps} \\
+		monospaced & \code{latex}{\textbackslash texttt\{typewriter text\}} & \texttt{typewriter text} \\
+		slanted & \code{latex}{\textbackslash textsl\{slanted\}} & \textsl{slanted} (please, don’t!) \\
+		underlined & \code{latex}{\textbackslash underline\{underlined\}} & \underline{underlined} \\
+		subscript & \code{latex}{\textbackslash textsubscript\{subscript\}} & x\textsubscript{subscript} \\
+		superscript & \code{latex}{\textbackslash textsubscript\{superscript\}} & x\textsuperscript{superscript} \\
 		\bottomrule
 	\end{tabular}
-	\caption{Befehle zur optischen Textauszeichnung}
+	\caption{Visual markup commands}
 	\label{tbl:visual-markup}
 \end{table}
 
-Normalerweise solltet ihr diese Befehle kaum brauchen, denn da, wo diese Auszeichnungen angebracht sind, tauchen sie meistens von selbst auf, wenn ihr semantische Befehle verwendet.
-Beispielsweise stellt das Paket \texttt{hyperref} den Befehl \mintinline{latex}{\url{…}} bereit.
-Damit werden \textsc{url}s nicht nur mit einer dickten\-gleichen Schrift gesetzt, sondern sie sind auch anklickbar und werden bei Bedarf umgebrochen, ohne dass Bindestriche eingefügt werden.
+Usually, you should not need these commands too often, as they appear by themselves when you are using semantic markup.
+For instance, the \pkg{hyperref} package provides the \code{latex}{\textbackslash url\{…\}} command.
+This command does not only use a mono-spaced font for \acro{URL}s, it also makes them clickable and, if necessary, wraps them without adding hyphens.
 
-Das gleiche gilt für unterschiedliche Schriftgrößen: 
-Die Größe der Schrift im Fließtext könnt ihr mit einer Option der Dokumentenklasse festlegen: 
-\begin{minted}{latex}
-\documentclass[9pt]{article}
-\end{minted}
-Darauf aufbauend erzeugt \LaTeX{} verschiedene Schriftgrade, die durch die Befehle in \cref{tbl:type-sizes} gesetzt werden können.
-Beschränkt so etwas aber besser auf Titelseiten und ähnliches.
-Für den Rest könnt ihr auf die Standardeinstellungen vertrauen und euch das visuelle Durcheinander sparen.
+The same applies for different font sizes.
+You can specify the body text font size with an option at the document class:
+\codeblock{latex}{listings/text-markup/font-size.tex}
+Building upon this, \LaTeX{} generates different font sizes that can be called via the commands in \cref{tbl:type-sizes}.
+It is, however, best to restrict those to title pages and similar things.
+For the rest, you can trust the default settings and avoid the visual clutter.
 
 \begin{table}[H]
 	\center
 	\begin{tabular}{ll}
 		\toprule
-		Befehl & Darstellung \\
+		Command & Rendering \\
 		\midrule
-		\mintinline{latex}{{\tiny winzig}} & {\tiny winzig} \\
-		\mintinline{latex}{{\footnotesize Fußnotengröße}} & {\footnotesize Fußnotengröße} \\
-		\mintinline{latex}{{\small klein}} & {\small klein} \\
-		\mintinline{latex}{{\normalsize normal}} & {\normalsize normal} \\
-		\mintinline{latex}{{\large groß}} & {\large groß} \\
-		\mintinline{latex}{{\Large größer}} & {\Large größer} \\
-		\mintinline{latex}{{\LARGE am größten}} & {\LARGE am größten} \\
-		\mintinline{latex}{{\huge am allergrößten}} & {\huge am allergrößten} \\
-		\mintinline{latex}{{\Huge Größenwahn}} & {\Huge Größenwahn} \\
+		\code{latex}{\{\textbackslash tiny tiny\}} & {\tiny tiny} \\
+		\code{latex}{\{\textbackslash footnotesize footnote size\}} & {\footnotesize footnote size} \\
+		\code{latex}{\{\textbackslash small small\}} & {\small small} \\
+		\code{latex}{\{\textbackslash normalsize normal\}} & {\normalsize normal} \\
+		\code{latex}{\{\textbackslash large large\}} & {\large large} \\
+		\code{latex}{\{\textbackslash Large larger\}} & {\Large larger} \\
+		\code{latex}{\{\textbackslash LARGE largest\}} & {\LARGE largest} \\
+		\code{latex}{\{\textbackslash huge largest of all\}} & {\huge largest of all} \\
+		\code{latex}{\{\textbackslash Huge megalomania\}} & {\Huge megalomania} \\
 		\bottomrule
 	\end{tabular}
-	\caption{Befehle zur optischen Textauszeichnung}
+	\caption{Font size commands}
 	\label{tbl:type-sizes}
 \end{table}
 

content/titlepage.tex

@@ -4,7 +4,7 @@
 	\vspace{3em}
 	\rule{\textwidth}{1pt}\par
 	\vspace{0.8\baselineskip}
-			\Huge\bfseries Skript zum \LaTeX-Tutorium der Fachschaft \acro{WIAI}
+			\Huge\bfseries Script for the Fachschaft \acro{WIAI} \LaTeX{} Workshop
 	\rule{\textwidth}{1pt}\par
 	%{\large \today}
 	\vfill
@@ -21,9 +21,9 @@
 \vfill
 
 \begin{tabular}{@{}lp{9cm}}
-	& \subsubsection*{Impressum} \\
-	& Das \LaTeX-Skript (Version 1.0 vom 28.~Mai 2021) wurde von der Fachschaft \acro{WIAI} der Otto-Friedrich-Universität Bamberg zusammengestellt. \\
-	& Es ist unterliegt der Creative-Commons-Lizenz \enquote{Namens"-nennung – Weitergabe unter gleichen Bedingungen 4.0 International} (CC BY-SA 4.0): \\
+	& \subsubsection*{Imprint} \\
+	& The \LaTeX{} Script (version 1.1 from January 21st, 2022) has been assembled by the Student Council of the Information Systems and Applied Computer Sciences Faculty (Fachschaft \acro{WIAI}) at the University of Bamberg. \\
+	& It is licensed under Creative Commons \enquote{Attribution-ShareAlike 4.0 International} (CC BY-SA 4.0): \\
 	\href{http://creativecommons.org/licenses/by-sa/4.0/}{\includegraphics[height=.5cm]{graphics/cc-by-sa}} & \url{http://creativecommons.org/licenses/by-sa/4.0/} \\ \\
-	& Auf Nachfrage können auch über diese Lizenz hinausgehende Erlaubnisse gewährt werden.
+	& Upon request, allowances exceeding the limitations of this license may be granted.
 \end{tabular}

content/what-is-latex.tex

@@ -1,40 +0,0 @@
-\chapter{Was ist \LaTeX?}
-\label{sec:what-is-latex}
-
-Anfang der 1960er-Jahre bekam ein ziemlich begabter amerikanischer PhD-Student den Auftrag, ein Buch über Compiler zu schreiben.
-Nachdem er mit der Arbeit begonnen hatte, fragte er seinen Verleger, ob das Buch ein bisschen länger werden dürfe, da er auch die Grundlagen vorstellen wolle.
-Der Verleger antwortete, er solle das Buch so lange machen, wie er es für nötig halte.
-1968 erschien der erste Band, damals noch in Bleisatz gedruckt.
-
-Der Bleisatz wurde zu dieser Zeit durch andere Verfahren verdrängt, mit deren Qualität der Autor aber nicht zufrieden war. 
-Er begann deshalb Ende der 70er-Jahre mit der Entwicklung seines eigenen Textsatzsystems \TeX, \emph{tech} ausgesprochen – nach dem altgriechischen Wort \texttau$\mathrm{\acute{\varepsilon}}$\textchi\textnu\texteta{} (technē) für \emph{Kunst}.
-
-Inzwischen ist Donald Knuth (so heißt der ehemalige Student) emeritierter Informatikprofessor und sein Compilerbuch auf das mehrbändige Standardwerk \emph{The Art of Computer Programming} angewachsen – von dem allerdings drei Bände noch ausstehen, darunter auch der über Compiler.
-Im Gegensatz zum Buch ist \TeX{} heute die seltene Erscheinung eines Softwaresystems, das man als \emph{fertig} bezeichnen darf, ohne damit \emph{tot} zu meinen.
-
-Zwei Buchstaben fehlen noch zu \LaTeX: 
-Es sind die Anfangsbuchstaben des Nachnamens von Leslie Lamport, der in den 80er-Jahren basierend auf \TeX{} eine Sammlung von kleinen Programmen geschrieben hat, die das System für uns Endanwender nutzbar machten und so zu seiner Verbreitung beitrugen.
-Die aktuelle Version \LaTeXe{} gibt es seit Mitte der 90er.
-
-Wozu erzählen wir euch das? 
-Weil es einige der Vorteile begründet, die \LaTeX{} heute noch auszeichnen:
-Es ist ein ausgereiftes, stabiles, verlässliches System,
-das weitgehend automatisch typografisch hochwertigen Textsatz erzeugt.
-
-Da der \TeX-Code in Plaintext-Dateien abgelegt wird (siehe \cref{sec:basic-functionality}), ergeben sich weitere Vorteile:
-Ihr könnt eure Projekte übersichtlich strukturieren (\cref{sec:project-structure}),
-und wann immer ihr Änderungen im Quelltext rückgängig macht, könnt ihr euch darauf verlassen, wieder die gleiche Ausgabe wie vorher zu erhalten. 
-Das klappt in größerem Maßstab natürlich auch in Verbindung mit Git oder anderen Quelltextversionierungstools.
-Außerdem bleibt euer Quelltext langfristig zuverlässig lesbar, ohne dass ihr bestimmte Programme dafür benötigt.
-Gleichzeitig ist der Austausch mit allen Programmen, die Plaintext unterstützen, sehr einfach.
-
-% Quellen:
-% https://en.wikipedia.org/wiki/Donald_Knuth
-% https://de.wikipedia.org/wiki/Donald_E._Knuth
-% https://en.wikipedia.org/wiki/The_Art_of_Computer_Programming
-% https://de.wikipedia.org/wiki/The_Art_of_Computer_Programming
-% https://en.wikipedia.org/wiki/TeX
-% https://de.wikipedia.org/wiki/TeX
-% https://de.wikipedia.org/wiki/LaTeX
-% https://en.wikipedia.org/wiki/LaTeX
-

content/why-use-latex.tex

@@ -0,0 +1,45 @@
+\chapter{Why use \LaTeX?}
+\label{sec:why-uses-latex}
+
+In the early 1960s, a rather talented American Ph.D. student was asked by a big publishing company whether he wanted to write a book on compilers.
+He did.
+Soon after he had begun with his research, he realized that he wanted to start with some foundations of computer science, so he asked the publishers if the book might be a little longer.
+They replied, \enquote{make it as long as you feel necessary.}
+In 1968, the first volume was published, at that time still printed using mechanical typesetting.
+
+This method was just disappearing then, and being replaced by new methods.
+However, the author did not like the results of those new methods, so,
+at the end of the 70s, he began to develop his own typesetting system \TeX{}
+(pronounced as \textipa{[tEx]}, \textipa{[tE\c{c}]} or \textipa{[tEk]}, named after the ancient Greek word \texttau$\mathrm{\acute{\varepsilon}}$\textchi\textnu\texteta{} \textipa{['tExnE:]} meaning \emph{art, craft}).
+
+Today, Donald Knuth (that is the former student’s name) is a retired professor of computer science and his compiler book has grown to become the multi-volume standard work \emph{The Art of Computer Programming}\,—\,three volumes of which are still to be written, among them the one on compilers.
+Unlike the book, however, \TeX{} is the rare occurrence of a software system that may actually be called \emph{complete} without meaning \emph{dead}.
+
+Two more letters are needed for \LaTeX:
+They are the initial two letters of the last name of Leslie Lamport, who, in the 80s, extended \TeX{} by a collection of small programs that made the entire system usable for us end-users and are responsible for its widespread adoption.
+The current version dates from the mid~90s.
+
+Why are we telling you all of that?
+It explains some of the advantages that still distinguish \LaTeX{} today:
+It is a mature, stable, and reliable system
+that does typesetting in a typographically sophisticated way and mostly automatically.
+
+As the \TeX{} code is stored in plain text files (cf. \cref{sec:basic-functionality}),
+even more advantages arise:
+You can structure your projects clearly (cf. \cref{sec:project-structure}),
+and whenever you undo changes in the source code, you can always rely on getting exactly the same output as before
+rather than some more or less similar reconstruction.
+On a larger scale, this does also work in connection with Git or other source code versioning tools.
+Furthermore, you can trust your source code to be readable long-term, without any specific software.
+It can always be opened with any program that supports plain text.
+
+% Quellen:
+% https://en.wikipedia.org/wiki/Donald_Knuth
+% https://de.wikipedia.org/wiki/Donald_E._Knuth
+% https://en.wikipedia.org/wiki/The_Art_of_Computer_Programming
+% https://de.wikipedia.org/wiki/The_Art_of_Computer_Programming
+% https://en.wikipedia.org/wiki/TeX
+% https://de.wikipedia.org/wiki/TeX
+% https://de.wikipedia.org/wiki/LaTeX
+% https://en.wikipedia.org/wiki/LaTeX
+

exercises/basic-document-structure/document-structure.code.tex

@@ -0,0 +1,41 @@
+% \documentclass{scrartcl}
+% \usepackage[utf8]{inputenc}
+% \usepackage[T1]{fontenc}
+% \usepackage[english]{babel}
+% \usepackage[hidelinks]{hyperref}
+	
+% \begin{document}
+% \tableofcontents
+	
+\section{Beverages}
+	
+\subsection{Pink Lemonade}
+We all know and love it in summer: a cold lemonade. The pink variant of our  favorite summer drink is traditionally achieved by adding food coloring to the lemonade. 
+However, we changed things up a little and decided to go for a variant with berries instead of food coloring, which also makes the drink less sour.
+	
+\subsubsection{Ingredients}
+For making the lemonade we need 400\,g of berries. You can use either frozen or fresh ones. You can, of course, adjust the choice of berries to your likings: raspberries, blueberries, blackberries, or a mixture work excellently for making the lemonade.
+
+To make the drink sweeter we use 50\,ml of maple syrup. Needless to say, you can also use less, if you want your lemonade to be more sour. By the way, other sweeteners, such as agave syrup, or coconut sugar also work fine.
+
+Additionally, we need the juice of four freshly-squeezed lemons, one litre worth of cold water and 400\,g of ice cubes to keep the drink cold.
+	
+\subsubsection{Instructions}
+Put the berries along with the maple syrup into a large bowl and cook them at medium-high heat for around three to four minutes. When the berries start to soften, reduce the heat a little. Now mash the berries with the end of a wooden spoon until there are almost no big chunks anymore. The less chunks the better!
+	
+Place a sieve over the container that you want to store the lemonade in. Put the berries into the sieve. With the end of the wooden spoon, try to press out as much liquid of the berry mixture as possible. Let the juice sit until it is completely cold.
+	
+When the liquid is cold, add the lemon juice, the cold water, and the ice cubes and stir everything. 
+	
+	
+Your lemonade is now ready to enjoy!
+	
+\subsection{Hot Chocolate}
+Coming soon!
+	
+\section{Breakfast}
+
+\subsubsection{Buckwheat Overnight Oats}
+Coming soon!
+	
+% \end{document}

exercises/basic-document-structure/document-structure.done.tex

@@ -1,40 +1 @@
-\begin{minted}[breaklines]{latex}
-% \documentclass{scrartcl}
-% \usepackage[utf8]{inputenc}
-% \usepackage[T1]{fontenc}
-% \usepackage[ngerman]{babel}
-% \usepackage[hidelinks]{hyperref}
-	
-% \begin{document}
-% \tableofcontents
-	
-\section{Getränke}
-	
-\subsection{Pink Lemonade}
-Wir alle kennen und lieben sie im Sommer: eine kühle Limonade. Die pinke Variante wurde traditionell zubereitet, indem man der Limonade Lebensmittelfarbe hinzugefügt hat. Wir haben das Ganze etwas abgewandelt und uns für eine Variante mit Beeren entschieden, um den sauren Geschmack der Zitronen auszugleichen. Dadurch wird die Limonade ein perfekter und erfrischender Sommer-Drink!
-	
-\subsubsection{Zutaten}
-Für die Zubereitung der Limonade braucht ihr 400 g Beeren. Sie können entweder gefroren oder frisch sein. Bei der Wahl der Beeren könnt ihr euch austoben: Himbeeren, Heidelbeeren, Brombeeren oder auch eine Mischung aus verschiedenen Beeren eignen sich hervorragend. 
-	
-Für ein wenig Süße nutzen wir 50 ml Ahornsirup, natürlich könnt ihr auch mehr oder weniger nehmen, je nachdem, wie sauer ihr eure Limonade haben wollt. Übrigens eignen sich auch andere Süßungsmittel wie etwa Agavendicksaft oder Kokosblütensirup wunderbar.
-	
-Außerdem benötigen wir noch 4 gepresste Zitronen, ungefähr einen Liter kaltes Wasser und 400 g Eiswürfel, damit das Getränk auch schön kühl bleibt.
-	
-\subsubsection{Zubereitung}
-Die Beeren zusammen mit dem Ahornsirup in einen Kochtopf geben und bei mittlerer Hitze für drei bis vier Minuten kochen. Sobald die Beeren anfangen, weich zu werden, könnt ihr die Hitze etwas reduzieren. Mit dem Ende eines Holzlöffels zerdrückt ihr nun die Beeren, bis so gut wie keine großen Stücke mehr vorhanden sind. Je weniger Stücke, desto besser!
-	
-Nun platziert ihr ein Sieb über dem Gefäß, in dem ihr eure Limonade aufbewahren wollt, und gebt die Himbeeren in das Sieb. Mit der Rückseite eines Löffels versucht ihr, so viel Saft wie möglich aus der Beeren-Mixtur zu pressen. Den Saft danach abkühlen lassen.
-	
-Sobald eure Beeren-Flüssigkeit abgekühlt ist, gebt den Zitronensaft, das kalte Wasser und die Eiswürfel hinzu und rührt alles ordentlich um.
-	
-Eure Limonade ist nun fertig zum genießen und bereit, in Gläser gefüllt zu werden!
-	
-\subsection{Heiße Schokolade}
-Coming soon!
-	
-\section{Frühstücksgerichte}
-\subsubsection{Overnight Oats aus Couscous}
-Coming soon!
-	
-% \end{document}
-\end{minted}
+\codeblock{latex}{./exercises/basic-document-structure/document-structure.code.tex}

exercises/basic-document-structure/document-structure.raw.tex

@@ -1,25 +1,25 @@
 
-	1. Getränke
+	1. Beverages
 	
 	1.1 Pink Lemonade
-	Wir alle kennen und lieben sie im Sommer: eine kühle Limonade. Die pinke Variante wurde traditionell zubereitet, indem man der Limonade Lebensmittelfarbe hinzugefügt hat. Wir haben das Ganze etwas abgewandelt und uns für eine Variante mit Beeren entschieden, um den sauren Geschmack der Zitronen auszugleichen. Dadurch wird die Limonade ein perfekter und erfrischender Sommer-Drink!
+	We all know and love it in summer: a cold lemonade. The pink variant of our favorite summer drink is traditionally achieved by adding food coloring to the lemonade. However, we changed things up a little and decided to go for a variant with berries instead of food coloring, which also makes the drink less sour.
 	
-	1.1.1 Zutaten
-	Für die Zubereitung der Limonade braucht ihr 400 g Beeren. Sie können entweder gefroren oder frisch sein. Bei der Wahl der Beeren könnt ihr euch austoben: Himbeeren, Heidelbeeren, Brombeeren oder auch eine Mischung aus verschiedenen Beeren eignen sich hervorragend. \\
-	Für ein wenig Süße nutzen wir 50 ml Ahornsirup, natürlich könnt ihr auch mehr oder weniger nehmen, je nachdem, wie sauer ihr eure Limonade haben wollt. Übrigens eignen sich auch andere Süßungsmittel wie etwa Agavendicksaft oder Kokosblütensirup wunderbar. \\
-	Außerdem benötigen wir noch 4 gepresste Zitronen, ungefähr einen Liter kaltes Wasser und 400 g Eiswürfel, damit das Getränk auch schön kühl bleibt.
+	1.1.1 Ingredients
+	For making the lemonade we need 400\,g of berries. You can use either frozen or fresh ones. You can, of course, adjust the choice of berries to your likings: raspberries, blueberries, blackberries, or a mixture work excellently for making the lemonade. \\
+	To make the drink sweeter we use 50\,ml of maple syrup. Needless to say, you can also use less, if you want your lemonade to be more sour. By the way, other sweeteners, such as agave syrup, or coconut sugar also work fine. \\ 
+	Additionally, we need the juice of four freshly-squeezed lemons, one litre worth of cold water and 400\,g of ice cubes to keep the drink cold.
 	
-	1.1.2 Zubereitung
-	Die Beeren zusammen mit dem Ahornsirup in einen Kochtopf geben und bei mittlerer Hitze für drei bis vier Minuten kochen. Sobald die Beeren anfangen, weich zu werden, könnt ihr die Hitze etwas reduzieren. Mit dem Ende eines Holzlöffels zerdrückt ihr nun die Beeren, bis so gut wie keine großen Stücke mehr vorhanden sind. Je weniger Stücke, desto besser! \\
-	Nun platziert ihr ein Sieb über dem Gefäß, in dem ihr eure Limonade aufbewahren wollt, und gebt die Himbeeren in das Sieb. Mit der Rückseite eines Löffels versucht ihr, so viel Saft wie möglich aus der Beeren-Mixtur zu pressen. Den Saft danach abkühlen lassen. \\
-	Sobald eure Beeren-Flüssigkeit abgekühlt ist, gebt den Zitronensaft, das kalte Wasser und die Eiswürfel hinzu und rührt alles ordentlich um. \\
-	Eure Limonade ist nun fertig zum genießen und bereit, in Gläser gefüllt zu werden!
+	1.1.2 Instructions
+	Put the berries along with the maple syrup into a large bowl and cook them at medium-high heat for around three to four minutes. When the berries start to soften, reduce the heat a little. Now mash the berries with the end of a wooden spoon until there are almost no big chunks anymore. The less chunks the better! \\
+	Place a sieve over the container that you want to store the lemonade in. Put the berries into the sieve. With the end of the wooden spoon, try to press out as much liquid of the berry mixture as possible. Let the juice sit until it is completely cold. \\
+	When the liquid is cold, add the lemon juice, the cold water, and the ice cubes and stir everything. \\
+	Your lemonade is now ready to enjoy!
 	
-	1.2 Heiße Schokolade
+	1.2 Hot Chocolate
 	Coming soon!
 	
-	2. Frühstücksgerichte
+	2. Breakfast 
 	
-	2.1 Overnight Oats aus Couscous
+	2.1 Buckwheat Porridge
 	Coming soon!
 	

exercises/basic-document-structure/preamble.code.tex

@@ -0,0 +1,4 @@
+\documentclass{scrartcl}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage[english]{babel}

exercises/basic-document-structure/task.tex

@@ -1,7 +1,17 @@
 \begin{enumerate}
-	\item Im Ordner \mintinline{latex}{exercises/basic-document-structure} findet ihr eine Datei namens \mintinline{latex}{document-structure.tex}. Öffnet die Datei, kopiert den Text und fügt ihn in eine neue Datei ein, die ihr beispielsweise \mintinline[breaklines, breakbytokenanywhere]{latex}{document- structure-solution.tex} nennt. Packt den Text in der neuen Datei in eine \mintinline{latex}{document}-Umgebung und fügt eine Präambel ein, um euer erstes \LaTeX -Dokument anschließend kompilieren zu können. Kompiliert nun das neue Dokument. 
-	\item Herzlichen Glückwunsch, ihr habt euer erstes eigenes \LaTeX -Dokument erstellt und kompiliert. Wie euch vielleicht aufgefallen ist, sind die Absätze im Dokument mit \mintinline{latex}{\\} erstellt worden. Ersetzt diese durch richtige Absätze.
-	\item Nun ist es an der Zeit, das Dokument etwas zu strukturieren. Verwendet für die Überschriften die passenden \LaTeX -Befehle (\mintinline{latex}{\section}, \mintinline{latex}{\subsection}, usw.) und fügt anschließend ein Inhaltsverzeichnis in euer Dokument ein.
-	\item Kommentiert im Anschluss die Präambel, die Dokumentenumgebung und das Inhaltsverzeichnis wieder aus. Nur so kann eure Lösung auch ins Skript eingebunden werden.
+	\item In the directory \file{exercises/basic-document-structure}, you can find a file named \file{document-structure.tex}. Wrap the text of the file in a \code{latex}{document} environment and add the following preamble. Afterwards, compile the document. 
+	\codeblock{latex}{./exercises/basic-document-structure/preamble.code.tex}
+	\item Congratulations! You have created and compiled your first \LaTeX{} 
+	document. Maybe you have noticed that paragraphs within the text were 
+	created by using \code{latex}{\textbackslash\textbackslash}. Replace the 
+	two backslashes by real paragraphs.
+	\item It is time to structure your first document. Use the \LaTeX{} 
+	commands \code{latex}{\textbackslash section}, 
+	\code{latex}{\textbackslash subsection}, etc. to structure the text. 
+	Also, 
+	include 
+	a table of contents for your document. 
+	\item Afterwards, comment out the preamble, the document environment, and the table of contents. 
 \end{enumerate}
+
 \exercisematerial{exercises/basic-document-structure/document-structure}

exercises/footnotes/footnotes.code.tex

@@ -0,0 +1,7 @@
+Java is an object-oriented programming language, that appeared in 
+1995. The most recent version of the programming language is 
+version 16\footnote{March 2021}. In order to write Java programs, 
+one needs to install the so-called \emph{Java Development Kit 
+(JDK)}.\footnote{\url{https://www.oracle.com/java/technologies/javase-downloads.html}}
+Java programs can be written independently from the operating 
+system that one uses.

exercises/footnotes/footnotes.done.tex

@@ -1,5 +1 @@
-\begin{minted}[breaklines,breakanywhere]{latex}
-Java ist eine objektorientierte Programmiersprache, die im Jahr 1995 erschienen ist. Die aktuellste Variante der Programmiersprache befindet sich mittlerweile in der Version 16\footnote{Stand: März 2021}. Um ein Java-Programm zu schreiben benötigt man, unter anderem, das sogenannte \emph{Java Development Kit (JDK)}.\footnote{\url{https://www.oracle.com/java/technologies/javase-downloads.html}} Java-Programme lassen sich unabhängig vom Betriebssystem, auf dem man sich befindet, schreiben.
-\end{minted}
-
-	
+\codeblock{latex}{./exercises/footnotes/footnotes.code.tex}

exercises/footnotes/footnotes.raw.tex

@@ -1 +1 @@
-Java ist eine objektorientierte Programmiersprache, die im Jahr 1995 erschienen ist. Die aktuellste Variante der Programmiersprache befindet sich mittlerweile in der Version 16 (Stand: März 2021). Um ein Java-Programm zu schreiben benötigt man, unter anderem, das sogenannte \emph{Java Development Kit (JDK)}. Java-Programme lassen sich unabhängig vom Betriebssystem, auf dem man sich befindet, schreiben.
+Java is an object-oriented programming language, that appeared in 1995. The most recent version of the programming language is version 16 (March 2021). In order to write Java programs, one needs to install the so-called \emph{Java Development Kit (JDK)}. Java programs can be written independently from the operating system that one uses.

exercises/footnotes/task.tex

@@ -1,4 +1,10 @@
-Integriert im Text der Datei \mintinline{bash}{exercises/footnotes/footnotes.tex} das Statement \glqq{}Stand: März 2021\grqq{} in eine Fußnote. Fügt außerdem eine klickbare URL als Fußnote zum Download des Java Development Kits ein:\\
+Make the text \enquote{March 2021} of the file 
+\file{exercises/footnotes/footnotes.tex} appear as a footnote instead of in 
+parentheses. Additionally, insert a clickable URL to the Java Development Kit 
+as footnote.
+
+\todo{Sollten wir dieses Beispiel aus Faulheitsgründen vielleicht ersetzen?}
+
 \texttt{https://www.oracle.com/java/technologies/javase-downloads.html}
 
 \exercisematerial{exercises/footnotes/footnotes}

exercises/graphics/graphics.code.tex

@@ -0,0 +1,5 @@
+\begin{figure}[H]
+	\centering
+	\includegraphics[width=\textwidth]{exercises/graphics/latex-logo.png}
+	\caption{The \LaTeX{} Project Logo}
+\end{figure}

exercises/graphics/graphics.done.tex

@@ -1,7 +1 @@
-\begin{minted}[breaklines,breakanywhere]{latex}
-\begin{figure}[H]
-	\centering
-	\includegraphics[width=\textwidth]{exercises/graphics/latex-logo.png}
-	\caption{Das \LaTeX{}-Projekt-Logo}
-\end{figure}
-\end{minted}
+\codeblock{latex}{./exercises/graphics/graphics.code.tex}

exercises/graphics/graphics.raw.tex

@@ -1 +1 @@
-Bitte hier das Bild einfügen.
+Please insert the image here.

exercises/graphics/task.tex

@@ -1,3 +1,9 @@
-Bei den Übungsaufgaben findet ihr im Ordner \mintinline{latex}{graphics} eine Bilddatei namens \mintinline{latex}{latex-logo.png}. Fügt das Bild in die Datei \mintinline{bash}{exercises/graphics/graphics.tex} ein. Sorgt dafür, dass das Bild genau unter diesem Text erscheint. Das Bild soll außerdem zentriert eingebunden werden und über eine Bildunterschrift verfügen. Passt die Größe außerdem an die Breite der Seite (\mintinline{latex}{\textwidth}) an.
+In the \file{exercises/graphics} directory you can find an image file 
+\file{latex-logo.png}. Insert the image into the 
+\file{exercises/graphics/graphics.tex} file. Make sure that the image is placed 
+exactly where you have specified it. On top of that, the picture shall be 
+centered, and a caption shall be added. Adapt the image width to the text width 
+(\code{latex}{\textbackslash textwidth}).
+
 
 \exercisematerial{exercises/graphics/graphics}

exercises/lists/lists.code.tex

@@ -0,0 +1,24 @@
+Ingredients:
+400 g berries, 50 ml maple syrup, 4 lemons, 1 l cold water, 400 g ice cubes
+
+\noindent Instructions: Boil and shred the berries, add maple syrup, squeeze the lemons and add their juice, add the remaining ingredients, scramble thoroughly
+
+\begin{itemize}
+	\item Ingredients:
+	\begin{compactitem}
+		\item 400 g berries
+		\item 50 ml maple sirup 
+		\item 4 lemons
+		\item 1 l cold water
+		\item 400 g ice cubes
+	\end{compactitem}
+
+	\item Instructions:
+	\begin{compactenum}
+		\item boil and shred the berries
+		\item add maple sirup
+		\item squeeze the lemons and add their juice
+		\item add the remaining ingredients
+		\item scramble thoroughly
+	\end{compactenum}
+\end{itemize}

exercises/lists/lists.done.tex

@@ -1,20 +1 @@
-\begin{minted}{latex}
-\begin{itemize}
-	\item Zutaten:
-	\begin{compactitem}
-		\item 400 g Beeren
-		\item 50 ml Ahornsirup 
-		\item 4 gepresste Zitronen
-		\item 1 Liter kales Wasser
-		\item 400 g Eiswürfel
-	\end{compactitem}
-
-	\item Arbeitsschritte:
-	\begin{compactenum}
-		\item Beeren kochen und zu Saft verarbeiten
-		\item Ahornsirup hinzufügen
-		\item Zitronensaft auspressen
-		\item restliche Zutaten zusammenfügen und verrühren
-	\end{compactenum}
-\end{itemize}
-\end{minted}
+\codeblock{latex}{./exercises/lists/lists.code.tex}

exercises/lists/lists.raw.tex

@@ -1,4 +1,4 @@
-Zutaten:
-400 g Beeren, 50 ml Ahornsirup, 4 gepresste Zitronen, 1 Liter kaltes Wasser, 400 g Eiswürfel
+Ingredients:
+400~g berries, 50~ml maple sirup, 4~lemons, 1~l cold water, 400~g ice cubes
 
-\noindent Arbeitsschritte: Beeren kochen und zu Saft verarbeiten, Ahornsirup hinzufügen, Zitronensaft auspressen, restliche Zutaten zusammenfügen und verrühren
+\noindent Instructions: Boil and shred the berries, add maple sirup, squeeze the lemons and add their juice, add the remaining ingredients, scramble thoroughly

exercises/lists/task.tex

@@ -1,3 +1,9 @@
-Formatiert das Rezept in der Datei \mintinline{bash}{exercises/lists/lists.tex} als ungeordnete Liste (\mintinline{latex}{itemize}) mit den Elementen \emph{Zutaten} und \emph{Arbeitsschritte}. Innerhalb dieser soll eine kompakte, ungeordnete Liste (\mintinline{latex}{compactitem}) der Zutaten erstellt werden. Die Arbeitsschritte hingegen sollen als kompakte, geordnete Liste dargestellt werden.
+% TODO:
+Format the recipe you can find in \file{exercises/lists/lists.tex} as an 
+unordered list (\code{latex}{itemize}) with sub-lists \emph{Ingredients} 
+and \emph{Instructions}. 
+Within these, there shall be a compact, unordered list 
+(\code{latex}{compactitem}) of ingredients and a compact, ordered list of 
+instructions, respectively.
 
 \exercisematerial{exercises/lists/lists}

exercises/literature/exercise-solution.tex

@@ -0,0 +1,4 @@
+The first-mentioned book \citep{lamport1994} has been written by the creator of \LaTeX{}, Leslie Lamport himself. A more recent publication is \enquote{\LaTeX\ in 24 Hours} \citep{datta2017}. There is a plethora of further handbooks \citep*[e.\,g.,][]{goossensmittelbach2002}.
+
+\bibliographystyle{natdin}
+\bibliography{exercises/literature/literature.done.bib}

exercises/literature/literature.done.tex

@@ -1,10 +1,4 @@
-\inputminted[breaklines]{bibtex}{exercises/literature/literature.done.bib}
+%\inputminted[breaklines]{bibtex}{exercises/literature/literature.done.bib}
+\codeblock{bibtex}{./exercises/literature/literature.done.bib}
 
-\begin{minted}[breaklines]{latex}
-Das erstgenannte Buch \citep{lamport1994} wurde vom Schöpfer von LaTeX, Leslie Lamport, selbst verfasst.
-Da es bereits etwas betagter ist, geben wir euch mit \glqq{}\LaTeX\ in 24 Hours\grqq{} \citep{datta2017} noch ein aktuelleres Buch in die Hand.
-Es gibt eine Unmenge weiterer Handbücher \citep*[u.\thinspace a.][]{goossensmittelbach2002}.
-
-\bibliographystyle{natdin}
-\bibliography{exercises/literature/literature.done.bib}
-\end{minted}
+\codeblock{latex}{./exercises/literature/exercise-solution.tex}

exercises/literature/literature.raw.tex

@@ -1,6 +1,6 @@
-Das erstgenannte Buch (Lamport, 1994) wurde vom Schöpfer von LaTeX, Leslie Lamport, selbst verfasst.
-Da es bereits etwas betagter ist, geben wir euch mit \glqq{}\LaTeX\ in 24 Hours\grqq{} (Datta, 2017) noch ein aktuelleres Buch in die Hand.
-Es gibt eine Unmenge weiterer Handbücher (u.\thinspace a. Goossens, Mittelbach u. Samarin, 2002).
+The first-mentioned book (Lamport, 1994) has been written by the creator of \LaTeX{}, Leslie Lamport himself.
+A more recent publication is \enquote{\LaTeX\ in 24 Hours} (Datta, 2017).
+There is a plethora of further handbooks (e.\,g., Goossens, Mittelbach and Samarin, 2002).
 
 ~\\
 

exercises/literature/task.tex

@@ -1,18 +1,22 @@
 \begin{enumerate}
-  \item Sucht bei Google Scholar die Bib\TeX-Einträge für folgende \LaTeX"=Handbücher:
+  \item Use Google Scholar to retrieve Bib\TeX{} entries for the following \LaTeX{}
+  handbooks:
   \begin{itemize}
     \item Leslie Lamport (1994): \LaTeX. A Document Preparation System.
     \item Dilip Datta (2017): \LaTeX\ in 24 Hours. A Practical Guide for Scientific Writing.
     \item Frank Mittelbach / Michel Goossens (2002): Der \LaTeX-Begleiter.
   \end{itemize}
-  \item Vergleicht die Einträge mit den Ergebnissen, die euch \url{dblp.org} für dieselben Bücher liefert.
-  \item Erstellt im Ordner \mintinline{latex}{exercises/literature} eine neue Bib\TeX-Datei mit dem Namen \mintinline{sh}{literature.bib}.
-  \item Fügt die Bib\TeX-Einträge in die Bib\TeX-Datei ein. Wählt hierfür aus Google Scholar und dblp die aus eurer Sicht geeigneteren Einträge.
-  \item Vergebt aussagekräftige Bib\TeX-Keys.
-  \item Bindet die Bib\TeX-Datei an einer geeigneten Stelle ein, an der später auch das Literaturverzeichnis zu sehen sein soll.
-  \item Zitiert die drei Handbücher in der Datei\\\mintinline{sh}{exercises/literature/literature.tex}.
-  \item Wählt den Bibliographiestil \mintinline{sh}{natdin}.
-  \item \textbf{Hinweis}: Sollte das Kompilieren fehlschlagen, kann es hilfreich sein, einmal alle Hilfsdateien (\mintinline{sh}{main.aux/bbl/blg/loc/out/pdf/soc/toc}) zu löschen und neu zu kompilieren.
+  \item Compare the entries with the results that \url{dblp.org} finds for the same titles.
+  \item Create a new Bib\TeX{} file called \file{literature.bib} in the 
+  \file{exercises/literature} folder.
+  \item Add the Bib\TeX{} entries to the newly created Bib\TeX{} files. For this, select your preferred source among Google Scholar and dblp.
+  \item Assign unique and meaningful Bib\TeX{} keys.
+  \item Include the Bib\TeX{} file in a suitable location, where later on the references should be listed.
+  \item Cite the three handbooks in the 
+  file\\\file{exercises/literature/literature.tex}.
+  \item Make use of the \mono{natdin} biliography style.
+  \item \textbf{Note}: If compiling fails, it may help to remove all auxiliary 
+  files \\(\mono{main.aux/bbl/blg/loc/out/pdf/soc/toc}) before compiling again.
 \end{enumerate}
 
 \exercisematerial{exercises/literature/literature}

exercises/maths/math-formulas.code.tex

@@ -0,0 +1,22 @@
+% Gravitational acceleration in Germany
+$$9,81\,\frac{m}{s^2}$$
+
+% pq formula
+$$x_{1,2} = - \frac{p}{2} \pm \sqrt{\left(\frac{p}{2}\right)^2 - q}$$
+
+% Quadratic formula
+$$x_{1,2} = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$
+
+% Catalan numbers
+\begin{equation*}
+  C_n = \frac{1}{n+1} {2n \choose n} = \frac{(2n)!}{(n+1)!n!}
+\end{equation*}
+
+% Definition of a factorial
+$$n! = \prod_{i=1}^{n} i$$
+
+% Set of all odd natural numbers
+$$\{ x \mid x \in \mathds{N}, \mathrm{odd}(x) \}$$
+
+% Elimination $\neg\exists x$
+$$\neg\exists x . p(x) \Leftrightarrow \forall x . \neg p(x)$$

exercises/maths/math-formulas.done.tex

@@ -1,25 +1 @@
-\begin{minted}{latex}
-
-% Fallbeschleunigung in Deutschland
-$$9,81\,\frac{m}{s^2}$$
-
-% pq-Formel
-$$x_{1,2} = - \frac{p}{2} \pm \sqrt{\left(\frac{p}{2}\right)^2 - q}$$
-
-% Mitternachtsformel
-$$x_{1,2} = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$
-
-% Catalansche Zahlen
-\begin{equation*}
-  C_n = \frac{1}{n+1} {2n \choose n} = \frac{(2n)!}{(n+1)!n!}
-\end{equation*}
-
-% Definition der Fakultät
-$$n! = \prod_{i=1}^{n} i$$
-
-% Menge aller ungeraden natürlichen Zahlen
-$$\{ x \mid x \in \mathds{N}, \mathrm{ungerade}(x) \}$$
-
-% Elimination $\neg\exists x$
-$$\neg\exists x . p(x) \Leftrightarrow \forall x . \neg p(x)$$
-\end{minted}
+\codeblock{latex}{./exercises/maths/math-formulas.code.tex}

exercises/maths/math-formulas.raw.tex

@@ -1,2 +1,2 @@
-% Ersetzt diese Grafik durch die entsprechenden Formeln:
+% Replace this graphic by the corresponding formulas:
 \includegraphics{graphics/math-formulas.rend-crop.pdf}

exercises/maths/math-formulas.rend.tex

@@ -15,28 +15,28 @@
 \hrule
 \begin{center}
 
-\textbf{Fallbeschleunigung in Deutschland}
+\textbf{Gravitational acceleration in Germany}
 $$9,81\,\frac{m}{s^2}$$ \\
 ~ \\
 
-\textbf {pq-Formel}
+\textbf {\textit{pq} formula}
 $$x_{1,2} = - \frac{p}{2} \pm \sqrt{\left(\frac{p}{2}\right)^2 - q}$$ \\
 ~ \\
 
-\textbf{Mitternachtsformel} 
+\textbf{Quadratic formula} 
 $$x_{1,2} = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$ \\
 ~ \\
 
-\textbf{Catalansche Zahlen}
+\textbf{Catalan numbers}
 \begin{equation*} C_n = \frac{1}{n+1} {2n \choose n} = \frac{(2n)!}{(n+1)!n!} \end{equation*} \\
 ~ \\
 
-\textbf{Definition der Fakultät} 
+\textbf{Definition of a factorial} 
 $$n! = \prod_{i=1}^{n} i$$ \\
 ~ \\
 
-\textbf{Menge aller ungeraden natürlichen Zahlen}
-$$\{ x \mid x \in \mathds{N}, \mathrm{ungerade}(x) \}$$
+\textbf{Set of all odd natural numbers}
+$$\{ x \mid x \in \mathds{N}, \mathrm{odd}(x) \}$$
 ~ \\
 
 \textbf{Elimination $\neg\exists x$}

exercises/maths/task.tex

@@ -1,3 +1,4 @@
-Setzt die folgenden Formeln und beachtet dabei die Größe der Klammern.
+Use \LaTeX{} math mode to typeset the following formulas.
+Pay attention to the size of brackets.
 
-\exercisematerial{exercises/maths/math-formulas}
+\exercisematerial{exercises/maths/math-formulas}

exercises/project-structure/main-with-preamble.done.tex

@@ -3,7 +3,7 @@
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
 
-\title{Übung zur Projektstruktur}
+\title{Exercise on Project Structure}
 
 \begin{document}
 \maketitle

exercises/project-structure/main.raw.tex

@@ -1,16 +1,16 @@
 \documentclass{article}
-\usepackage[ngerman]{babel}
+\usepackage[english]{babel}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
 
-\title{Übung zur Projektstruktur}
+\title{Exercise on Project Structure}
 
 \begin{document}
 \maketitle
 \tableofcontents
 
 \newpage
-\section{Erster Abschnitt}
+\section{First section}
 Jelly beans tiramisu chocolate bar chupa chups candy canes lollipop liquorice cheesecake tootsie roll. Marshmallow sugar plum cake tiramisu jelly cake bear claw. Croissant liquorice jelly lollipop carrot cake. Cheesecake danish chocolate halvah. Candy canes jujubes chupa chups jujubes candy canes tootsie roll toffee danish sesame snaps. Sugar plum gummi bears lollipop chocolate bar. Ice cream soufflé sweet lemon drops chocolate soufflé gingerbread cookie muffin.
 
 Sugar plum danish halvah jujubes pastry donut carrot cake dessert donut. Sweet gingerbread gingerbread wafer gummi bears pastry. Tootsie roll donut powder cake. Brownie halvah lollipop gummi bears. Liquorice pie caramels jelly beans. Halvah danish brownie danish toffee cotton candy lemon drops.
@@ -18,7 +18,7 @@ Sugar plum danish halvah jujubes pastry donut carrot cake dessert donut. Sweet g
 Donut jelly beans candy canes muffin lemon drops carrot cake sugar plum. Sesame snaps pie bonbon cotton candy cookie caramels. Chupa chups dessert tootsie roll carrot cake candy cookie sweet roll jelly beans. Oat cake halvah gingerbread bonbon sweet sesame snaps dragée carrot cake. Bonbon pastry chupa chups. Chocolate cake macaroon jelly-o. Pastry pastry sugar plum jujubes lemon drops gummi bears sugar plum cheesecake fruitcake. Chocolate cake chocolate candy. Wafer carrot cake chocolate cake jujubes cupcake soufflé gingerbread chocolate cake donut.
 
 \newpage
-\section{Zweiter Abschnitt}
+\section{Second section}
 
 Sweet roll tart chocolate bar cotton candy jelly beans cheesecake. Ice cream pastry halvah tart dragée jelly beans chocolate toffee wafer. Pie tootsie roll wafer halvah jelly cake donut cheesecake. Caramels tiramisu candy canes tootsie roll danish apple pie topping topping. Gingerbread carrot cake chocolate cake liquorice jujubes caramels cupcake apple pie macaroon.
 
@@ -27,7 +27,7 @@ Marzipan marzipan cupcake pastry tart sesame snaps sweet roll pie. Marshmallow p
 Carrot cake cotton candy toffee jelly-o chocolate toffee cookie sweet roll. Pastry tootsie roll marzipan apple pie lollipop gingerbread sweet. Fruitcake gummies bear claw croissant. Pie cotton candy cheesecake powder bonbon candy canes lemon drops sweet.
 
 \newpage
-\section{Dritter Abschnitt}
+\section{Third ection}
 
 Tart dragée bear claw icing fruitcake. Caramels marzipan jujubes bonbon. Fruitcake danish cookie halvah cake. Cheesecake sesame snaps jelly beans. Macaroon powder pie biscuit biscuit croissant cotton candy. Chocolate bar chupa chups tart cheesecake gingerbread tart. Ice cream muffin chupa chups sugar plum dragée topping marshmallow dragée. 
 

exercises/project-structure/preamble.done.tex

@@ -1,6 +1,6 @@
 \documentclass{article}
-\usepackage[ngerman]{babel}
+\usepackage[english]{babel}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
 
-\title{Übung zur Projektstruktur}
+\title{Exercise on Project Structure}

exercises/project-structure/section1.done.tex

@@ -1,4 +1,4 @@
-\section{Erster Abschnitt}
+\section{First section}
 Jelly beans tiramisu chocolate bar chupa chups candy canes lollipop liquorice cheesecake tootsie roll. Marshmallow sugar plum cake tiramisu jelly cake bear claw. Croissant liquorice jelly lollipop carrot cake. Cheesecake danish chocolate halvah. Candy canes jujubes chupa chups jujubes candy canes tootsie roll toffee danish sesame snaps. Sugar plum gummi bears lollipop chocolate bar. Ice cream soufflé sweet lemon drops chocolate soufflé gingerbread cookie muffin.
 
 Sugar plum danish halvah jujubes pastry donut carrot cake dessert donut. Sweet gingerbread gingerbread wafer gummi bears pastry. Tootsie roll donut powder cake. Brownie halvah lollipop gummi bears. Liquorice pie caramels jelly beans. Halvah danish brownie danish toffee cotton candy lemon drops.

exercises/project-structure/section2.done.tex

@@ -1,4 +1,4 @@
-\section{Zweiter Abschnitt}
+\section{Second section}
 
 Sweet roll tart chocolate bar cotton candy jelly beans cheesecake. Ice cream pastry halvah tart dragée jelly beans chocolate toffee wafer. Pie tootsie roll wafer halvah jelly cake donut cheesecake. Caramels tiramisu candy canes tootsie roll danish apple pie topping topping. Gingerbread carrot cake chocolate cake liquorice jujubes caramels cupcake apple pie macaroon.
 

exercises/project-structure/section3.done.tex

@@ -1,4 +1,4 @@
-\section{Dritter Abschnitt}
+\section{Third section}
 
 Tart dragée bear claw icing fruitcake. Caramels marzipan jujubes bonbon. Fruitcake danish cookie halvah cake. Cheesecake sesame snaps jelly beans. Macaroon powder pie biscuit biscuit croissant cotton candy. Chocolate bar chupa chups tart cheesecake gingerbread tart. Ice cream muffin chupa chups sugar plum dragée topping marshmallow dragée. 
 

exercises/project-structure/task.tex

@@ -1,3 +1,4 @@
-Im Ordner \mintinline{text}{exercises/project-structure} findet ihr die Datei \mintinline{text}{main.tex}.
+Within the directory \file{exercises/project-structure} you can find the file 
+\file{main.tex}.
 
 \exercisematerial{exercises/project-structure/tasks}

exercises/project-structure/tasks.done.tex

@@ -1,23 +1,49 @@
 \begin{enumerate}
-  \item 
-    \textbf{Lagert die einzelnen Abschnitte in eigene Dateien \mintinline{latex}{section1.tex}, \mintinline{latex}{section2.tex} und \mintinline{latex}{section3.tex} aus und bindet sie mittels \mintinline{latex}{\include} ein.}
-    \begin{figure}[H]
-      \inputminted[linenos=true]{latex}{exercises/project-structure/main-with-preamble.done.tex}
-      \caption{\mintinline{latex}{main.tex}}
-    \end{figure}
-    \begin{figure}[H]
-      \inputminted[linenos=true,breaklines=true]{latex}{exercises/project-structure/section1.done.tex}
-      \caption{\mintinline{latex}{section1.tex} (analog für die anderen Abschnitte)}
-    \end{figure}
-  \item 
-    \textbf{Welcher Befehl wird durch \mintinline{latex}{\include} überflüssig?} \\
-    \mintinline{latex}{\include} sorgt eigenständig dafür, dass der Inhalt jeder eingebundener Datei auf einer eigenen Seite erscheint. Der Befehl \mintinline{latex}{\newpage} ist somit überflüssig.
-  \item 
-    \textbf{Kann auch die Präambel ausgelagert werden? Wenn nicht, warum? Wenn doch, wofür ist diese Vorgehensweise eventuell nützlich?} \\
-    Auch die Präambel kann ausgelagert werden. Das Vorgehen entspricht dem aus Aufgabe 1 bekannten. In realen \LaTeX-Projekten sind häufig sehr viele Pakete eingebunden, die oftmals mit zusätzlichen Befehlen in der Präambel konfiguriert werden müssen. Es ist daher gute Praxis, die Präambel auszulagern. Das hat zudem den Vorteil, dass wir eine Datei mit den am häufigsten verwendeten Paketen einfach von einem Projekt ins andere mitnehmen können, ohne unsere Präambel immer wieder neu zu schreiben.
-  \item 
-    \textbf{Ergänzt in der Präambel den Befehl \mintinline{latex}{\includeonly{section2}}. Kompiliert das Dokument und prüft, was sich geändert hat. Welche Funktion hat dieser Befehl und wofür könnte er bei einem größeren Projekt hilfreich sein? } \\
-    Der Befehl \mintinline{latex}{\includeonly{section2}} tut genau, was er sagt. Beim Kompilieren werden unter allen \mintinline{latex}{\include}-Statements nur noch diejenigen beachtet, deren Dateinamen auch in \mintinline{latex}{\includeonly{datei1,datei2,…}} vorkommen.
-    
-    Wenn in größeren Projekten die Kompilierzeit mit jeder Seite länger wird, ist \mintinline{latex}{\includeonly} sehr nützlich. Mit der richtigen Einstellung wird nur kompiliert, woran wir gerade arbeiten. Vor dem finalen Kompiliervorgang können wir dann das \mintinline{latex}{\includeonly}-Statement entfernen und erhalten unser vollständiges PDF.
+	\item 
+	 \textbf{Put the sections of the file into separate files, named 
+	 \file{section1.tex}, \file{section2.tex}, and \file{section3.tex}. Include 
+	 them using the  \code{latex}{\textbackslash include} command.}
+		
+	\begin{figure}[H]
+		\codeblock{latex}{exercises/project-structure/main-with-preamble.done.tex}
+		\caption{\file{main.tex}}
+	\end{figure}
+	\begin{figure}[H]
+		\codeblock{latex}{exercises/project-structure/section1.done.tex}
+		 \caption{\file{section1.tex} (analogous for the other 
+			sections)}
+	\end{figure}
+ 	\item \textbf{Which command becomes superfluous when you use 
+	\code{latex}{\textbackslash include}?} \\
+	\code{latex}{\textbackslash include} makes every included file appear on a 
+	new page. Hence the command \code{latex}{\textbackslash newpage} becomes 
+	superfluous.
+	
+	\item \textbf{Can the preamble also be excluded? If no, why? If yes, when 
+	can outsourcing the preamble be useful?} 
+
+	 The preamble can also be outsourced, like in task 1. In real-world 
+	 \LaTeX{} projects we often make use of numerous packages that need to be 
+	 configured by additional commands within the preamble. Therefore, it is 
+	 advisable to outsource the preamble. On top of that, this is useful 
+	 because the file with the most-commonly used packages can be moved from 
+	 one project to another without needing to rewrite the preamble every time.
+	 
+	\item 
+	\textbf{Add the command \code{latex}{\textbackslash 
+	includeonly\{section2\}} to the preamble. Compile the document again, and 
+	check what has changed. What does the command do and how can it be helpful 
+	in a larger project? }
+
+	The command \code{latex}{\textbackslash includeonly\{section2\}} does 
+	exactly what the name already says. During compilation, only the 
+	\code{latex}{\textbackslash include} statements that contain file names 
+	that appear in \code{latex}{\textbackslash includeonly\{file1,file2, …\}} 
+	are included.
+	
+	This can be useful for larger projects, when the compile time becomes 
+	longer since by using the \code{latex}{\textbackslash includeonly} only the 
+	files can be included which we are currently working in. Before the final 
+	compilation we can delete the \code{latex}{\textbackslash includeonly} 
+	command and end up with our complete \acro{PDF}.
 \end{enumerate}

exercises/project-structure/tasks.raw.tex

@@ -1,6 +1,13 @@
 \begin{enumerate}
-  \item Lagert die einzelnen Abschnitte in eigene Dateien namens \mintinline{latex}{section1.tex}, \mintinline{latex}{section2.tex} und \mintinline{latex}{section3.tex} aus und bindet sie mittels \mintinline{latex}{\include} ein.
-  \item Welcher Befehl wird durch \mintinline{latex}{\include} überflüssig?
-  \item Kann auch die Präambel ausgelagert werden? Wenn nicht, warum? Wenn doch, wofür ist diese Vorgehensweise eventuell nützlich?
-  \item Ergänzt in der Präambel den Befehl \mintinline{latex}{\includeonly{section2}}. Kompiliert das Dokument und prüft, was sich geändert hat. Welche Funktion hat dieser Befehl und wofür könnte er bei einem größeren Projekt hilfreich sein? 
+  \item \textbf{Put the sections of the file into separate files, named 
+  \texttt{section1.tex}, \texttt{section2.tex}, and \texttt{section3.tex}. 
+  Include them using the  \code{\textbackslash include} command.}
+  \item \textbf{Which command becomes superfluous when you use 
+  \code{\textbackslash include}}
+  \item \textbf{Can the preamble also be excluded? If no, why? If yes, why can 
+  outsourcing the preamble be useful?}
+  \item \textbf{Add the command \code{\textbackslash includeonly\{section2\}} to 
+  the 
+  preamble. Compile the document again, and check what has changed. What does 
+  the command do and why can it be helpful in a larger project? }
 \end{enumerate}

exercises/references/references.code.tex

@@ -0,0 +1,17 @@
+C\# is an object-oriented programming language that was developed by Microsoft in 2011. In \cref{fig:csharp} we can see the logo of the programming language.  
+
+\begin{figure}[H]
+	\caption{The logo of C\#}
+	\label{fig:csharp}
+	\centering
+	\includegraphics[width=2cm]{exercises/references/csharp.png}
+\end{figure}
+
+\cref{lst:csharphelloworld} shows a program that prints the text \enquote{Hello LaTeX friends!} to the console. Like Java, C\# makes use of classes and main methods to build executable applications. 
+
+\begin{listing}[H]
+	\caption{A simple C\# program}
+	\label{lst:csharphelloworld}
+	\inputminted[breaklines, 
+	linenos=true]{csharp}{exercises/references/HelloLateXFriends.cs}
+\end{listing}

exercises/references/references.done.tex

@@ -1,24 +1 @@
-\begin{minted}[breaklines]{latex}
-C\# ist eine objektorientierte Programmiersprache, die im Auftrag von Microsoft entwickelt wurde und die es bereits seit 2001 gibt. In \cref{fig:csharp} seht ihr das Logo der Programmiersprache. 
-	
-\begin{figure}[H]
-	\caption{Das Logo der Programmiersprache C\#}
-	\label{fig:csharp}
-	\centering
-	\includegraphics[width=2cm]{exercises/references/csharp.png}
-\end{figure}
-
-\cref{lst:csharphelloworld} zeigt ein Programm, das den Text \enquote{Hello LaTeX friends!} auf der Konsole ausgibt. Ähnlich wie bei Java werden auch in C\# Klassen und eine Main-Methode verwendet, um eine ausführbare Anwendung zu bauen. 
-	
-\begin{listing}[H]
-	\caption{Ein einfaches Programm in der Programmiersprache C\#}
-	\label{lst:csharphelloworld}
-	\inputminted[breaklines, linenos=true]{csharp}{exercises/references/HelloLateXFriends.cs}
-\end{listing}
-\end{minted}
-
-
-
-	
-
-
+\codeblock{latex}{./exercises/references/references.code.tex}

exercises/references/references.raw.tex

@@ -1,14 +1,14 @@
-C\# ist eine objektorientierte Programmiersprache, die im Auftrag von Microsoft entwickelt wurde und die es bereits seit 2001 gibt. In der Abbildung seht ihr das Logo der Programmiersprache. 
+C\# is an object-oriented programming language that was developed by Microsoft in 2011. In the figure we can see the logo of the programming language.  
 
 \begin{figure}[H]
-	\caption{Das Logo der Programmiersprache C\#}
+	\caption{The logo of C\#}
 	\centering
 	\includegraphics[width=2cm]{exercises/references/csharp.png}
 \end{figure}
 
-Das nachstehende Quelltext-Listing zeigt ein Programm, das den Text \enquote{Hello LaTeX friends!} auf der Konsole ausgibt. Ähnlich wie bei Java werden auch in C\# Klassen und eine Main-Methode verwendet, um eine ausführbare Anwendung zu bauen. 
+The following source code listing shows a program that prints the text \enquote{Hello LaTeX friends!} to the console. Like Java, C\# makes use of classes and main methods to build executable applications. 
 
-\inputminted[breaklines, linenos=true]{csharp}{exercises/references/HelloLateXFriends.cs}
+\codeblock{csharp}{exercises/references/HelloLateXFriends.cs}
 
 
 

exercises/references/task.tex

@@ -1,3 +1,10 @@
-Ersetzt im Text in der Datei \mintinline{bash}{exercises/references/references.tex} die Phrasen \enquote{in der Abbildung} und \enquote{Das nachstehende Quelltext-Listing} jeweils durch eine Referenz auf das Bild und auf das Quelltext-Listing. Nutzt dafür den Befehl \mintinline{latex}{\cref}. Achtet darauf, dass ihr zunächst Labels für die Elemente, die ihr referenzieren wollt, vergeben müsst. Hüllt das Quelltext-Listing dafür zunächst in eine Umgebung namens \mintinline{latex}{listing} und fügt noch eine Beschriftung hinzu. Achtet auch auf geeignete Präfixe vor den Labels.
+In file \file{exercises/references/references.tex}, replace \enquote{in the 
+figure} and \enquote{the following source code listing} with suited references. 
+Use the command \code{latex}{\textbackslash cref}. Do not forget to first 
+introduce 
+labels for the elements that you want to reference. To do so, first of all, 
+wrap the source code listing in a \code{latex}{listing} environment. Also 
+insert a caption for the source code listing. 
+Make sure to use suitable prefixes before the labels.
 
 \exercisematerial{exercises/references/references}

exercises/source-code-listings/listings.done.tex

@@ -0,0 +1,7 @@
+\lstinputlisting[
+  language=Java,
+  numbers=left, % line numbers
+  showstringspaces=false, % spaces in strings
+  keywordstyle=\color{blue}, % keyword color
+  basicstyle=\ttfamily\small % overall font and size
+]{exercises/source-code-listings/Source.java}

exercises/source-code-listings/minted.done.tex

@@ -0,0 +1,13 @@
+\usemintedstyle{native}
+\definecolor{ourBackgroundColor}{rgb}{0.1,0.1,0.2}
+
+\inputminted[
+  breaklines, % line breaks
+  linenos=true, % line numbers
+  bgcolor=ourBackgroundColor, % background color
+  firstline=5, % first line to be included
+  lastline=7, % last line to be included
+  gobble=4 % remove leading spaces
+]{java}{exercises/source-code-listings/Source.java}
+
+\usemintedstyle{default}

exercises/source-code-listings/source-code-listings.done.tex

@@ -1,26 +1,15 @@
-\usemintedstyle{native}
-\definecolor{ourBackgroundColor}{rgb}{0.1,0.1,0.2}
+% Show rendering with respect to the installed software
+\ifthenelse{\equal{\listingsmode}{minted}}{%
+  \subsubsection{Minted rendering}
+  \input{exercises/source-code-listings/minted.done.tex}
+}{%
+  \subsubsection{Listings rendering}
+  \input{exercises/source-code-listings/listings.done.tex}
+}
 
-\inputminted[
-  breaklines,
-  linenos=true,
-  bgcolor=ourBackgroundColor,
-  firstline=5,
-  lastline=7,
-  gobble=4
-]{java}{exercises/source-code-listings/Source.java}
+\subsubsection{Minted solution}
+\codeblock{latex}{./exercises/source-code-listings/minted.done.tex}
 
-\usemintedstyle{default}
-\begin{minted}{latex}
-\usemintedstyle{native}
-\definecolor{ourBackgroundColor}{rgb}{0.1,0.1,0.2}
+\subsubsection{Listings solution}
+\codeblock{latex}{./exercises/source-code-listings/listings.done.tex}
 
-\inputminted[
-  breaklines, % Zeilenumbrüche
-  linenos=true, % Zeilennummerierung
-  bgcolor=ourBackgroundColor, % Hintergrundfarbe
-  firstline=5, % erste Zeile
-  lastline=7, % letzte Zeile
-  gobble=4 % Leerzeichen entfernen
-]{java}{exercises/source-code-listings/Source.java}
-\end{minted}

exercises/source-code-listings/task.tex

@@ -1,19 +1,36 @@
-Im Ordner \mintinline{text}{exercises/source-code-listings} findet ihr eine Datei namens \mintinline{text}{Source.java}.
-Wir werden diese im Folgenden in unser Dokument einbinden und das Aussehen unseren Wünschen anpassen.
+In the folder \file{exercises/source-code-listings}, you will find a file called \file{Source.java}.
+We will now include it into our document and adjust its display to fit our needs.
+If you have questions, consult the \pkg{minted} or \pkg{listings} package documentation.
+
+\section*{Minted tasks}
 
 \begin{enumerate}
-  \item Bindet die Datei an dieser Stelle ein.
-  \item Aktiviert Syntax-Highlighting durch Angabe der Sprache Java.
-  \item Lasst LaTeX zu lange Zeilen automatisch umbrechen.
-  \item Die Zeilen sollen nummeriert sein.
-  \item Nutzt das Theme \mintinline{latex}|native|.
-  \item Dieses Theme ist für einen dunklen Hintergrund optimiert. Ändert die Hintergrundfarbe des Themes zu dunkelblau.
-  \item Bindet jetzt ausschließlich die Zeilen 5 bis 7 ein.
-  \item Entfernt die Leerzeichen am Anfang der Zeilen durch Angabe der richtigen Option. (Hinweis: Die Dokumentation spricht hier von \mintinline{latex}|gobble|.)
+  \item Include the file into \\
+  \file{exercises/source-code-listings/source-code-listings.tex}.
+  \item Activate syntax highlighting by stating the programming language Java.
+  \item Add line breaks and line numbers.
+  \item Use the theme \code{latex}{native}.
+  \item This theme is optimized for a dark background. Change the background color to dark blue.
+  \item Include only lines 5 to 7.
+  \item Delete the spaces at the beginning of the lines by using a suitable 
+  option. (Hint: The documentation speaks of \code{latex}{gobble}.)
 \end{enumerate}
 
-Konsultiert bei Fragen die Dokumentation des Paketes Minted.
+\section*{Listings tasks}
+
+\begin{enumerate}
+  \item Include the file into \\
+  \file{exercises/source-code-listings/source-code-listings.tex}.
+  \item Activate syntax highlighting by stating the programming language Java.
+  \item Set the \mono{basicstyle} to a proper mono-spaced font (\mono{\textbackslash ttfamily \textbackslash small})
+  \item Add line numbers.
+  \item Change the keyword color to blue.
+  \item Don't show special characters for spaces in strings.
+\end{enumerate}
 
 \exercisematerial{exercises/source-code-listings/source-code-listings}
-\usemintedstyle{} % Reset experiments from exercise material
 
+% Reset experiments from exercise material if minted is used
+\ifthenelse{\equal{\listingsmode}{minted}}{%
+  \usemintedstyle{default} 
+}{}

exercises/special-characters/special-characters.code.tex

@@ -0,0 +1,7 @@
+What is a semester ticket?
+It is also known as \enquote{Studi-Ticket} or \enquote{Studi-Karte} and allows you to use the local public transport around Bamberg for free.
+In Bamberg, your student card (Studierenden\-ausweis) is used, i.\,a., as a semester ticket.
+To be able to use it, you should validate the student card in one of the university buildings.
+This is possible after you have paid the semester fees (101,50\,\euro).
+A validation printers are located in multiple university buildings, e.\,g., in the foyer of the Erba building, in front of the library.
+This building is opened Monday\,--\,Friday, 7am\,--\,10pm. 

exercises/special-characters/special-characters.done.tex

@@ -1,4 +1 @@
-\begin{minted}[breaklines]{latex}
-Was ist eigentlich ein Semesterticket? Es ist auch als \enquote{Studi-Ticket} oder \enquote{Studi-Karte} bekannt und ermöglicht es euch, kostenlos die öffentlichen Verkehrsmittel in und um Bamberg zu nutzen. In Bamberg wird euer Studierenden\-ausweis u.\,a. als Semesterticket genutzt. Um es nutzen zu können, solltet ihr den Studierenden\-ausweis in einem der Universitätsgebäude validieren. Dies ist möglich, sobald ihr die Semestergebühr von 101,50\,\euro{} bezahlt habt. Ein Validierungsdrucker befindet sich z.\,B. im ERBA-Gebäude im Foyer vor der Bibliothek. Die Öffnungszeiten des Uni-Gebäudes an der Weberei sind Mo.\,--\,Fr., 7.00\,--\,22.00 Uhr. 
-\end{minted}
-
+\codeblock{latex}{./exercises/special-characters/special-characters.code.tex}

exercises/special-characters/special-characters.raw.tex

@@ -1 +1,7 @@
-Was ist eigentlich ein Semesterticket? Es ist auch als Studi-Ticket oder Studi-Karte bekannt und ermöglicht es euch, kostenlos die öffentlichen Verkehrsmittel in und um Bamberg zu nutzen.  In Bamberg wird euer Studierendenausweis u. a. als Semesterticket genutzt. Um es nutzen zu können, solltet ihr den Studierendenausweis in einem der Universitätsgebäude validieren. Dies ist möglich, sobald ihr die Semestergebühr von 101,50 Euro bezahlt habt. Ein Validierungsdrucker befindet sich z. B. im ERBA-Gebäude im Foyer vor der Bibliothek. Die Öffnungszeiten des Uni-Gebäudes an der Weberei sind Mo. - Fr., 7.00 - 22.00 Uhr. 
+What is a semester ticket?
+It is also known as Studi-Ticket or Studi-Karte and allows you to use the local public transport around Bamberg for free.
+In Bamberg, your student card (Studierendenausweis) is used, i. a., as a semester ticket.
+To be able to use it, you should validate the student card in one of the university buildings.
+This is possible after you have paid the semester fees (101,50 EUR).
+A validation printers are located in multiple university buildings, e. g., in the foyer of the Erba building, in front of the library.
+This building is opened Monday - Friday, 7am - 10pm. 

exercises/special-characters/task.tex

@@ -1,15 +1,16 @@
-% Don't copy this ugly texttt line break hack.
-Für diese Aufgabe arbeiten wir mit der Datei \texttt{exercises/}""\texttt{special-characters/}""\texttt{special-characters.tex}.
-Die Ergebnisse seht ihr im Skript bei Übung 5.
-Kompiliert deshalb zur Prüfung eurer Lösung die Datei \mintinline{bash}{main.tex}.
-Dies gilt auch für die folgenden Aufgaben.
+% breakanywhere doesn't seem to work.
+For this task, we are using the file \file{exercises/special-characters.tex}.
+To be able to see your results here within the script,
+compile the \file{main.tex} file.
+This applies for the subsequent tasks, as well.
 
 \begin{enumerate}
-	\item Im Text findet ihr eine Reihe an Abkürzungen. Ersetzt die Leerzeichen innerhalb der Abkürzungen durch schmale Leerzeichen. Setzt außerdem ein schmales Leerzeichen vor das Wort \emph{Euro}.
-	\item Ersetzt die Bindestriche bei den Öffnungszeiten der ERBA durch Halbgeviertstriche.
-	\item Setzt beim Wort \emph{Studierendenausweis} eine ausschließliche Trennstelle nach \enquote{Studierenden-}.
-	\item Setzt die Wörter \emph{Studi-Ticket} und \emph{Studi-Karte} in Anführungszeichen. Nutzt dafür den Befehl \mintinline{latex}{\enquote}.
-	\item Ersetzt das Wort \emph{Euro} durch ein Euro-Zeichen. 
+	\item In the text, you find a bunch of abbreviations. Replace the spaces within the abbreviations by thin spaces. Put a thin space in front of the word \emph{EUR}.
+	\item Replace the hyphens within the Erba opening hours by en dashes.
+	\item Restrict the hyphenation of word \emph{Studierendenausweis} to one position: \\\emph{Studierenden-ausweis}.
+	\item Add quotation marks around the words \emph{Studi-Ticket} and 
+	\emph{Studi-Karte} using the \code{latex}{\textbackslash enquote} command.
+	\item Replace the word \emph{EUR} by a Euro symbol (hence the thin space). 
 \end{enumerate}
 
 \exercisematerial{exercises/special-characters/special-characters}

exercises/tables/tables.code.tex

@@ -0,0 +1,13 @@
+\begin{table}[h]
+	\centering
+	\begin{tabular}{clll}
+	\toprule
+	No. & Name & Abbreviation & Term \\
+	\midrule
+	1 & Foundations of Software Engineering & SWT-FSE-B & summer \\
+	2 & Information Retrieval & MI-IR-M & summer \\
+	3 & International Outsourcing Management & ISM-IOM-M & winter \\		
+	\bottomrule
+	\end{tabular}
+	\caption{Overview over some courses}
+\end{table}

exercises/tables/tables.done.tex

@@ -1,29 +1,15 @@
-\begin{minted}[breaklines]{latex}
-\begin{table}[h]
-	\centering
-	\begin{tabular}{clll}
-	\toprule
-	Nr. & Name & Kürzel & Semester \\
-	\midrule
-	1 & Mathematik für Informatik 1 & GdI-MfI1-B & Winter \\
-	2 & Datenbanksysteme & MOBI-DBS-B & Sommer \\
-	3 & Einführung in die Medieninformatik & MI-EMI-B & Winter \\		
-	\bottomrule
-	\end{tabular}
-	\caption{Übersicht über einige Veranstaltungen}
-\end{table}
-\end{minted}
+\codeblock{latex}{./exercises/tables/tables.code.tex}
 
 \begin{table}[h]
 	\centering
 	\begin{tabular}{clll}
-		\toprule
-		Nr.	&	Name & Kürzel & Semester \\
-		\midrule
-		1	&	Mathematik für Informatik 1	       &	GdI-MfI1-B &	Winter	\\
-		2	&	Datenbanksysteme			             &	MOBI-DBS-B &	Sommer	\\
-		3	&	Einführung in die Medieninformatik &	MI-EMI-B	 &	Winter	\\		
-		\bottomrule
+	\toprule
+	No. & Name & Abbreviation & Term \\
+	\midrule
+	1 & Foundations of Software Engineering & SWT-FSE-B & summer \\
+	2 & Information Retrieval & MI-IR-M & summer \\
+	3 & International Outsourcing Management & ISM-IOM-M & winter \\			
+	\bottomrule
 	\end{tabular}
-	\caption{Übersicht über einige Veranstaltungen}
-\end{table}
+	\caption{Overview over some courses}
+\end{table}

exercises/tables/tables.raw.tex

@@ -1,11 +1,11 @@
 \begin{itemize}
-	\item Mathematik für Informatik
-	\subitem Kürzel: GdI-MfI1-B
-	\subitem Semester: Winter
-	\item Datenbanksysteme
-	\subitem Kürzel: MOBI-DBS-B
-	\subitem Semester: Sommer 
-	\item Einführung in die Medieninformatik
-	\subitem Kürzel: MI-EMI-B
-	\subitem Semester: Winter 
+	\item Foundations of Software Engineering
+	\subitem abbreviation: SWT-FSE-B
+	\subitem term: summer
+	\item Information Retrieval
+	\subitem abbreviation: MI-IR-M
+	\subitem term: summer 
+	\item International Outsourcing Management
+	\subitem abbreviation: ISM-IOM-M
+	\subitem term: winter 
 \end{itemize}

exercises/tables/task.tex

@@ -1,4 +1,9 @@
-Die folgende Liste zeigt ein paar Eckdaten über einige Lehrveranstaltungen an der Fakultät WIAI. Die Übersicht ist allerdings etwas unschön geraten. Wandelt deshalb die Liste in eine Tabelle mit den Spalten \emph{Name}, \emph{Kürzel} und \emph{Semester} um. Fügt zusätzlich eine \emph{zentrierte Spalte} ein, in denen ihr die Veranstaltungen nummeriert. Fügt außerdem eine Tabellenunterschrift hinzu. Arbeitet hierfür bitte in der Datei \mintinline{bash}{exercises/tables/tables.tex}.
+The following list shows some key data about a few courses of the \acro{WIAI} faculty.
+However, the overview is not as clear as it could be.
+To improve it, convert the list into a table with columns for \emph{name}, \emph{abbreviation} and \emph{term}.
+Insert an additional \emph{centered column} that numbers the courses. 
+Add a caption to the table.
+You find the table in \file{exercises/tables/tables.tex}.
 
 \exercisematerial{exercises/tables/tables}
 

exercises/text-markup/markup.code.tex

@@ -0,0 +1,5 @@
+``\emph{Recursion} (adjective: \emph{recursive}) occurs when a thing is defined in terms of itself or of its type.
+\emph{Recursion} is used in a variety of disciplines ranging from linguistics to logic.
+The most common application of \emph{recursion} is in mathematics and computer science, where a function being defined is applied within its own definition.''
+
+Source and more information: \url{https://en.wikipedia.org/wiki/Recursion}

exercises/text-markup/markup.done.tex

@@ -1,5 +1 @@
-\begin{minted}[breaklines]{latex}
-Die \emph{Rekursion} ist eine bekannte Problemlösestrategie in der Informatik. Dabei wird ein großes Problem zerlegt und zunächst nur ein Teil der Aufgabe gelöst. Oft wird \emph{Rekursion} innerhalb von Programmcode umgesetzt, indem eine Methode sich immer wieder selbst aufruft, bis eine bestimmte Abbruchbedingung erfüllt ist. Das heißt, dass das Programm theoretisch bis ins Unendliche weiterlaufen kann, wenn es \emph{rekursiv} ist.
-	
-Weitere Informationen findet ihr im Wikipedia-Artikel zur Rekursion unter \url{https://de.wikipedia.org/wiki/Rekursion}.
-\end{minted}
+\codeblock{latex}{./exercises/text-markup/markup.code.tex}

exercises/text-markup/markup.raw.tex

@@ -1,3 +1,7 @@
-Die Rekursion ist eine bekannte Problemlösestrategie in der Informatik. Dabei wird ein großes Problem zerlegt und zunächst nur ein Teil der Aufgabe gelöst. Oft wird Rekursion innerhalb von Programmcode umgesetzt, indem eine Methode sich immer wieder selbst aufruft, bis eine bestimmte Abbruchbedingung erfüllt ist. Das heißt, dass das Programm theoretisch bis ins Unendliche weiterlaufen kann, wenn es rekursiv ist. 
+``Recursion (adjective: recursive) occurs when a thing is defined in terms of itself or of its type.
+Recursion is used in a variety of disciplines ranging from linguistics to logic.
+The most common application of recursion is in mathematics and computer science,
+where a function being defined is applied within its own definition.''
+
+Source and more information: https://en.wikipedia.org/wiki/Recursion
 
-Weitere Informationen findet ihr im Wikipedia-Artikel zur Rekursion unter https://de.wikipedia.org/wiki/Rekursion.

exercises/text-markup/task.tex

@@ -1,7 +1,8 @@
 \begin{enumerate}
-  \item Hebt im Text in der Datei \mintinline{bash}{exercies/text-markup/markup.tex} die Wörter \glqq{}Rekursion\grqq{} und \glqq{}rekursiv\grqq{} hervor.
-  \item Macht die URL im Text anklickbar. 
-  \item Natürlich könnt ihr auch die anderen Befehle, die ihr zur Textauszeichnung gelernt habt, ausprobieren. Entfernt sie allerdings im Anschluss wieder, um das Dokument sauber zu halten.
+  \item In \file{exercies/text-markup/markup.tex}, emphasize the words 
+  ``recursion'' and ``recursive.''
+  \item Make the \textsc{url} clickable. 
+  \item Of course, you can also experiment with the other commands that you learned for text markup. However, you might want to remove them afterwards to keep your document nice and tidy.
 \end{enumerate}
 
 \exercisematerial{exercises/text-markup/markup}

listings/basic-document-structure/encoding.tex

@@ -0,0 +1,2 @@
+\usepackage[utf8]{inputenc}
+\usepackage[t1]

listings/basic-document-structure/foreign-language.tex

@@ -0,0 +1 @@
+\foreignlanguage{<language>}{<text>}

listings/basic-document-structure/headlines.tex

@@ -1,10 +1,10 @@
-\section{Ebene 1}
+\section{Level 1}
 Lorem ipsum % …
-\subsection{Ebene 2}
+\subsection{Level 2}
 Lorem ipsum % …
-\subsubsection{Ebene 3}
+\subsubsection{Level 3}
 Lorem ipsum % …
-\paragraph{Ebene 4}
+\paragraph{Level 4}
 Lorem ipsum % …
-\subparagraph{Ebene 5}
+\subparagraph{Level 5}
 Lorem ipsum % …

listings/basic-document-structure/headlines_crop.tex

@@ -5,15 +5,15 @@
 
 \begin{document}
 \thispagestyle{empty}
-\section{Ebene 1}
+\section{Level 1}
 Lorem ipsum dolor sit amet, consectetur adipisici elit.
-\subsection{Ebene 2}
+\subsection{Level 2}
 Lorem ipsum dolor sit amet, consectetur adipisici elit.
-\subsubsection{Ebene 3}
+\subsubsection{Level 3}
 Lorem ipsum dolor sit amet, consectetur adipisici elit.
-\paragraph{Ebene 4}
+\paragraph{Level 4}
 Lorem ipsum dolor sit amet, consectetur adipisici elit.
-\subparagraph{Ebene 5}
+\subparagraph{Level 5}
 Lorem ipsum dolor sit amet, consectetur adipisici elit.
 \end{document}
 

listings/basic-document-structure/hello-world.tex

@@ -4,5 +4,5 @@
 \usepackage[ngerman]{babel}
 
 \begin{document}
-Hallo, Welt!
+Hello World!
 \end{document}

listings/basic-document-structure/hello-world_crop.tex

@@ -5,5 +5,5 @@
 
 \begin{document}
 \thispagestyle{empty}
-Hallo, Welt!
+Hello World!
 \end{document}

listings/basic-document-structure/language.tex

@@ -0,0 +1 @@
+\usepackage[ngerman]{babel}

listings/basic-document-structure/packages.tex

@@ -0,0 +1 @@
+\usepackage[<options>]{<packagename>}

listings/basic-document-structure/title-in-toc.tex

@@ -0,0 +1 @@
+\section[Title in the TOC]{Actual Chapter Title}

listings/basic-document-structure/titles.tex

@@ -1,9 +1,9 @@
-\documentclass[ngerman]{article}
+\documentclass[english]{article}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
-\usepackage[ngerman]{babel}
+\usepackage[english]{babel}
 
-\title{Die Welt der Trüffel}
+\title{The World of Truffles}
 \author{Fooboar Rüssel \and Fachschaft WIAI}
 \date{\today}
 

listings/basic-document-structure/titles_crop.tex

@@ -1,9 +1,9 @@
-\documentclass[ngerman]{article}
+\documentclass[english]{article}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
-\usepackage[ngerman]{babel}
+\usepackage[english]{babel}
 
-\title{Die Welt der Trüffel}
+\title{The World of Truffles}
 \author{Fooboar Rüssel \and Fachschaft WIAI}
 \date{\today}
 

listings/basic-functionality/command-structure.txt

@@ -0,0 +1 @@
+\<command>[<optional_parameters>]{<mandatory_parameters>}