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

@slide(layout=chapter-slide)

@title References and footnotes

@slide(layout=content-and-preview)

@title Footnotes 📎

@content

\usepackage{hyperref}

Footnotes are automatically numbered consecutively, independent of sections.

(Here, hyperref is used for the \url command, it is not necessary for footnotes per se.)

The wild boar (Sus scrofa), also known as
the wild swine, Common wild pig, or 
simply wild pig, is a suid native to much
of the Palearctic, as well as introduced 
numbers in the Americas and Southeast 
Asia.
\footnote{\url{https://en.wikipedia.org/
wiki/Wild_boar}}

@preview

@slide(layout=content-only)

@title Using the hyperref package

@content

\usepackage{hyperref}

Creates clickable links within the document itself (table of contents, tables/figures, index).

The appearance of these links is customizable.

The command \url creates a monospaced external hyperlink that will open a browser and has special line break properties.

@slide(layout=content-and-preview)

@title Configuring footnotes

@content The footmisc package provides additional options for the presentation of footnotes that can be activated by adding parameters to the \usepackage command.

% Reset the counter on each page:
\usepackage[perpage]{footmisc}

% Display footnotes in-line:
\usepackage[para]{footmisc}

% Use symbols instead of numbers:
\usepackage[symbol]{footmisc}

@preview {.thin-padding}

@slide(layout=content-and-preview)

@title Cross-references

@content Manually (just don’t!)

As you can see in figure 23, …

Using the \ref command:

\begin{figure}[H]
    \includegraphics % …
    \caption{Our mascot Fooboar}
    \label{img:fooboar}
\end{figure}

As you can see in figure 
\ref{img:fooboar}, …

@preview @slide(layout=content-only)

@title Assigning labels

@content Both cross-reference commands work with sections, figures, tables, listings, and equations, as long as you use correct labels.

Labels have to be unambiguous. For clarity, certain prefixes are common, and some packages use them to derive information.

`fig:` Figures	`tbl:` Tables
`sec:` Sections	`subsec:` Subsections
`ch:` Chapters	`itm:` Enumeration items
`eq:` Equations	`lst:` Source code listings

@slide(layout=content-and-preview)

@title Cross-references

@content Using the cleveref package (with one ‘r’!):

\begin{figure}[H]
    \includegraphics % …
    \caption{Our mascot Fooboar}
    \label{img:fooboar}
\end{figure}

Fooboar is a young and highly engaged
boar (see \cref{img:fooboar}).

The \cref command automatically inserts suitable prefixes.

@preview

@slide(layout=content-only)

@title Things to consider

@content

• Terms inserted by \cref use the language specified with the document class (or babel):

  \documentclass[english]{article}
  

• Apart from sections, referenced elements need captions (\caption{…}), and the captions have to be placed before the label.

• For sectioning commands, the label is inserted directly after the section command.

  \section{Notes}\label{sec:notes}
  

@slide(layout=content-and-preview)

@title A few more things

@content

• It is recommended that you include the package hyperref before cleveref.
• \cref can take multiple references at once, separated by commas.

\section{An introduction}
\label{sec:section1}
% …
Reference be made to 
\cref{sec:section1,sec:section2,
sec:section3,sec:section5}.

@preview

@slide(layout=task)

@task-number 12

@title Inserting references

@content

• Write a footnote for a word of your choice.
• ++ On the second page of the document, insert a paragraph about the LaTeX weekend with \cref references to some of the sections you’ve been working on. You might have to assign labels first.
• ++ Wrap a figure environment around the listings from task 9 (section 2.4).
• ++ Add a label and caption to each of them.
• ++ Replace the reference numbers in the surrounding paragraphs by actual references to the listings.