@slide(layout=chapter-slide)

@number
0

@title
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
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
Exkurs: Eine Kommandozeile öffnen

@content
* 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``

@slide(layout=content-only)

@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>