From ef38d7572712f23eb5c7a1894675a225ba2a8db0 Mon Sep 17 00:00:00 2001 From: Christian Kremitzl Date: Sat, 28 Mar 2020 00:40:46 +0100 Subject: [PATCH] onpoint conversion of chapter 13. --- sections/german/13/13.md | 174 -------- slides.yml | 1 + slides/chapter-13.de.md | 197 +++++++++ slides/chapter-13.en.md | 0 .../chapter-13}/cref-example-crop.svg | 0 .../chapter-13}/cref-example-orig.svg | 0 .../13 => svg/chapter-13}/cref-example.tex | 0 .../cref-multiple-example-crop.svg | 0 .../cref-multiple-example-orig.svg | 0 .../chapter-13}/cref-multiple-example.tex | 0 .../german/13 => svg/chapter-13}/fooboar.jpeg | Bin .../13 => svg/chapter-13}/footmisc-crop.svg | 0 .../13 => svg/chapter-13}/footmisc-orig.svg | 0 .../german/13 => svg/chapter-13}/footmisc.tex | 0 .../chapter-13}/footnote-example-crop.svg | 0 .../chapter-13}/footnote-example-orig.svg | 0 svg/chapter-13/fußnotenbeispiel-crop.svg | 394 ++++++++++++++++++ svg/chapter-13/fußnotenbeispiel-orig.svg | 394 ++++++++++++++++++ .../chapter-13/fußnotenbeispiel.tex | 0 .../chapter-13}/ref-example-crop.svg | 0 .../chapter-13}/ref-example-orig.svg | 0 .../13 => svg/chapter-13}/ref-example.tex | 0 22 files changed, 986 insertions(+), 174 deletions(-) delete mode 100644 sections/german/13/13.md create mode 100644 slides/chapter-13.de.md create mode 100644 slides/chapter-13.en.md rename {sections/german/13 => svg/chapter-13}/cref-example-crop.svg (100%) rename {sections/german/13 => svg/chapter-13}/cref-example-orig.svg (100%) rename {sections/german/13 => svg/chapter-13}/cref-example.tex (100%) rename {sections/german/13 => svg/chapter-13}/cref-multiple-example-crop.svg (100%) rename {sections/german/13 => svg/chapter-13}/cref-multiple-example-orig.svg (100%) rename {sections/german/13 => svg/chapter-13}/cref-multiple-example.tex (100%) rename {sections/german/13 => svg/chapter-13}/fooboar.jpeg (100%) rename {sections/german/13 => svg/chapter-13}/footmisc-crop.svg (100%) rename {sections/german/13 => svg/chapter-13}/footmisc-orig.svg (100%) rename {sections/german/13 => svg/chapter-13}/footmisc.tex (100%) rename {sections/german/13 => svg/chapter-13}/footnote-example-crop.svg (100%) rename {sections/german/13 => svg/chapter-13}/footnote-example-orig.svg (100%) create mode 100644 svg/chapter-13/fußnotenbeispiel-crop.svg create mode 100644 svg/chapter-13/fußnotenbeispiel-orig.svg rename sections/german/13/footnote-example.tex => svg/chapter-13/fußnotenbeispiel.tex (100%) rename {sections/german/13 => svg/chapter-13}/ref-example-crop.svg (100%) rename {sections/german/13 => svg/chapter-13}/ref-example-orig.svg (100%) rename {sections/german/13 => svg/chapter-13}/ref-example.tex (100%) diff --git a/sections/german/13/13.md b/sections/german/13/13.md deleted file mode 100644 index 9055b8f..0000000 --- a/sections/german/13/13.md +++ /dev/null @@ -1,174 +0,0 @@ -
-
-

Referenzen und Fußnoten

-
-
- ---- - -
-
-

Fußnoten 📎

- 
\usepackage{hyperref}
-

Die Nummerierung erfolgt automatisch und ist fortlaufend, unabhängig davon, ob ein neuer Abschnitt beginnt.

- 
Eber, beim Hausschwein insbesondere
-oberdeutsch Saubär, beim Wildschwein
-Keiler, bezeichnet das männliche
-Geschlecht des Schweins.
-\footnote{\url{http​s://de.wikipedia.org/
-wiki/Eber}}
-
-
- -
-
- ---- - -
-
-

Konfiguration von Fußnoten

-

Das Paket `footmisc` stellt verschiedene weitere Optionen für die Darstellung von Fußnoten zur Verfügung, die als optionale Parameter an den Befehl `\usepackage` übergeben werden können.

- 
% Zählung auf jeder Seite neu beginnen:
-\usepackage[perpage]{footmisc}
-
-% Fußnoten inline anzeigen lassen:
-\usepackage[para]{footmisc}
-
-% Symbole zur Nummerierung verwenden:
-\usepackage[symbol]{footmisc}
-
-
- -
-
- ---- - -
-
-

Referenzen

- Manuell (Just don’t!) - 
Wie man in Abbildung 23 sieht, …
- Mit dem Befehl \ref: - 
\begin{figure}[H]
-    \includegraphics % …
-    \caption{Unser Maskottchen Fooboar}
-    \label{img:fooboar}
-\end{figure}
-
-Wie man in Abbildung \ref{img:fooboar} …
-
-
- -
-
- ---- - -
-
-

Referenzen

- Mit dem Paket cleveref: - 
\begin{figure}[H]
-    \includegraphics % …
-    \caption{Unser Maskottchen Fooboar}
-    \label{img:fooboar}
-\end{figure}
-
-Fooboar ist ein sehr engagierter
-Jungeber (siehe \cref{img:fooboar}).
-

Der Befehl \cref fügt selbstständig die passende Abkürzung ein.

-
-
- -
-
- ---- - -
-
-

Label vergeben

-

- Beide Referenzierungsbefehle funktionieren mit Abschnitten, Bildern, Tabellen, Listings und Gleichungen, sofern die richtigen Label vergeben wurden. -

-

- Label müssen eindeutig sein. Zur Strukturierung ist das Voranstellen von Kürzeln üblich, denn einige Pakete ziehen aus den Kürzeln Informationen.
-

- - - - - - - - - - - - - - - - - -
fig: Figurestbl: Tabellen
sec: Abschnittesubsec: Unter­abschnitte
ch: Kapitelitm: Aufzählungs­elemente
eq: Gleichungenlst: Quelltext­listings
-
-
- ---- - -
-
-

Dinge, die zu beachten sind

-
    -
  • Durch \cref eingefügte Passagen tauchen in einigen Dokumentklassen erst dann auf Deutsch auf, wenn bereits in der Dokumentklasse die Sprache festgelegt wurde: - 
    \documentclass[ngerman]{article}
    -
    • -
  • Beschriftungen (\caption{…}) müssen, von Abschnitten abgesehen, immer und vor dem Label vergeben werden.
    • -
  • Bei Abschnitten wird das Label direkt hinter dem Befehl angefügt.
    • - 
    \section{Hinweise}\label{sec:hinweise}
    -
-
-
- ---- - -
-
-

Weiterführend

-
    -
  • - Wurde vor dem Paket cleveref das Paket hyperref eingebunden, entsteht ein klickbarer Link im fertigen PDF. -
    • -
  • - Mehrere Referenzen können in \cref kommagetrennt angegeben werden. - 
    \section{Ein Einstieg}
-\label{sec:section1}
-% …
-Hier sei verwiesen auf
-\cref{sec:section1,sec:section2,
-sec:section3,sec:section5}.
    -
    • -
-
-
- -
-
- ---- - -
-
-

Referenzen einfügen

-
    -
  • Schreibt eine **Fußnote** zu einem beliebigen Wort.
    • -
  • Fügt auf der zweiten Seite des Dokuments einen Absatz zum LaTeX-Wochenende ein, in dem ihr mit `\cref` auf einige der Stellen **verweist,** an denen ihr zuletzt gearbeitet habt. Ggf. müsst ihr dafür zunächst Label vergeben.
    • -
  • Hüllt die **Listings aus Aufgabe 9** (Abschnitt 2.4) in eine `figure`-Umgebung.
    • -
  • Ergänzt jeweils ein **Label** und eine **Bildunterschrift**.
    • -
  • Ersetzt die im Fließtext darüber vergebenen Nummern durch **Verweise** auf die Listings.
    • -
-
-
diff --git a/slides.yml b/slides.yml index d95ec9f..bdc941a 100644 --- a/slides.yml +++ b/slides.yml @@ -11,4 +11,5 @@ - chapter-10 - chapter-11 - chapter-12 +- chapter-13 diff --git a/slides/chapter-13.de.md b/slides/chapter-13.de.md new file mode 100644 index 0000000..bfaeb77 --- /dev/null +++ b/slides/chapter-13.de.md @@ -0,0 +1,197 @@ +@slide(layout=chapter-slide) + +@title +Referenzen und Fußnoten + + +@slide(layout=content-and-preview) + +@title +Fußnoten 📎 + +@content +``` {.hljs .lang-tex} +\usepackage{hyperref} +``` + +Die Nummerierung erfolgt automatisch und ist fortlaufend, unabhängig davon, ob ein neuer Abschnitt beginnt. + +``` {.hljs .lang-tex} +Eber, beim Hausschwein insbesondere +oberdeutsch Saubär, beim Wildschwein +Keiler, bezeichnet das männliche +Geschlecht des Schweins. +\footnote{\url{https://de.wikipedia.org/ +wiki/Eber}} +``` + +@preview +![](svg/chapter-13/fußnotenbeispiel-crop.svg) + + +@slide(layout=content-and-preview) + +@title +Konfiguration von Fußnoten + +@content +Das Paket `footmisc` stellt verschiedene weitere Optionen für die Darstellung von Fußnoten zur Verfügung, die als optionale Parameter an den Befehl `\usepackage` übergeben werden können. + +``` {.hljs .lang-tex} +% Zählung auf jeder Seite neu beginnen: +\usepackage[perpage]{footmisc} + +% Fußnoten inline anzeigen lassen: +\usepackage[para]{footmisc} + +% Symbole zur Nummerierung verwenden: +\usepackage[symbol]{footmisc} +``` + +@preview +![](svg/chapter-13/footmisc-crop.svg){.thin-padding} + + +@slide(layout=content-and-preview) + +@title +Referenzen + +@content +Manuell (Just don’t!) + +``` {.hljs .lang-tex} +Wie man in Abbildung 23 sieht, … +``` + +Mit dem Befehl `\ref`: + +``` {.hljs .lang-tex} +\begin{figure}[H] + \includegraphics % … + \caption{Unser Maskottchen Fooboar} + \label{img:fooboar} +\end{figure} + +Wie man in Abbildung \ref{img:fooboar} … +``` + +@preview +![](svg/chapter-13/ref-example-crop.svg) + + +@slide(layout=content-and-preview) + +@title +Referenzen + +@content +Mit dem Paket `cleveref`: + +``` {.hljs .lang-tex} +\begin{figure}[H] + \includegraphics % … + \caption{Unser Maskottchen Fooboar} + \label{img:fooboar} +\end{figure} + +Fooboar ist ein sehr engagierter +Jungeber (siehe \cref{img:fooboar}). +``` + +Der Befehl `\cref` fügt selbstständig die passende Abkürzung ein. + +@preview +![](svg/chapter-13/cref-example-crop.svg) + + +@slide(layout=content-only) + +@title +Label vergeben + +@content +Beide Referenzierungsbefehle funktionieren mit **Abschnitten, Bildern, Tabellen, Listings und Gleichungen,** sofern die richtigen Label vergeben wurden. + +Label müssen **eindeutig** sein. Zur Strukturierung ist das Voranstellen von Kürzeln üblich, denn einige Pakete ziehen aus den Kürzeln Informationen. + + + + + + + + + + + + + + + + + + +
`fig:` Figures`tbl:` Tabellen
`sec:` Abschnitte`subsec:` Unter­abschnitte
`ch:` Kapitel`itm:` Aufzählungs­elemente
`eq:` Gleichungen`lst:` Quelltext­listings
+ + +@slide(layout=content-only) + +@title +Dinge, die zu beachten sind + +@content +* ++Durch \cref eingefügte Passagen tauchen in einigen Dokumentklassen erst dann auf Deutsch auf, wenn bereits in der Dokumentklasse die Sprache festgelegt wurde: + + ``` {.hljs .lang-tex} + \documentclass[ngerman]{article} + ``` + +* ++Beschriftungen (`\caption{…}`) müssen, von Abschnitten abgesehen, **immer und vor dem Label** vergeben werden. + +* ++Bei Abschnitten wird das Label direkt hinter dem Befehl angefügt. + + ``` {.hljs .lang-tex} + \section{Hinweise}\label{sec:hinweise} + ``` + + +@slide(layout=content-and-preview) + +@title +Weiterführend + +@content +* ++Wurde vor dem Paket `cleveref` das Paket `hyperref` eingebunden, entsteht ein **klickbarer Link** im fertigen PDF. +* ++Mehrere Referenzen können in `\cref` kommagetrennt angegeben werden. + + ``` {.hljs .lang-tex} + \section{Ein Einstieg} + \label{sec:section1} + % … + Hier sei verwiesen auf + \cref{sec:section1,sec:section2, + sec:section3,sec:section5}. + ``` + +@preview +![](svg/chapter-13/cref-multiple-example-crop.svg) + + +@slide(layout=task) + +@task-number +12 + +@title +Referenzen einfügen + +@content +* Schreibt eine **Fußnote** zu einem beliebigen Wort. +* ++Fügt auf der zweiten Seite des Dokuments einen Absatz zum LaTeX-Wochenende ein, in dem ihr mit `\cref` auf einige der Stellen **verweist,** an denen ihr zuletzt gearbeitet habt. Ggf. müsst ihr dafür zunächst Label vergeben. +* ++Hüllt die **Listings aus Aufgabe 9** (Abschnitt 2.4) in eine `figure`-Umgebung. +* ++Ergänzt jeweils ein **Label** und eine **Bildunterschrift**. +* ++Ersetzt die im Fließtext darüber vergebenen Nummern durch **Verweise** auf die Listings. + + + diff --git a/slides/chapter-13.en.md b/slides/chapter-13.en.md new file mode 100644 index 0000000..e69de29 diff --git a/sections/german/13/cref-example-crop.svg b/svg/chapter-13/cref-example-crop.svg similarity index 100% rename from sections/german/13/cref-example-crop.svg rename to svg/chapter-13/cref-example-crop.svg diff --git a/sections/german/13/cref-example-orig.svg b/svg/chapter-13/cref-example-orig.svg similarity index 100% rename from sections/german/13/cref-example-orig.svg rename to svg/chapter-13/cref-example-orig.svg diff --git a/sections/german/13/cref-example.tex b/svg/chapter-13/cref-example.tex similarity index 100% rename from sections/german/13/cref-example.tex rename to svg/chapter-13/cref-example.tex diff --git a/sections/german/13/cref-multiple-example-crop.svg b/svg/chapter-13/cref-multiple-example-crop.svg similarity index 100% rename from sections/german/13/cref-multiple-example-crop.svg rename to svg/chapter-13/cref-multiple-example-crop.svg diff --git a/sections/german/13/cref-multiple-example-orig.svg b/svg/chapter-13/cref-multiple-example-orig.svg similarity index 100% rename from sections/german/13/cref-multiple-example-orig.svg rename to svg/chapter-13/cref-multiple-example-orig.svg diff --git a/sections/german/13/cref-multiple-example.tex b/svg/chapter-13/cref-multiple-example.tex similarity index 100% rename from sections/german/13/cref-multiple-example.tex rename to svg/chapter-13/cref-multiple-example.tex diff --git a/sections/german/13/fooboar.jpeg b/svg/chapter-13/fooboar.jpeg similarity index 100% rename from sections/german/13/fooboar.jpeg rename to svg/chapter-13/fooboar.jpeg diff --git a/sections/german/13/footmisc-crop.svg b/svg/chapter-13/footmisc-crop.svg similarity index 100% rename from sections/german/13/footmisc-crop.svg rename to svg/chapter-13/footmisc-crop.svg diff --git a/sections/german/13/footmisc-orig.svg b/svg/chapter-13/footmisc-orig.svg similarity index 100% rename from sections/german/13/footmisc-orig.svg rename to svg/chapter-13/footmisc-orig.svg diff --git a/sections/german/13/footmisc.tex b/svg/chapter-13/footmisc.tex similarity index 100% rename from sections/german/13/footmisc.tex rename to svg/chapter-13/footmisc.tex diff --git a/sections/german/13/footnote-example-crop.svg b/svg/chapter-13/footnote-example-crop.svg similarity index 100% rename from sections/german/13/footnote-example-crop.svg rename to svg/chapter-13/footnote-example-crop.svg diff --git a/sections/german/13/footnote-example-orig.svg b/svg/chapter-13/footnote-example-orig.svg similarity index 100% rename from sections/german/13/footnote-example-orig.svg rename to svg/chapter-13/footnote-example-orig.svg diff --git a/svg/chapter-13/fußnotenbeispiel-crop.svg b/svg/chapter-13/fußnotenbeispiel-crop.svg new file mode 100644 index 0000000..62f5652 --- /dev/null +++ b/svg/chapter-13/fußnotenbeispiel-crop.svg @@ -0,0 +1,394 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/svg/chapter-13/fußnotenbeispiel-orig.svg b/svg/chapter-13/fußnotenbeispiel-orig.svg new file mode 100644 index 0000000..0228981 --- /dev/null +++ b/svg/chapter-13/fußnotenbeispiel-orig.svg @@ -0,0 +1,394 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/sections/german/13/footnote-example.tex b/svg/chapter-13/fußnotenbeispiel.tex similarity index 100% rename from sections/german/13/footnote-example.tex rename to svg/chapter-13/fußnotenbeispiel.tex diff --git a/sections/german/13/ref-example-crop.svg b/svg/chapter-13/ref-example-crop.svg similarity index 100% rename from sections/german/13/ref-example-crop.svg rename to svg/chapter-13/ref-example-crop.svg diff --git a/sections/german/13/ref-example-orig.svg b/svg/chapter-13/ref-example-orig.svg similarity index 100% rename from sections/german/13/ref-example-orig.svg rename to svg/chapter-13/ref-example-orig.svg diff --git a/sections/german/13/ref-example.tex b/svg/chapter-13/ref-example.tex similarity index 100% rename from sections/german/13/ref-example.tex rename to svg/chapter-13/ref-example.tex