135 lines
5.4 KiB
Markdown
135 lines
5.4 KiB
Markdown
@slide(layout=chapter-slide)
|
|
|
|
@title
|
|
0 Erste Schritte mit 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 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:
|
|
``` {.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>
|
|
|
|
|
|
</figure>
|
|
<figcaption>``listings`` (top) vs. ``minted`` (bottom)</figcaption> |