221 lines
4.7 KiB
Markdown
221 lines
4.7 KiB
Markdown
@slide(layout=chapter-slide)
|
||
|
||
@title
|
||
References and footnotes
|
||
|
||
|
||
@slide(layout=content-and-preview)
|
||
|
||
@title
|
||
Footnotes <span class="emoji">📎</span>
|
||
|
||
@content
|
||
``` {.hljs .lang-tex}
|
||
\usepackage{hyperref}
|
||
```
|
||
|
||
Footnotes are automatically numbered consecutively, independent of sections.
|
||
|
||
(Here, the package `hyperref` is used for the `\url` command, it is not necessary for footnotes per se.)
|
||
|
||
``` {.hljs .lang-tex}
|
||
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-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.
|
||
|
||
``` {.hljs .lang-tex}
|
||
% 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!)
|
||
|
||
``` {.hljs .lang-tex}
|
||
As you can see in figure 23, …
|
||
```
|
||
|
||
Using the `\ref` command:
|
||
|
||
``` {.hljs .lang-tex}
|
||
\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.
|
||
|
||
<table>
|
||
<tr>
|
||
<td>`fig:` Figures</td>
|
||
<td>`tbl:` Tables</td>
|
||
</tr>
|
||
<tr>
|
||
<td>`sec:` Sections</td>
|
||
<td>`subsec:` Subsections</td>
|
||
</tr>
|
||
<tr>
|
||
<td>`ch:` Chapters</td>
|
||
<td>`itm:` Enumeration items</td>
|
||
</tr>
|
||
<tr>
|
||
<td>`eq:` Equations</td>
|
||
<td>`lst:` Source code listings</td>
|
||
</tr>
|
||
</table>
|
||
|
||
|
||
|
||
@slide(layout=content-and-preview)
|
||
|
||
@title
|
||
Cross-references
|
||
|
||
@content
|
||
Using the `cleveref` package (with *one* ‘r’!):
|
||
|
||
``` {.hljs .lang-tex}
|
||
\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
|
||
Using the `hyperref` package
|
||
|
||
@content
|
||
``` {.hljs .lang-tex}
|
||
\usepackage{hyperref}
|
||
```
|
||
|
||
Creates **clickable links** within the document itself (toc, tables/figures, index).
|
||
|
||
The appearance of these links is customizable.
|
||
|
||
The command `\autoref` creates a reference that states the target's type.
|
||
|
||
The command `\url` creates a monospaced external hyperlink that will open a browser and has special breaking properties.
|
||
|
||
|
||
@slide(layout=content-only)
|
||
|
||
@title
|
||
Things to consider
|
||
|
||
@content
|
||
* Terms inserted by `\cref` and `\autoref` use the language specified with the document class (or `babel`):
|
||
|
||
``` {.hljs .lang-tex}
|
||
\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.
|
||
|
||
``` {.hljs .lang-tex}
|
||
\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.
|
||
|
||
``` {.hljs .lang-tex}
|
||
\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.
|
||
|
||
|
||
|
||
|