Merge pull request 'Update slides for SoSe 2024' (#13) from master into production

Reviewed-on: #13
2024-04-18 11:22:24 +00:00 · 2024-04-18 11:22:24 +00:00 · 22e42dd042
commit 22e42dd042
parent 524da01f95 200c97e855
7 changed files with 102 additions and 47 deletions
--- a/layouts/root.html
+++ b/layouts/root.html
@ -7,7 +7,7 @@
 		<title>@title</title>

 		<link rel="stylesheet" href="css/latex.css"/>
-		<link rel="stylesheet" href="lib/highlightjs/zenburn.css"/>
+		<link rel="stylesheet" href="lib/highlightjs/dark.css"/>
 	</head>
 	<body>
 		@slides
--- a/lib/highlightjs/dark.css
+++ b/lib/highlightjs/dark.css
@ -0,0 +1,62 @@
+pre code.hljs {
+  display: block;
+  overflow-x: auto;
+  padding: 1em
+}
+code.hljs {
+  padding: 3px 5px
+}
+/*
+
+Dark style from softwaremaniacs.org (c) Ivan Sagalaev <Maniac@SoftwareManiacs.Org>
+
+*/
+.hljs {
+  color: #ddd;
+  background: #303030
+}
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-literal,
+.hljs-section,
+.hljs-link {
+  color: white
+}
+.hljs-subst {
+  /* default */
+  
+}
+.hljs-string,
+.hljs-title,
+.hljs-name,
+.hljs-type,
+.hljs-attribute,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-built_in,
+.hljs-addition,
+.hljs-variable,
+.hljs-template-tag,
+.hljs-template-variable {
+  color: #d88
+}
+.hljs-comment,
+.hljs-quote,
+.hljs-deletion,
+.hljs-meta {
+  color: #979797
+}
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-literal,
+.hljs-title,
+.hljs-section,
+.hljs-doctag,
+.hljs-type,
+.hljs-name,
+.hljs-strong {
+  font-weight: bold
+}
+.hljs-emphasis {
+  font-style: italic
+}
--- a/lib/highlightjs/zenburn.css
+++ b/lib/highlightjs/zenburn.css
@ -1,7 +0,0 @@
-/*!
-  Theme: Zenburn
-  Author: elnawe
-  License: ~ MIT (or more permissive) [via base16-schemes-source]
-  Maintainer: @highlightjs/core-team
-  Version: 2021.09.0
-*/pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}.hljs{color:#dcdccc;background:#383838}.hljs ::selection,.hljs::selection{background-color:#606060;color:#dcdccc}.hljs-comment{color:#a87ab9}.hljs-tag{color:grey}.hljs-operator,.hljs-punctuation,.hljs-subst{color:#dcdccc}.hljs-operator{opacity:.7}.hljs-bullet,.hljs-deletion,.hljs-name,.hljs-selector-tag,.hljs-template-variable,.hljs-variable{color:#dca3a3}.hljs-attr,.hljs-link,.hljs-literal,.hljs-number,.hljs-symbol,.hljs-variable.constant_{color:#dfaf8f}.hljs-class .hljs-title,.hljs-title,.hljs-title.class_{color:#e0cf9f}.hljs-strong{font-weight:700;color:#e0cf9f}.hljs-addition,.hljs-code,.hljs-string,.hljs-title.class_.inherited__{color:#5f7f5f}.hljs-built_in,.hljs-doctag,.hljs-keyword.hljs-atrule,.hljs-quote,.hljs-regexp{color:#93e0e3}.hljs-attribute,.hljs-function .hljs-title,.hljs-section,.hljs-title.function_,.ruby .hljs-property{color:#7cb8bb}.diff .hljs-meta,.hljs-keyword,.hljs-template-tag,.hljs-type{color:#dc8cc3}.hljs-emphasis{color:#dc8cc3;font-style:italic}.hljs-meta,.hljs-meta .hljs-keyword,.hljs-meta .hljs-string{color:#000}.hljs-meta .hljs-keyword,.hljs-meta-keyword{font-weight:700}
--- a/slides/intro.de.md
+++ b/slides/intro.de.md
@ -15,11 +15,12 @@ Um das Skript für das Tutorium kompilieren zu können, müssen zunächst ein pa
 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``
+* 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 <kbd>Strg</kbd> + <kbd>Alt</kbd> + <kbd>T</kbd>

@slide(layout=content-only)

@ -27,15 +28,15 @@ Exkurs: Eine Kommandozeile öffnen
 Den Compiler installieren

@content
-* Der Compiler übersetzt unseren LaTeX-Code in ein PDF
+* Der Compiler übersetzt unseren LaTeX-Code in ein ansprechend formatiertes PDF-Dokument.
 * 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
+
+  * Windows:  <a href="https://miktex.org/download">MikT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X</a>
+  * Linux: <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> (bestenfalls `texlive-full`)
+  * macOS: <a href="http://tug.org/mactex/">MacT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X</a>

 <div class="box warning">
-Bitte achtet darauf, die full version mit allen Paketen zu installieren, wenn ihr die Auswahl habt!
+Unter Windows sollte nach der Installation in der MikT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X-Console einmal nach Updates gesucht werden, um spätere Probleme zu vermeiden.
 </div>

@slide(layout=content-only)
@ -44,10 +45,10 @@ Bitte achtet darauf, die full version mit allen Paketen zu installieren, wenn ih
 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
+* 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">Visual Studio Code</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.



@ -56,11 +57,11 @@ Installieren des Editors
 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
-* Kompiliert die Datei, indem ihr  <span class="emoji">⏩</span> klickt
-* Einige neue Dateien sollten nun durch das Kompilieren generiert werden
+* 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.
+* 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.
--- a/slides/intro.en.md
+++ b/slides/intro.en.md
@ -15,12 +15,12 @@ In order to compile the script for this tutorial, a few steps have to be followe
 Digression: Opening&nbsp;a&nbsp;command&nbsp;prompt

@content
-* For the following tasks, we are going to need a command prompt
-* It can be opened in different ways, depending on your operating system
+* For the following tasks, we are going to need a command prompt.
+* It can be opened in different ways, depending on your operating system.

- * **Windows**: Press the Windows key and type in *cmd*, press Enter 
-  * **MacOS**: Press the *Command* key and the *space bar* simultaneously, then type in *Terminal* and double click on *Terminal*
-  * **Linux**: Press ``Ctrl + Alt + T`` 
+ * **Windows**: Press the Windows key and type in *cmd*, press <kbd>Enter</kbd>.
+  * **MacOS**: Press the *Command* key and the *space bar* simultaneously, then type in *Terminal* and double click on *Terminal*.
+  * **Linux**: Press <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>T</kbd>.

@slide(layout=content-only)

@ -28,16 +28,15 @@ Digression: Opening&nbsp;a&nbsp;command&nbsp;prompt
 Installing the compiler

@content
-* The compiler translates our  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 code into a PDF
-* Depending on your operating system, different compilers are available
-* Windows: <a href="https://miktex.org/download">MikT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X</a>
-* macOS: <a href="https://tug.org/mactex/">MacT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X</a>
-* Linux distributions: <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-based distributions: run `sudo apt install texlive-full`
-  * other distributions: see the T<sub style="font-size: 100%; margin-left: -.1em">E</sub>XLive website
+* The compiler translates our  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 code into a properly formatted PDF document.
+* Depending on your operating system, different compilers are available:
+
+  * Windows:  <a href="https://miktex.org/download">MikT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X</a>
+  * Linux: <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> (preferably `texlive-full`)
+  * macOS: <a href="http://tug.org/mactex/">MacT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X</a>

 <div class="box warning">
-Make sure to install the full version with all packages, if you can!
+On Windows, please open the MikT<sub style="font-size: 100%; margin-left: -.1em">E</sub>X Console once and search for updates.
 </div>

@slide(layout=content-only)
@ -46,10 +45,10 @@ Make sure to install the full version with all packages, if you can!
 Installing the editor

@content
-* An editor can downloaded once the compiler has been installed
-* For editing LaTeX documents, any text editor works fine, e.g., <a href="https://notepad-plus-plus.org/downloads/">Notepad++</a>, <a href="https://code.visualstudio.com/download">VSCode</a>
-* For beginners, <a href="https://www.texstudio.org/">T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio</a> is recommended due to its LaTeX-specific features
-* Download and install T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio
+* An editor can be downloaded once the compiler has been installed.
+* For editing LaTeX documents, any text editor works fine, e.&thinsp;g., <a href="https://notepad-plus-plus.org/downloads/">Notepad++</a> or <a href="https://code.visualstudio.com/download">VSCode</a>.
+* For beginners, we recommend <a href="https://www.texstudio.org/">T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio</a> due to its LaTeX-specific features.
+* Download and install T<sub style="font-size: 100%; margin-left: -.1em">E</sub>Xstudio.

@slide(layout=content-only)
@title
--- a/slides/titlepage.de.md
+++ b/slides/titlepage.de.md
@ -4,5 +4,5 @@
 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-Wochenende

@subscript
-Ein Workshop der Fachschaft WIAI. Präsentiert von Evelyn&nbsp;Fradtschuk, Jessica&nbsp;Klarmann, Florian&nbsp;Knoch, Theresa&nbsp;Knoll, Christian&nbsp;Kremitzl, Bernhard&nbsp;Luedtke und Jochen&nbsp;Mehlich.
+Ein Workshop der Fachschaft WIAI. Präsentiert von Jessica&nbsp;Klarmann, Jannik&nbsp;Kiesel, Florian&nbsp;Knoch, Theresa&nbsp;Knoll und Hannah&nbsp;Rattenberger.

--- a/slides/titlepage.en.md
+++ b/slides/titlepage.en.md
@ -4,5 +4,5 @@
 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 Weekend

@subscript
-A Fachschaft WIAI workshop. Presented by Evelyn&nbsp;Fradtschuk, Jessica&nbsp;Klarmann, Florian&nbsp;Knoch, Theresa&nbsp;Knoll, Christian&nbsp;Kremitzl, Fabian&nbsp;Lamprecht, Bernhard&nbsp;Luedtke and Jochen&nbsp;Mehlich.
+A Fachschaft WIAI workshop. Presented by Jessica&nbsp;Klarmann, Jannik&nbsp;Kiesel, Florian&nbsp;Knoch, Theresa&nbsp;Knoll, and Hannah&nbsp;Rattenberger.