Fußnoten, Randnotizen und Codeformatierung

Fußnoten ergänzen Informationen, ohne den Haupttext zu unterbrechen; Randnotizen bieten kurze Hinweise. Code sollte je nach Länge als nichtproportionaler Text im Satz, wörtlicher Text oder hervorgehobener Block erscheinen. Setzen Sie alle drei sparsam ein.

EasyLaTeX-Compilereinstellung: pdfLaTeX, für Deutsch mit T1, Latin Modern und babel mit ngerman. Randnotizen verwenden marginnote, Codeblöcke listings. Letzteres eignet sich für die hiesigen ASCII-Beispiele, unterstützt Unicode aber nur begrenzt. Wählen Sie für mehrsprachigen Code eine geeignete Verbatim- oder Hervorhebungskonfiguration mit einer Unicode-fähigen Engine.

Fußnoten hinzufügen#

Verwenden Sie \footnote{...} an der erklärungsbedürftigen Stelle:

1Dieser Begriff folgt der branchenüblichen Definition\footnote{Der Wortlaut kann sich zwischen Normen leicht unterscheiden.}.

LaTeX nummeriert Fußnoten und setzt sie an den Seitenfuß. Nutzen Sie sie für Quellen, Ausnahmen oder kurze Erklärungen, statt einen neuen ausführlichen Argumentationsgang darin unterzubringen.

Fußnotenzeichen und Text trennen#

Wo eine gewöhnliche Fußnote nicht unmittelbar funktioniert, etwa in manchen Tabellen- oder Überschriftenkontexten, trennen Sie Zeichen und Text:

1Tabellenbeschriftung\footnotemark2...3\footnotetext{Diese Daten wurden gerundet.}

Halten Sie beides auf derselben Seite nahe beieinander und ordnen Sie die Paare der Reihe nach zu. Folgen Sie bei komplexen Tabellenfußnoten der Vorlage oder verwenden Sie eine tabellenspezifische Lösung.

Randnotizen#

LaTeX bietet \marginpar; \marginnote eignet sich für kurze Anmerkungen an der aktuellen Position:

1\usepackage{marginnote}2​3Diese Schlussfolgerung muss geprüft werden.\marginnote{Quelle erforderlich}

Randnotizen benötigen Randfläche. Bei beidseitigen Dokumenten ist zu beachten, auf welcher Seite sie stehen. Halten Sie sie kurz, damit sie nicht mit Kopfzeilen, Fußnoten oder anderen Notizen kollidieren.

Code im Fließtext#

Verwenden Sie \texttt für kurze Befehle, Dateinamen und Variablen:

1Die Hauptdatei heißt normalerweise \texttt{main.tex}.

Für wörtlichen Inhalt ohne das gewählte Begrenzungszeichen dient \verb|...|:

1\verb|\section{Überschrift}|

\verb kann nicht in Befehlsargumenten wie Abschnittsüberschriften, Beschriftungen oder gewöhnlichen Fußnoten verwendet werden. Nutzen Sie dort maskierten Text mit \texttt oder einen geeigneten Paketbefehl.

Codeblöcke#

Für kurze wörtliche Textstücke dient verbatim:

1\begin{verbatim}2main.tex3figures/result.pdf4\end{verbatim}

Für Nummerierung, Zeilenumbruch oder Syntaxhervorhebung verwenden Sie listings:

1\usepackage{listings}2\usepackage{xcolor}3\lstset{4  basicstyle=\ttfamily\small,5  frame=single,6  breaklines=true7}8​9\begin{lstlisting}[language=Python]10total = sum(values)11print(total)12\end{lstlisting}

Erhalten Sie Einrückungen und erläutern Sie Eingaben, Ausgaben oder Zweck des Blocks, statt ein unerklärtes Fragment zu zeigen.

Häufige Probleme#

Fußnoten rutschen auf die nächste Seite#

Ursache kann Platzmangel sein. Kürzen Sie die Notiz, strukturieren Sie den Haupttext um oder verschieben Sie den zugehörigen Satz auf die nächste Seite. Erzwingen Sie die Rückverschiebung nicht mit großen negativen Abständen.

Randnotizen überlappen#

Kürzen Sie sie, verringern Sie ihre Anzahl je Seite oder verwenden Sie Fußnoten. Randnotizen eignen sich weder für dichte Kommentierung noch für wesentlichen Haupttext.

Nicht-ASCII-Text erscheint in listings fehlerhaft#

listings unterstützt Unicode nur begrenzt. Beschränken Sie es auf unterstützten Code oder verwenden Sie eine Unicode-fähige Verbatim- oder Hervorhebungslösung, die bereits in der Projektvorlage konfiguriert ist.

Vollständiges Beispiel#

1\documentclass[a4paper,12pt]{article}2\usepackage[T1]{fontenc}3\usepackage{lmodern}4\usepackage[ngerman]{babel}5\usepackage{marginnote}6\usepackage{listings}7\usepackage{xcolor}8\lstset{basicstyle=\ttfamily\small, frame=single, breaklines=true}9​10\begin{document}11​12Verwenden Sie \texttt{main.tex} als Hauptdatei\footnote{Der einzige Einstiegspunkt zur Erstellung des Projekts.}.13\marginnote{Vor dem Kompilieren die Engine prüfen}14​15\begin{lstlisting}[language=Python]16total = sum(values)17print(total)18\end{lstlisting}19​20\end{document}