From 7a8d188b1cde76f1c38c2e147e0d433aab2187cb Mon Sep 17 00:00:00 2001 From: Florian Date: Sun, 16 Nov 2025 18:09:48 +0100 Subject: [PATCH 01/16] Change first file to compile --- slides/intro.de.md | 6 +++--- slides/intro.en.md | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/slides/intro.de.md b/slides/intro.de.md index 027c8ef..a868a1c 100644 --- a/slides/intro.de.md +++ b/slides/intro.de.md @@ -147,12 +147,12 @@ Erstmaliges Kompilieren des Skriptes @content * Ladet das Projektarchiv aus dem VC herunter. * Entpackt das Archiv. -* Öffnet die Datei main-exercises.tex in TeXstudio. Ihr findet es im Wurzelverzeichnis des Archivs. +* Öffnet die Datei `install-verification/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. - + ::: {.box .warning} -**Windows**: 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. +**Windows**: Um Dateiendungen zu aktivieren, klickt auf das Ansichts-Tab im Dateiexplorer und wählt *Dateiendungen*. So könnt ihr besser zwischen den einzelnen `main`-Dateien unterscheiden. ::: @slide(layout=extra-content-only) diff --git a/slides/intro.en.md b/slides/intro.en.md index fac9fc1..25dfaad 100644 --- a/slides/intro.en.md +++ b/slides/intro.en.md @@ -147,8 +147,8 @@ Compile the script for the first time @content * Download the project archive from the VC. * Unzip the archive. -* Open the file `main-exercises.tex` in TEXstudio. It is located in the root directory of the archive. -* Compile `main-exercises.tex` by pressing ⏩ +* Open the file `install-verification/main.tex` in TEXstudio. It is located in the root directory of the archive. +* Compile the file by pressing ⏩ * A few new files will be generated by the compilation. ::: {.box .warning} -- 2.47.2 From 8419a3f89e3736d50fd805d0b5435800967411b0 Mon Sep 17 00:00:00 2001 From: Florian Date: Sun, 16 Nov 2025 18:12:23 +0100 Subject: [PATCH 02/16] Update presenter names --- slides/titlepage.de.md | 2 +- slides/titlepage.en.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/slides/titlepage.de.md b/slides/titlepage.de.md index 360e0d3..1d98015 100644 --- a/slides/titlepage.de.md +++ b/slides/titlepage.de.md @@ -4,5 +4,5 @@ LATEX-Wochenende @subscript -Ein Workshop der Fachschaft WIAI. Präsentiert von Laetitia Hilgendorf, Jessica Klarmann, Florian Knoch, Theresa Knoll, Jochen Mehlich und Hannah Rattenberger. +Ein Workshop der Fachschaft WIAI. Präsentiert von Alice, Christian, Clara, Evelyn, Fabian, Florian, Jochen, Katharina, Kilian, Paul und Sandra. diff --git a/slides/titlepage.en.md b/slides/titlepage.en.md index 6511f83..8125c67 100644 --- a/slides/titlepage.en.md +++ b/slides/titlepage.en.md @@ -4,5 +4,5 @@ LATEX Weekend @subscript -A Fachschaft WIAI workshop. Presented by Laetitia Hilgendorf, Jessica Klarmann, Florian Knoch, Theresa Knoll, Jochen Mehlich, and Hannah Rattenberger. +A Fachschaft WIAI workshop. Presented by Alice, Christian, Clara, Evelyn, Fabian, Florian, Jochen, Katharina, Kilian, Paul, and Sandra. -- 2.47.2 From 3b9b628d94144c04c3e5431fc89d99d360040cc4 Mon Sep 17 00:00:00 2001 From: Florian Date: Sun, 16 Nov 2025 18:14:43 +0100 Subject: [PATCH 03/16] Remove outdated information and reformulate task --- slides/intro.de.md | 4 ++-- slides/intro.en.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/slides/intro.de.md b/slides/intro.de.md index a868a1c..a1e6c07 100644 --- a/slides/intro.de.md +++ b/slides/intro.de.md @@ -147,9 +147,9 @@ Erstmaliges Kompilieren des Skriptes @content * Ladet das Projektarchiv aus dem VC herunter. * Entpackt das Archiv. -* Öffnet die Datei `install-verification/main.tex` in TeXstudio. Ihr findet es im Wurzelverzeichnis des Archivs. +* Öffnet die Datei `install-verification/main.tex` in TeXstudio. * Kompiliert die Datei, indem ihr ⏩ klickt. -* Einige neue Dateien sollten nun durch das Kompilieren generiert werden. +* Schaut euch die neuen Dateien an, die durch das Kompilieren generiert werden. ::: {.box .warning} **Windows**: Um Dateiendungen zu aktivieren, klickt auf das Ansichts-Tab im Dateiexplorer und wählt *Dateiendungen*. So könnt ihr besser zwischen den einzelnen `main`-Dateien unterscheiden. diff --git a/slides/intro.en.md b/slides/intro.en.md index 25dfaad..860d923 100644 --- a/slides/intro.en.md +++ b/slides/intro.en.md @@ -147,9 +147,9 @@ Compile the script for the first time @content * Download the project archive from the VC. * Unzip the archive. -* Open the file `install-verification/main.tex` in TEXstudio. It is located in the root directory of the archive. +* Open the file `install-verification/main.tex` in TEXstudio. * Compile the file by pressing ⏩ -* A few new files will be generated by the compilation. +* Have a look at the new files that will be generated by the compilation. ::: {.box .warning} **Windows**: In order to enable file endings, click the view tab in the file explorer, and select *file name extensions*. This helps differentiating the different ``main`` files. -- 2.47.2 From 774d9cdccd511ae688c28f955743557cf13bf03b Mon Sep 17 00:00:00 2001 From: Florian Date: Sun, 16 Nov 2025 18:17:35 +0100 Subject: [PATCH 04/16] Update Git links --- slides/intro.de.md | 4 ++-- slides/intro.en.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/slides/intro.de.md b/slides/intro.de.md index a1e6c07..90d4e3e 100644 --- a/slides/intro.de.md +++ b/slides/intro.de.md @@ -4,7 +4,7 @@ Ablauf des Workshops @content -**Ziel:** Wir arbeiten zusammen unser [LaTeX-Skript](https://github.com/fs-wiai/latex-script/) durch, das ihr nach dem Workshop als kompakte Referenz verwenden könnt. +**Ziel:** Wir arbeiten zusammen unser [LaTeX-Skript](https://git.stuve-bamberg.de/latex/latex-skript/) durch, das ihr nach dem Workshop als kompakte Referenz verwenden könnt. * Learning by Doing * Verstehen, wie LaTeX funktioniert @@ -133,7 +133,7 @@ erstellt aus dem Quelltext ein fertig formatiertes PDF-Dokument ### Editor zum Schreiben unseres Quelltextes mit allen Befehlen zur semantischen Gliederung -[TeXstudio](http://www.texstudio.org/) (Empfehlung), [VS Codium](https://vscodium.com) (für Fortgeschrittene, Anleitung auf [Github](https://github.com/fs-wiai/latex-script/blob/github/vs-code-instructions.md)) +[TeXstudio](http://www.texstudio.org/) (Empfehlung), [VS Codium](https://vscodium.com) (für Fortgeschrittene, Anleitung auf [Github](https://git.stuve-bamberg.de/latex/latex-skript/src/branch/master/docs/vs-code-instructions.md)) ::: @slide(layout=task) diff --git a/slides/intro.en.md b/slides/intro.en.md index 860d923..a786148 100644 --- a/slides/intro.en.md +++ b/slides/intro.en.md @@ -4,7 +4,7 @@ Procedure of this workshop @content -**Goal:** You are going to build your own little
LaTeX manual based on our [LaTeX Script](https://github.com/fs-wiai/latex-script/). +**Goal:** You are going to build your own little
LaTeX manual based on our [LaTeX Script](https://git.stuve-bamberg.de/latex/latex-skript/). * learning by doing * understanding how LaTeX works @@ -133,7 +133,7 @@ On **Windows**, please open the MikT👣 -@slide(layout=content-only-with-category) - -@category -Demo - -@title -Kompilieren des Projekts - -@content -* **Nur die Hauptdatei** wird kompiliert, um das fertige PDF-Dokument zu erhalten. -* ++ Fehlermeldungen enthalten dann Verweis, in welcher Unterdatei sie aufgetreten sind. -* ++ Die Unterdateien können wegen ihrer fehlenden Präambel nicht selbstständig kompiliert werden. - - -@slide(layout=task) - -@task-number -3 - -@title -Ein strukturiertes Projekt - -@content -Im Ordner `exercises/project-structure` findet ihr eine Datei namens `main.tex`. - -* Erstellt neue Dateien (z. B. `section1.tex` und `section2.tex` und verschiebt die Abschnitte in diese. -* Importiert die Fragmente anschließend mit Hilfe des `\input`-Befehls. -* Lagert die Präambel auf demselben Weg in eine eigene Datei aus. -* Schaut euch abschließend die Gesamtstruktur unseres Projektarchivs an, beginnend mit `main-exercises.tex` im Wurzelverzeichnis. Wie binden wir hier die einzelnen Abschnitte ein? - - -@slide(layout=extra-content-only) - -@title -PDF-Dokumente einbetten - -@content -Das Paket `pdfpages` erlaubt das Einbetten ganzer PDF-Dokumente. - -``` {.lang-tex .hljs} -\includepdf[pages={-}]{} -``` - -Weitere Parameter lassen mehrere Seiten in Kacheln nebeneinander erscheinen oder ändern die Ausrichtung zu Querformat. Die [Paket-Dokumentation](https://www.ctan.org/pkg/pdfpages) enthält eine abschließende Liste aller Möglichkeiten. - - -@slide(layout=extra-wide-content) - -@title -Makros - -@content -Manchmal ist es nützlich, oft genutzten Codes durch Makros zu vereinfachen. - -``` {.lang-tex .hljs} -\newcommand{\}[][]{} -``` - -Im Skript haben wir solche Makros unter anderem verwendet, um Abstände und Akronyme zu definieren (siehe `commands.tex` für weitere Beispiele): - -``` {.lang-tex .hljs} -\newcommand{\widefiguremargin}{-.22\textwidth} -\newcommand{\acro}[1]{\textsc{\lowercase{#1}}} -``` - -Es ist auch möglich, bestehende Befehle anzupassen. $\LaTeX$ erlaubt es sogar, Programmierkonstrukte wie Variablen, Verzweigungen und Schleifen zu nutzen. Für weitere Einblicke dient [dieses Kapitel des WikiBooks](https://en.wikibooks.org/wiki/LaTeX/Macros). - @slide(layout=content-only) @title diff --git a/slides/project-structure.en.md b/slides/project-structure.en.md index 578881a..495e797 100644 --- a/slides/project-structure.en.md +++ b/slides/project-structure.en.md @@ -78,6 +78,74 @@ of section 2. ![](svg/project-structure/main-parts-crop.svg){.thin-padding} +@slide(layout=content-only) + +@title +Compiling the project + +@content +* **Only the main file** has to be compiled to get the complete PDF document. +* ++ Error messages include a reference to the corresponding subfile. +* ++ Subfiles cannot be compiled on their own as they don’t have a preamble. + + +@slide(layout=task) + +@task-number +3 + +@title +A structured project + +@content +::: {.box .warning} +**Close all open tabs** from previous tasks. +::: + +You will find a file named `main.tex` in the folder `exercises/project-structure`. + +* Put the sections of the file into separate files, named `section1.tex` and `section2.tex`. +* Include them using the `\input` command. +* Move the preamble to its own file in a similar fashion. +* Finally, have a look at the general project archive, starting from `main-exercises.tex` (in the root folder of the project archive). How do we include the different sections here? + + +@slide(layout=extra-content-only) + +@title +Embedding PDF documents + +@content +The `pdfpages` package allows for embedding entire PDF documents. + +``` {.lang-tex .hljs} +\includepdf[pages={-}]{} +``` + +Further options make multiple pages appear in tiles and change the orientation to landscape, among other things. See the [package documentation](https://www.ctan.org/pkg/pdfpages) for a complete list. + + +@slide(layout=extra-wide-content) + +@title +Macros + +@content +It may be helpful to specify custom macros for often-used code. + +``` {.lang-tex .hljs} +\newcommand{\}[][]{} +``` + +In the script, we used these macros for margins and acronyms (see `commands.tex` for more examples): + +``` {.lang-tex .hljs} +\newcommand{\widefiguremargin}{-.22\textwidth} +\newcommand{\acro}[1]{\textsc{\lowercase{#1}}} +``` + +It is also possible to customize existing commands. $\LaTeX$ even allows you to use programming patterns like variables, conditionals, and loops. To learn more, have a look at [this WikiBook chapter](https://en.wikibooks.org/wiki/LaTeX/Macros). + @slide(layout=content-and-preview-with-category) @category @@ -159,75 +227,6 @@ Specifying file paths 👣 ![](svg/project-structure/relative-path-transitive-english-crop.svg) - -@slide(layout=content-only-with-category) - -@category -Demo - -@title -Compiling the project - -@content -* **Only the main file** has to be compiled to get the complete PDF document. -* ++ Error messages include a reference to the corresponding subfile. -* ++ Subfiles cannot be compiled on their own as they don’t have a preamble. - - -@slide(layout=task) - -@task-number -3 - -@title -A structured project - -@content -You will find a file named `main.tex` in the folder `exercises/project-structure`. - -* Put the sections of the file into separate files, named `section1.tex` and `section2.tex`. -* Include them using the `\input` command. -* Move the preamble to its own file in a similar fashion. -* Finally, have a look at the general project archive, starting from `main-exercises.tex` (in the root folder of the project archive). How do we include the different sections here? - - -@slide(layout=extra-content-only) - -@title -Embedding PDF documents - -@content -The `pdfpages` package allows for embedding entire PDF documents. - -``` {.lang-tex .hljs} -\includepdf[pages={-}]{} -``` - -Further options make multiple pages appear in tiles and change the orientation to landscape, among other things. See the [package documentation](https://www.ctan.org/pkg/pdfpages) for a complete list. - - -@slide(layout=extra-wide-content) - -@title -Macros - -@content -It may be helpful to specify custom macros for often-used code. - -``` {.lang-tex .hljs} -\newcommand{\}[][]{} -``` - -In the script, we used these macros for margins and acronyms (see `commands.tex` for more examples): - -``` {.lang-tex .hljs} -\newcommand{\widefiguremargin}{-.22\textwidth} -\newcommand{\acro}[1]{\textsc{\lowercase{#1}}} -``` - -It is also possible to customize existing commands. $\LaTeX$ even allows you to use programming patterns like variables, conditionals, and loops. To learn more, have a look at [this WikiBook chapter](https://en.wikibooks.org/wiki/LaTeX/Macros). - - @slide(layout=content-only) @title -- 2.47.2 From b4ab0f38d4979d27645b2ed703c900d54bcf4bc5 Mon Sep 17 00:00:00 2001 From: Florian Date: Mon, 17 Nov 2025 16:10:54 +0100 Subject: [PATCH 06/16] Move table captions above tables --- slides/tables.de.md | 10 +++++----- slides/tables.en.md | 6 +++--- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/slides/tables.de.md b/slides/tables.de.md index 9d4c126..35fa90e 100644 --- a/slides/tables.de.md +++ b/slides/tables.de.md @@ -21,10 +21,10 @@ Für typografisch schöne Tabellen nutzen wir das Paket `booktabs`. ``` {.hljs .lang-tex} \begin{table}[] + \caption{} \begin{tabular}{} % Tabelleninhalt \end{tabular} - \caption{} \end{table} ``` @@ -160,9 +160,9 @@ Tabellen, die über eine Seite hinaus gehen, werden von `tabular` einfach abgesc ``` {.hljs .lang-tex} \begin{longtable}{} - % Tabelleninhalt - \caption{} + \caption{} \label{