make changes to german slides

This commit is contained in:
Fradtschuk 2022-10-03 22:40:12 +02:00
parent 5ead271cdc
commit e74f0619c1
4 changed files with 24 additions and 149 deletions

View File

@ -72,9 +72,9 @@ Allgemeiner Aufbau eine Befehls:
``` {.lang-tex .tex .hljs .fragment}
\newpage % fügt eine neue Seite ein
\textbf{<text>} % schreibt den übergebenen Text fett
\usepackage[utf8]{inputenc} % setzt die Textkodierung
\frac{<zähler>}{<nenner>} % fügt den mathematischen Bruch ein
\textbf{fetter Text} % schreibt den übergebenen Text fett
\documentclass[10pt,a5paper,landscape]{article} % setzt konfiguriert die Dokumentenklasse
\frac{1}{4} % fügt den mathematischen Bruch ein
```
@ -89,54 +89,3 @@ Den Backslash erzeugt ihr mit folgender Tastenkombination:
<kbd>AltGr</kbd>&nbsp;+&nbsp;<kbd>ß</kbd>&nbsp;(Windows/Linux)
<kbd>Alt</kbd>&nbsp;+&nbsp;<kbd>Shift</kbd>&nbsp;+&nbsp;<kbd>7</kbd>&nbsp;(MacOS)
@slide(layout=wide-content)
@title
Optionale Parameter
@content
In eckigen Klammern können verschieden viele optionale Parameter stehen:
``` {.lang-tex .hljs}
\usepackage[utf8]{inputenc}
% setzt die Textkodierung
\documentclass[a4paper,12pt]{article}
% setzt die Dokumentklasse
\includegraphics[width=12cm,height=4cm]{bild.png}
% bindet das Bild "bild.png" ein
```
@slide(layout=content-only)
@title
Software-Installation
@content
Bitte installiert **zuerst den Compiler**, also MikTeX (Windows), MacTeX (MacOS) bzw. TeX Live (Linux) und **danach den Editor.** In diesem Workshop verwenden wir TeXstudio.
* MikTeX (Windows): <https://miktex.org/>
* MacTeX (MacOS): <http://tug.org/mactex/>
* TeX Live (Linux/alle BS): <https://tug.org/texlive/>
* TeXstudio: <https://www.texstudio.org/>
@slide(layout=task)
@task-number
2
@title
Erste Schritte im Umgang mit LaTeX
@content
* Falls nötig: Install now!
* Ladet euch aus dem VC das Projektarchiv herunter. Entpackt das Archiv.
* Öffnet die Datei `main.tex` im obersten Verzeichnis in TeXstudio.
* Kompiliert die Datei durch Druck auf <span class="emoji"></span>.
* Was ist in dem Ordner passiert, in dem die Datei liegt?

View File

@ -73,7 +73,7 @@ General structure of a command:
``` {.lang-tex .tex .hljs .fragment}
\newpage % inserts a new page
\textbf{bold text} % formats the text bold
\documentclass[a4paper,12pt]{article} % configures the document class
\documentclass[a4paper,12pt, landscape]{article} % configures the document class
\frac{1}{4} % inserts a mathematical fraction
```

View File

@ -46,31 +46,9 @@ Dokumentenklasse
Konkret zum Beispiel
``` {.lang-tex .hljs}
\documentclass[10pt,a5paper,landscape]{scrartcl}
\documentclass[10pt,a5paper,landscape]{article}
```
<ul class="fragment">
<li>**`scrartcl`, `article`** für kurze Dokumente</li>
<li>**`scrreprt`, `report`** für längere Dokumente</li>
<li>**`scrbook`, `book`** für Bücher</li>
<li>**`beamer`** für Präsentationen</li>
</ul>
@slide(layout=content-only)
@title
Pakete
@content
``` {.lang-tex .hljs}
\usepackage[<optionen>]{<paketname>}
```
* Pakete stellen zusätzliche Befehle und Funktionalitäten zur Verfügung.
* Es existieren verschiedene Pakete für verschiedene Anwendungsfälle (z.&thinsp;B. Formelsatz, Listen, ...).
* Sie müssen vor der Nutzung **in der Präambel** eingebunden werden.
@slide(layout=content-only)
@ -326,6 +304,25 @@ Dokument und Text gliedern
* Fügt anschließend ein **Inhaltsverzeichnis** in euer Dokument ein.
@slide(layout=extra-wide-content)
@title
Dokumentenklassen
@content
* Natürlich gibt es auch andere Dokumentenklassen als `article`.
* Je nachdem, welche Dokumentenklasse man verwendet, ändert sich das Layout der generierten PDF.
* Die korrekt geschriebenen Dokumentenklassen richten sich nach US-amerikanischen Layout-Normen.
* **`src`**-Dokumentenklassen versuchen europäische Normen abzubilden.
Folgende Dokumentenklassen stehen zur Verfügung:
* **`scrartcl`, `article`** für kurze Dokumente
* **`scrreprt`, `report`** für lange Dokumente
* **`scrbook`, `book`** für Bücher
* **`beamer`** für Präsentationen
@slide(layout=extra-wide-content)
@title

View File

@ -65,74 +65,3 @@ Kompilieren des Skriptes
<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 (Version kann abweichen):
``` {.lang-sh .hljs}
Python 3.10.6
```
* Folgt andernfalls der Anleitung auf der **[Python-Webseite](https://www.python.org/)**, 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:
<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>