latex-wochenende/slides/chapter-13.de.md

@slide(layout=chapter-slide)

@title
Referenzen und Fußnoten


@slide(layout=content-and-preview)

@title
Fußnoten <span class="emoji">📎</span>

@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 statt Nummerierung verwenden:
\usepackage[symbol]{footmisc}
```

@preview
![](svg/chapter-13/footmisc-de-crop.svg){.thin-padding}


@slide(layout=content-and-preview)

@title
Querverweise

@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-beispiel-crop.svg)


@slide(layout=content-and-preview)

@title
Referenzen

@content
Mit dem Paket `cleveref` (mit *einem* ›r‹!):

``` {.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-beispiel-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.

<table>
	<tr>
		<td>`fig:` Abbildungen</td>
		<td>`tbl:` Tabellen</td>
	</tr>
	<tr>
		<td>`sec:` Abschnitte</td>
		<td>`subsec:` Unter&shy;abschnitte</td>
	</tr>
	<tr>
		<td>`ch:` Kapitel</td>
		<td>`itm:` Aufzählungs&shy;elemente</td>
	</tr>
	<tr>
		<td>`eq:` Gleichungen</td>
		<td>`lst:` Quelltext&shy;listings</td>
	</tr>
</table>


@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-beispiel-crop.svg)


@slide(layout=task)

@task-number
13

@title
Fußnoten einfügen

@content
*	Pack den Text *Stand März 2021* in der Datei `exercises/footnotes/footnotes.raw.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.



@slide(layout=task)

@task-number
14

@title
Referenzen einfügen

@content
*	Ersetzt im Text in der Datei `references.raw.tex` im Ordner `exercises/references` *in der Abbildung* und *Das nachstehende Quelltext-Listing* durch eine **Referenz** auf das Bild bzw. auf das Quelltext-Listing.
*	++ Nutzt dafür den Befehl `\cref`.
*	++ Achtet darauf, zuerst **Labels** für die Elemente, die ihr referenzieren wollt, zu vergeben.
*	++ Packt dafür das Quelltext-Listing in eine **Umgebung** namens `listing`.
*	++ Fügt noch eine **Beschriftung** zum Listing hinzu.