add german intro text

slides/intro.de.md

@@ -1,21 +1,135 @@
 @slide(layout=chapter-slide)
 
 @title
-0 Technik-Vorbereitung
+0 Erste Schritte mit&nbsp;L<sup style="font-weight: bold; font-size: 73%; margin-left: -.25em; margin-right: -.05em; position: relative; top: .2em">A</sup>T<sub style="font-size: 100%; margin-left: -.1em">E</sub>X
 
 @content
-TEST TEST
+Um das Skript für das Tutorium kompilieren zu können, müssen zunächst ein paar Konfigurationgen gemacht werden, die in den nächsten Folien erklärt werden.
 
 @slide(layout=content-only)
 
 @title
-Installing the compiler
+Exkurs: eine Kommandozeile öffnen
 
 @content
-Before starting out with LaTeX, a compiler has to be installed.
+* Für die kommenden Aufgaben brauchen wir eine Kommandozeile
+* Je nach Betriebssystem, das verwendet wird, gibt es unteschiedliche Wege, sie zu öffnen
+* **Windows**: Drückt die Windows-Taste, tippt *cmd* und drückt Enter
+* **MacOS**: Drückt die *Command*-Taste und die Leertaste gleichzeitig, tippt danach *Terminal* und macht einen Doppelklick auf *Terminal*
+* **Linux**: Drückt ``Strg + Alt + T``
 
-The following list gives you exemplary compilers for different operating systems:
+@slide(layout=content-only)
 
-* Windows
-* MacOS
-* Ubuntu
+@title
+Den Compiler installieren
+
+@content
+* Der Compiler übersetzt unseren LaTeX-Code in ein PDF
+* Je nach Betriebssystem stehen unterschiedliche Compiler zur Verfügung: 
+* Windows:  <a href="https://miktex.org/download">MikT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X</a>
+* Linux-Distributionen: <a href="https://tug.org/texlive/doc/texlive-en/texlive-en.html#installation">T<sub style="font-size: 100%; margin-left: -.1em">E</sub>XLive</a>
+  * Debian-basierte Distros: Führt  `sudo apt install texlive-full` aus
+  * Andere Distributionen:  Folgt den anweisungen auf der  T<sub style="font-size: 100%; margin-left: -.1em">E</sub>XLive-Website
+
+<div class="box warning">
+Bitte achtet darauf, die full version mit allen Paketen zu installieren, wenn ihr die Auswahl habt!
+</div>
+
+@slide(layout=content-only)
+
+@title
+Installieren des Editors
+
+@content
+* Ein Editor kann heruntergeladen werden, sobald die Installation des Compilers fertig ist
+* Es funktioniert jeglicher Text-Editor, wie etwa <a href="https://notepad-plus-plus.org/downloads/">Notepad++</a> oder <a href="https://code.visualstudio.com/download">VSCode</a>
+* Für Anfänger:innen empfehlen wir jedoch <a href="https://www.texstudio.org/">T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio</a>, da es LaTeX-spezifische Features bietet
+* Ladet T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio herunter und installiert es
+
+
+
+@slide(layout=content-only)
+@title
+Kompilieren des Skriptes
+
+@content
+* Ladet das Projektarchiv aus dem VC herunter
+* Entpackt das Archiv
+* Öffnet die Datei main.tex in TeXstudio. Ihr findet es im Wurzelverzeichnis des Archivs
+* Kompiliert die Datei, indem ihr  <span class="emoji">⏩</span> klickt
+* Einige neue Dateien sollten nun durch das Kompilieren generiert werden
+
+<div class="box warning">
+Windows-Nutzer:innen: Um Dateiendungen zu aktivieren, klickt auf das Ansichts-Tab im Dateiexplorer und wählt *Dateiendungen*. So könnt ihr besser zwischen den einzelnen main-Files unterscheiden.
+</div>
+
+@slide(layout=content-and-preview)
+@title 
+Listings
+
+@content 
+Im Skript gibt es eine Vielzahl von LaTeX-Quellcode. Die default-Einstellung ist, dass diese mit Hife eines Paketes namens **listings** angezeigt werden.
+
+* Ein anderes Paket, **minted**, generiert jedoch ansehnlichere Quellcode-Listings
+* Um minted zu nutzen, benötigt man zusätzlichen Konfiugrationsaufwand, wie die Installation der Programmiersprache **Python&nbsp;3** und des Paketes **Pygments**
+* Die nachstehenden Folien erklären, wie man `minted` für dieses LaTex-Projekt verwenden kann
+
+@preview
+![](svg/chapter-10/minted-overview-english-crop.svg){ .thin-padding}
+
+@slide(layout=content-only)
+@title
+Installation von Python 3
+
+@content
+* Überprüft, ob Python bei euch schon installiert ist, indem ihr eine Kommandozeile öffnet und folgenden Befehl eingebt:
+``` {.lang-sh .hljs}
+python --version
+```
+* Falls Python installiert ist, sollte der Output in etwa so aussehen:
+``` {.lang-sh .hljs}
+Python 3.8.5
+```
+* Falls ihr Python noch nicht installiert habt, folgt der Anleitung auf der **[Python-Webseite](https://www.python.org/)**, die für euer Betriebssystem passt
+* Um zu verifizieren, dass die Installation erfolgreich wart, führt den oben genannten Befehl erneut aus
+
+@slide(layout=content-only)
+@title
+`Pygments` und der  Compiler-Befehl
+
+@content
+* Installiert **Pygments** mit folgendem Befehl:
+<code>pip install Pygments</code>
+
+* Öffnet TeXstudio und navigiert zu Optionen → TeXstudio konfigurieren → Befehle
+* Fügt beim PdfLaTeX-Befehl das sogenannte ``shell-escape`` Flag hinzu. Der Befehl sollte dann folgendermaßen aussehen:
+<code>pdflatex -synctex=1 -interaction=nonstopmode **\-\-shell-escape** %.tex</code>
+
+
+<div class="box warning">
+Das ``shell-escape`` Flag stellt ein potentielles Sicherheitsrisiko dar. **Nutzt es nur bei vertrauenswürdigen Dokumenten!**
+</div>
+
+@slide(layout=content-and-preview)
+@title
+Den Listings-Mode ändern
+
+@content
+Um das Skript mit `minted` zu kompilieren, muss noch der Listings-Mode geändert werden.
+
+* Erstellt eine neue Datei im Wurzelverzeichnis des Projektarchives und nennt sie `listings-mode.tex`
+* Fügt den folgenden Befehl in diese Datei ein:
+
+``` {.lang-tex .tex .hljs}
+\newcommand\listingsmode{minted}
+```
+
+* Kompiliert die `main.tex`-Datei erneut, indem ihr <span class="emoji">⏩</span> drückt.
+
+
+@preview
+<figure>
+![](images/code-listing-default.png)
+![](images/code-listing-minted.png)
+</figure>
+<figcaption>``listings`` (top) vs. ``minted`` (bottom)</figcaption>