diff --git a/slides/intro.de.md b/slides/intro.de.md index b17e95c..73fe0ac 100644 --- a/slides/intro.de.md +++ b/slides/intro.de.md @@ -1,21 +1,135 @@ @slide(layout=chapter-slide) @title -0 Technik-Vorbereitung +0 Erste Schritte mit LATEX @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: MikTEX +* Linux-Distributionen: TEXLive + * Debian-basierte Distros: Führt `sudo apt install texlive-full` aus + * Andere Distributionen: Folgt den anweisungen auf der TEXLive-Website + +
+Bitte achtet darauf, die full version mit allen Paketen zu installieren, wenn ihr die Auswahl habt! +
+ +@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 Notepad++ oder VSCode +* Für Anfänger:innen empfehlen wir jedoch TEXstudio, da es LaTeX-spezifische Features bietet +* Ladet TEXstudio 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 ⏩ klickt +* Einige neue Dateien sollten nun durch das Kompilieren generiert werden + +
+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. +
+ +@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 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: +pip install Pygments + +* Ö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: +pdflatex -synctex=1 -interaction=nonstopmode **\-\-shell-escape** %.tex + + +
+Das ``shell-escape`` Flag stellt ein potentielles Sicherheitsrisiko dar. **Nutzt es nur bei vertrauenswürdigen Dokumenten!** +
+ +@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 ⏩ drückt. + + +@preview +
+![](images/code-listing-default.png) +![](images/code-listing-minted.png) +
+
``listings`` (top) vs. ``minted`` (bottom)
\ No newline at end of file