Footnotes and Sidenotes
Margin notes for asides, footnotes at the end of each section
A printed page can carry two kinds of
note at once: short asides in the margin and longer notes at the foot of the
page.Sidenotes are numbered 1, 2, 3 … by Tufte CSS’s counter.
This page does the same. Its front matter sets footnoteplacement: section, so
the real footnotes of each section are listed at the end of that
section.a
With the default
footnoteplacement: pageall footnotes are collected in one list at the end of the article. ↩︎
Notes in the margin#
A Markdown footnote becomes a sidenote by default.Written [^aside]: no prefix, so it follows the page’s mode (sidenotes). The sidenote
shortcode always does,Even on a page in endnotes mode.
and a margin note has no number at all.A margin note, from the marginnote shortcode.
Math works in every kind of note.For instance .
Notes below the text#
A label that starts with fn- keeps a Markdown footnote a real
footnote,b and the footnote shortcode always gives
one.c
Because the page also has numbered sidenotes, footnotes are marked with
letters (footnotestyle = "auto"), so the two sequences never look alike.
A footnote can be referenced twice;d both references link to the same item, and its backlinks return to each of them.d
A citation can go below the text as well. {{< cite keys="tufte2006" as="footnote" >}}
puts the full reference in a real footnote,e
while a plain cite keeps it in the margin.Edward R. Tufte. Beautiful Evidence. Graphics Press, LLC, first edition, May 2006. ISBN 0-9613921-7-7
The option citeas: footnote, in the front matter or under [params], does
this for every cite of the page (or of the site); a single cite then
returns to the margin with as="sidenote".
Written
[^fn-proof]. A real footnote can be long and hold several paragraphs, because the list below the section is block content.This is the second paragraph of the same footnote. ↩︎
Written as
{{< footnote >}}…{{< /footnote >}}. Inline Markdown, math such as and citations work inside it. ↩︎This footnote is referenced twice in the same sentence. ↩︎ ↩︎
Edward R. Tufte. Beautiful Evidence. Graphics Press, LLC, first edition, May 2006. ISBN 0-9613921-7-7 ↩︎
Choosing between them#
| Kind of note | Use |
|---|---|
| short aside, gloss, citation | sidenote: {{< sidenote >}} or [^x] |
| unnumbered remark, small figure | {{< marginnote >}}, {{< marginfigure >}} |
| proof, long digression, several paragraphs | footnote: {{< footnote >}} or [^fn-x] |
Tufte’s own books use only sidenotes, and tufte-latex turns LaTeX’s
\footnote into a sidenote.See the LaTeX to Hugo cheat sheet.
Real footnotes are for documents that also need the classic article
convention.
References
- Edward R. Tufte. Beautiful Evidence. Graphics Press, LLC, first edition, May 2006. ISBN 0-9613921-7-7.