latex-wochenende/slides/intro.de.md

@slide(layout=chapter-slide)

@number 0

@title Erste Schritte mit L^AT_EX

@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: MikT_EX
• Linux-Distributionen: T_EXLive
  • Debian-basierte Distros: Führt sudo apt install texlive-full aus
  • Andere Distributionen: Folgt den anweisungen auf der T_EXLive-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 T_EXstudio, da es LaTeX-spezifische Features bietet
• Ladet T_EXstudio 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 { .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:

python --version

• Falls Python installiert ist, sollte der Output in etwa so aussehen (Version kann abweichen):

Python 3.10.6

• Folgt andernfalls der Anleitung auf der Python-Webseite, die für euer Betriebssystem passt.
• Führt den oben genannten Befehl danach erneut aus, um zu prüfen, ob alles geklappt hat.

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

\newcommand\listingsmode{minted}

• Kompiliert die main.tex-Datei erneut, indem ihr ⏩ drückt.

@preview

 

``listings`` (top) vs. ``minted`` (bottom)