From e74f0619c19ae436319836bb34370ce79ea1a4ff Mon Sep 17 00:00:00 2001 From: "evelyn.fradtschuk" Date: Mon, 3 Oct 2022 22:40:12 +0200 Subject: [PATCH] make changes to german slides --- slides/chapter-02.de.md | 57 ++------------------------------- slides/chapter-02.en.md | 2 +- slides/chapter-03.de.md | 43 ++++++++++++------------- slides/intro.de.md | 71 ----------------------------------------- 4 files changed, 24 insertions(+), 149 deletions(-) diff --git a/slides/chapter-02.de.md b/slides/chapter-02.de.md index 16c6d01..688fe4e 100644 --- a/slides/chapter-02.de.md +++ b/slides/chapter-02.de.md @@ -72,9 +72,9 @@ Allgemeiner Aufbau eine Befehls: ``` {.lang-tex .tex .hljs .fragment} \newpage % fügt eine neue Seite ein -\textbf{} % schreibt den übergebenen Text fett -\usepackage[utf8]{inputenc} % setzt die Textkodierung -\frac{}{} % 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: AltGr + ß (Windows/Linux) Alt + Shift + 7 (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): -* MacTeX (MacOS): -* TeX Live (Linux/alle BS): -* TeXstudio: - - -@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 ⏩. -* Was ist in dem Ordner passiert, in dem die Datei liegt? - diff --git a/slides/chapter-02.en.md b/slides/chapter-02.en.md index 56d26c5..cdc0466 100644 --- a/slides/chapter-02.en.md +++ b/slides/chapter-02.en.md @@ -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 ``` diff --git a/slides/chapter-03.de.md b/slides/chapter-03.de.md index adf4f4c..c217e7c 100644 --- a/slides/chapter-03.de.md +++ b/slides/chapter-03.de.md @@ -46,31 +46,9 @@ Dokumentenklasse Konkret zum Beispiel ``` {.lang-tex .hljs} -\documentclass[10pt,a5paper,landscape]{scrartcl} +\documentclass[10pt,a5paper,landscape]{article} ``` -
    -
  • **`scrartcl`, `article`** für kurze Dokumente
    • -
  • **`scrreprt`, `report`** für längere Dokumente
    • -
  • **`scrbook`, `book`** für Bücher
    • -
  • **`beamer`** für Präsentationen
    • -
- - -@slide(layout=content-only) - -@title -Pakete - -@content -``` {.lang-tex .hljs} -\usepackage[]{} -``` - -* Pakete stellen zusätzliche Befehle und Funktionalitäten zur Verfügung. -* Es existieren verschiedene Pakete für verschiedene Anwendungsfälle (z. 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 diff --git a/slides/intro.de.md b/slides/intro.de.md index 9d529e4..e678ada 100644 --- a/slides/intro.de.md +++ b/slides/intro.de.md @@ -65,74 +65,3 @@ Kompilieren des Skriptes
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 (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: -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