Compare commits

..

No commits in common. "be0d898ade6077683c25a25181dd6b4956a94360" and "200c97e85551267909b46c9754ffdde8410e5e48" have entirely different histories.

10 changed files with 173 additions and 87 deletions

View File

@ -1,5 +1,5 @@
- titlepage
- intro - intro
- titlepage
- why-use-latex - why-use-latex
- basic-functionality - basic-functionality
- basic-document-structure - basic-document-structure

View File

@ -218,15 +218,14 @@ Titelei
\author{Fooboar Rüssel \and \author{Fooboar Rüssel \and
Fachschaft WIAI} Fachschaft WIAI}
\date{\today} \date{\today}
\begin{document} \begin{document}
\maketitle \maketitle
\section{Trüffelsuche} \section{Trüffelsuche}
\subsection{Suche mit Schwein} \subsection{Suche mit Schwein}
\subsection{Suche ohne Schwein} \subsection{Suche ohne Schwein}
Wer macht denn sowas? Wer macht denn sowas?
\section{Trüffelrezepte} \section{Trüffelrezepte}
Mein Lieblingsrezept Mein Lieblingsrezept
\end{document} \end{document}
``` ```
@ -258,21 +257,21 @@ Inhaltsverzeichnis
@content @content
``` {.lang-tex .hljs data-source=title.tex} ``` {.lang-tex .hljs data-source=title.tex}
\documentclass[ngerman]{article} \documentclass[ngerman]{scrartcl}
\usepackage{babel} \usepackage{babel}
\begin{document} \begin{document}
\tableofcontents \tableofcontents
\section{Trüffelsuche} \section{Trüffelsuche}
Der erste Abschnitt. Der erste Abschnitt.
\subsection{Suche mit Schwein} \subsection{Suche mit Schwein}
Ein Unterabschnitt. Ein Unterabschnitt.
\subsection{Suche ohne Schwein} \subsection{Suche ohne Schwein}
Ein weiterer Unterabschitt. Ein weiterer Unterabschitt.
\subsubsection[But why?]{Wer macht \subsubsection[But why?]
denn sowas?} {Wer macht denn sowas?}
Unter-Unterabschnitt. Unter-Unterabschnitt.
\section{Trüffelrezepte} \section{Trüffelrezepte}
Mein Lieblingsrezept Mein Lieblingsrezept
\end{document} \end{document}
``` ```
@ -294,7 +293,7 @@ Dokument und Text gliedern
* Packt den gesamten Text in der Datei in eine **Document**-Umgebung und schreibt darüber folgende **Präambel**. Kompiliert die Datei. * Packt den gesamten Text in der Datei in eine **Document**-Umgebung und schreibt darüber folgende **Präambel**. Kompiliert die Datei.
``` {.lang-tex .hljs .fragment} ``` {.lang-tex .hljs .fragment}
\documentclass{article} \documentclass{scrartcl}
\usepackage[utf8]{inputenc} \usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc} \usepackage[T1]{fontenc}
\usepackage[ngerman]{babel} \usepackage[ngerman]{babel}

View File

@ -218,15 +218,14 @@ Front matter
\author{Fooboar Rüssel \author{Fooboar Rüssel
\and Fachschaft WIAI} \and Fachschaft WIAI}
\date{\today} \date{\today}
\begin{document} \begin{document}
\maketitle \maketitle
\section{Truffle hunt} \section{Truffle hunt}
\subsection{Hunt with a pig} \subsection{Hunt with a pig}
\subsection{Hunt without a pig} \subsection{Hunt without a pig}
Why would you do that? Why would you do that?
\section{Truffle recipes} \section{Truffle recipes}
My favorite recipe My favorite recipe
\end{document} \end{document}
``` ```
@ -261,18 +260,18 @@ Table of contents
\documentclass{article} \documentclass{article}
\usepackage{babel} \usepackage{babel}
\begin{document} \begin{document}
\tableofcontents \tableofcontents
\section{Truffle hunt} \section{Truffle hunt}
The first section. The first section.
\subsection{Hunt with a pig} \subsection{Hunt with a pig}
A subsection. A subsection.
\subsection{Hunt without a pig} \subsection{Hunt without a pig}
Another subsection. Another subsection.
\subsubsection[But why?]{Why would \subsubsection[But why?]
you do that?} {Why would you do that?}
Sub-subsection. Sub-subsection.
\section{Truffle recipes} \section{Truffle recipes}
My favorite recipe My favorite recipe
\end{document} \end{document}
``` ```
@ -293,7 +292,7 @@ Structure your document and text
* Wrap the entire text in a **document** environment and insert the following **preamble**. Compile the document. * Wrap the entire text in a **document** environment and insert the following **preamble**. Compile the document.
``` {.lang-tex .hljs .fragment} ``` {.lang-tex .hljs .fragment}
\documentclass{article} \documentclass{scrartcl}
\usepackage[utf8]{inputenc} \usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc} \usepackage[T1]{fontenc}
\usepackage[english]{babel} \usepackage[english]{babel}

View File

@ -16,7 +16,7 @@ Exkurs: Eine Kommandozeile öffnen
@content @content
* Für die kommenden Aufgaben brauchen wir eine Kommandozeile. * Für die kommenden Aufgaben brauchen wir eine Kommandozeile.
* Je nach Betriebssystem, das verwendet wird, gibt es unterschiedliche Wege, sie zu öffnen: * 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 * **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* * **MacOS**: Drückt die *Command*-Taste und die Leertaste gleichzeitig, tippt danach *Terminal* und macht einen Doppelklick auf *Terminal*

View File

@ -145,7 +145,7 @@ Dinge, die zu beachten sind
Fußnoten einfügen Fußnoten einfügen
@content @content
* Verschiebt den Text *„released in September 2023“* in der Datei `exercises/footnotes/footnotes.tex` in eine **Fußnote**. * Pack den Text *March 2023* in der Datei `exercises/footnotes/footnotes.tex` in eine **Fußnote**.
* Fügt zusätzlich eine **klickbare URL**, die zur Download-Seite des Java Development Kit führt (`https://www.oracle.com/java/technologies/javase-downloads.html`), als Fußnote ein. * Fügt zusätzlich eine **klickbare URL**, die zur Download-Seite des Java Development Kit führt (`https://www.oracle.com/java/technologies/javase-downloads.html`), als Fußnote ein.

View File

@ -148,7 +148,7 @@ Things to consider
Inserting footnotes Inserting footnotes
@content @content
* Make the text *“released in September 2023”* in file `exercises/footnotes/footnotes.tex` appear as a **footnote**. * Make the text *March 2023* in file `exercises/footnotes/footnotes.tex` appear as a **footnote**.
* Additionally, insert a **clickable URL** that leads to the download page for the Java Development Kit (`https://www.oracle.com/java/technologies/javase-downloads.html`). * Additionally, insert a **clickable URL** that leads to the download page for the Java Development Kit (`https://www.oracle.com/java/technologies/javase-downloads.html`).

View File

@ -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 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 @subscript
Ein Workshop der Fachschaft WIAI. Präsentiert von Laetitia&nbsp;Hilgendorf, Jessica&nbsp;Klarmann, Florian&nbsp;Knoch, Theresa&nbsp;Knoll 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.

View File

@ -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 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 @subscript
A Fachschaft WIAI workshop. Presented by Laetitia&nbsp;Hilgendorf, Jessica&nbsp;Klarmann, Florian&nbsp;Knoch, Theresa&nbsp;Knoll, 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.

View File

@ -24,35 +24,80 @@ Entstehung
@preview @preview
![](svg/chapter-01/taocp.jpg) ![](svg/chapter-01/taocp.jpg)
@slide(layout=content-only)
@slide(layout=macro-typography-grid)
@title @title
5 Gründe für LaTeX Gründe für LaTeX: Makrotypografie
@content @example-text
1. LaTeX ist neben Word **eines der beiden dominierenden Textsatzsysteme** in der akademischen Welt. Dieser Absatz soll zeigen, wie sich unter&shy;schied&shy;liche Zeilen&shy;abstände bei unter&shy;schied&shy;lichen Satz&shy;breiten aus&shy;wirken. Dazu ist hier noch ein bisschen mehr Text nötig, damit das auch wirklich nach einem Absatz aussieht. Dazu ist hier noch ein bisschen mehr Text nötig, damit das auch wirklich nach einem Absatz aussieht. Dazu ist hier noch ein bisschen mehr Text nötig, damit das auch wirklich nach einem Absatz aussieht. Dazu ist hier noch ein bisschen mehr Text nötig, damit das auch wirklich nach einem Absatz aussieht. Dazu ist hier noch ein bisschen mehr Text nötig, damit das auch wirklich nach einem Absatz aussieht. Dazu ist hier noch ein bisschen mehr Text nötig, damit das auch wirklich nach einem Absatz aussieht. Dazu ist hier noch ein bisschen mehr Text nötig, damit das auch wirklich nach einem Absatz aussieht.
2. ++ **Mathematische Formeln** fühlen sich in LaTeX am wohlsten. Darum wurde die LaTeX-Formelnotation in zahlreiche andere Tools integriert (z.&thinsp;B. OneNote, Word, Wikipedia, …).
3. ++ Es gibt **unzählige Erweiterungen** für die verschiedensten Anwendungsgebiete. @narrow-tight
4. ++ LaTeX wurde entwickelt, um **ästhetisch anspechenden Textsatz** zu produzieren und das sieht man den Texten auch an. Kurz und eng
5. ++ Komplexe Dokumente, die in LaTeX gesetzt sind, **erleichtern die Zusammenarbeit** enorm (z.&thinsp;B. durch Versionierung, Strukturierung, Templates, zuverlässiges Undo, …).
@normal-tight
Normale Länge und enger Zeilenabstand
@wide-tight
Lange Zeilen und enger Zeilenabstand
@narrow-medium
Kurz und normal
@normal-medium
Normale Länge und Zeilenabstand
@wide-medium
Lange Zeilen und normaler Zeilenabstand
@narrow-loose
Kurz und weit
@normal-loose
Normale Länge und weiter Zeilenabstand
@wide-loose
Lange Zeilen und weiter Zeilenabstand
@slide(layout=micro-typography-grid)
@title
Gründe für LaTeX: Mikrotypografie
@example1a
schräg (verzerrt)
@example1b
gerade
@example1c
kursiv (eigener Schnitt)
@example2a
kleine Schrift vergrößert
@example2b
jeweils passender Schriftgrad
@example2c
große Schrift verkleinert
@slide(layout=content-only) @slide(layout=content-only)
@title @title
Die Schwächen von LaTeX Gründe für LaTeX: Plaintext
@content @content
* Der Textsatz ist mitunter sehr **aufwändig**, insbesondere für kurze Dokumente. * zuverlässiges Undo
* **Layout-Anpassungen** sind nur in einem begrenzten Rahmen möglich. * einfache Versionierung
* unabhängig von proprietären Programmen
<div class="box warning"> * Quelltext langfristig lesbar
Die Debatte „LaTeX vs. Word“ ist schon sehr alt. Für eine Recherche dazu lohnt sich als Einstieg folgender Artikel: * einfache Zusammenarbeit mit anderen Programmen
* keine Ablenkung durch Formatierung oder eingebettete Medien
Moorhead, A.V. [**Is LaTeX use correlated with the number of equations in a manuscript?**](https://doi.org/10.1007/s11192-021-04119-2). Scientometrics 126, 82598273 (2021).
<small style="font-size: 60%; line-height: 1.5em">(TL;DR: LaTeX-Nutzende machen mehr Fehler, brauchen außer bei Formeln länger, sind aber zufriedener mit ihrem Werkzeug.)</small>
</div>
@slide(layout=content-and-preview) @slide(layout=content-and-preview)

View File

@ -25,35 +25,78 @@ Origin
![](svg/chapter-01/taocp.jpg) ![](svg/chapter-01/taocp.jpg)
@slide(layout=content-only) @slide(layout=macro-typography-grid)
@title @title
5 Reasons for LaTeX Reasons for using LaTeX: macrotypography
@content @example-text
1. Besides Word, LaTeX is **one of the two dominant typesetting systems** in the academic world. This paragraph shows the effect of varied line heights in combination with varied line lengths. For this purpose, a little more text is needed to make it look like an actual paragraph. For this purpose, a little more text is needed to make it look like an actual paragraph. For this purpose, a little more text is needed to make it look like an actual paragraph. For this purpose, a little more text is needed to make it look like an actual paragraph. For this purpose, a little more text is needed to make it look like an actual paragraph. For this purpose, a little more text is needed to make it look like an actual paragraph. For this purpose, a little more text is needed to make it look like an actual paragraph. For this purpose, a little more text is needed to make it look like an actual paragraph.
2. ++ **Mathematical formulas** feel most at home in LaTeX. This is why the LaTeX formula notation has been integrated into numerous other tools (e.&thinsp;g. OneNote, Word, Wikipedia, …).
3. ++ There are **countless packages** for the most diverse areas of application. @narrow-tight
4. ++ LaTeX was developed to produce **aesthetically pleasing typesetting**&thinsp;&thinsp;and you can see that in the texts it produces. short & tight
5. ++ Complex documents typeset in LaTeX **facilitate collaboration** enormously (e.&thinsp;g. through versioning, proper document structuring, templates, reliable undo, …).
@normal-tight
normal length and tight leading
@wide-tight
long lines and tight leading
@narrow-medium
short & medium
@normal-medium
normal length and leading
@wide-medium
long lines and medium leading
@narrow-loose
short & loose
@normal-loose
normal length and loose leading
@wide-loose
long lines and loose leading
@slide(layout=micro-typography-grid)
@title
Reasons for using LaTeX: microtypography
@example1a
slanted (distorted)
@example1b
straight
@example1c
italic (separate font)
@example2a
small font scaled up
@example2b
separate appropriate fonts
@example2c
big font scaled down
@slide(layout=content-only) @slide(layout=content-only)
@title @title
LaTeX' Shortcomings Reasons for using LaTeX: plaintext
@content @content
* Typesetting text can be **cumbersome**, especially for short documents. * reliable undo
* **Layout adjustments** are only possible within certain limits. * easy versioning
* independence of proprietary software
<div class="box warning"> * source code readable in the long term
The “LaTeX vs. Word” debate is very old. If you are interested in tracing it, we can recommend the following article as a starting point: * easy cooperation with other software
* no distraction by formatting or embedded media
Moorhead, A.V. [**Is LaTeX use correlated with the number of equations in a manuscript?**](https://doi.org/10.1007/s11192-021-04119-2). Scientometrics 126, 82598273 (2021).
<small style="font-size: 60%; line-height: 1.5em">(TL;DR: LaTeX users make more errors, they need more time except when it comes to formulas, but they are happier with their tool.)</small>
</div>
@slide(layout=content-and-preview) @slide(layout=content-and-preview)