Recent changes to HowTo_ToCDynNumWidthIndent

HowTo_ToCDynNumWidthIndent modified by Markus Kohm

Markus Kohm — Wed, 06 Aug 2025 07:54:42 -0000

--- v6
+++ v7
@@ -120,3 +120,5 @@
 \subsection{Second Subsection}
 \end{document}
 ```
+
+Selbstverständlich kann man `\DeclareTOCStyleEntry` auch beispielsweise auf Tabellen- oder Abbildungseinträge in die jeweiligen Verzeichnisse anwenden.

HowTo_ToCDynNumWidthIndent modified by Markus Kohm

Markus Kohm — Wed, 28 Jul 2021 09:14:47 -0000

HowTo_ToCDynNumWidthIndent modified by Markus Kohm

Markus Kohm — Wed, 28 Jul 2021 09:11:00 -0000

--- v4
+++ v5
@@ -99,4 +99,24 @@
 \subsection{Second Subsection}
 \end{document}
 ```
-Auch so sind relativ schnell, ansprechende Ergebnisse zu erzielen. Diese Methode funktioniert darüber hinaus auch bereits ab [KOMA-Script 3.27](https://komascript.de/release3.27).
+Auch so sind relativ schnell, ansprechende Ergebnisse zu erzielen. Diese Methode funktioniert darüber hinaus auch bereits ab [KOMA-Script 3.27](https://komascript.de/release3.27). Allerdings wird dabei eine Möglichkeit von KOMA-Script ausgenutzt, die ausdrücklich nicht dokumentiert ist. Korrekt müsste man hier also eigentlich auf `\DeclareTOCStyleEntry` und `\DeclareTOCStyleEntries` zurückgreifen:
+```latex
+\documentclass{scrbook}
+\usepackage{blindtext}
+\DeclareTOCStyleEntry[numwidth+=8pt]{chapter}{chapter}
+\DeclareTOCStyleEntries[indent+=8pt]{section}{section,subsection}
+\DeclareTOCStyleEntry[numwidth+=4pt]{section}{section}
+\DeclareTOCStyleEntry[indent+=4pt]{section}{subsection}
+\DeclareTOCStyleEntry[numwidth+=3pt]{section}{subsection}
+\begin{document}
+\tableofcontents
+\chapter{First Chapter}
+\section{First Section}
+\subsection{First Subsection}
+
+\setcounter{chapter}{99}
+\chapter{Second Chapter}
+\section{Second Section}
+\subsection{Second Subsection}
+\end{document}
+```

HowTo_ToCDynNumWidthIndent modified by Markus Kohm

Markus Kohm — Mon, 26 Jul 2021 07:18:57 -0000

--- v3
+++ v4
@@ -76,7 +76,7 @@
 ```
 Die Angaben für `indent` und `numwidth` sind hier notwendig, weil ansonsten die voreingestellten Werte als Mindestwert für einen höheren Einzug sorgen.

-Manche Anwender:innen mögen sich nun fragen, warum im Text immer von `indent`, `dynindent`, `numwidth` und `dynnumwidth` die Rede ist, in den Beispielen aber `tocindent`, `tocdynindent`, `tocnumwidth` und `tocdynnumwidth` verwendet werden. Das liegt am Unterschied zwischen den Eigenschaften des Verzeichniseintragsstils `tocline` und den korrespondierenden Optionen für `\RedeclareSectionCommand`, der auch in der [KOMA-Script-Anleitung](http://mirrors.ctan.org/macros/latex/contrib/koma-script/doc/scrguide.pdf) und im [KOMA-Script-Buch](https://komascript.de/komascriptbuch) erklärt ist. Bei Verwendung von `\DeclareTOCStyleEntry` oder `\DeclareTOCStyleEntries` wären direkt die Eigenschaften als Optionen anzugeben, also ohne den Präfix `toc`.
+Manche Anwender:innen mögen sich nun fragen, warum im Text immer von `indent`, `dynindent`, `numwidth` und `dynnumwidth` die Rede ist, in den Beispielen aber `tocindent`, `tocdynindent`, `tocnumwidth` und `tocdynnumwidth` verwendet werden. Das liegt am Unterschied zwischen den Eigenschaften des Verzeichniseintragsstils `tocline` und den korrespondierenden Optionen für `\RedeclareSectionCommand`, der auch in der [KOMA-Script-Anleitung](wiki-de:HowTo_Manual) und im [KOMA-Script-Buch](https://komascript.de/komascriptbuch) erklärt ist. Bei Verwendung von `\DeclareTOCStyleEntry` oder `\DeclareTOCStyleEntries` wären direkt die Eigenschaften als Optionen anzugeben, also ohne den Präfix `toc`.

 Statt die ganzen Breiten und Einzüge automatisch bestimmen zu lassen, gibt es übrigens auch die Möglichkeit, manuell zu den vorhandenen Werten einen Wert zu addieren:
 ```LaTeX

HowTo_ToCDynNumWidthIndent modified by Markus Kohm

Markus Kohm — Sat, 17 Jul 2021 14:09:12 -0000

HowTo_ToCDynNumWidthIndent modified by Markus Kohm

Markus Kohm — Tue, 27 Apr 2021 18:12:43 -0000

Wie die Einzüge im Inhaltsverzeichnis an die tatsächliche Breite der Nummern anpassen werden können modified by Markus Kohm

Markus Kohm — Tue, 27 Apr 2021 18:11:52 -0000

Wie die Einzüge im Inhaltsverzeichnis an die tatsächliche Breite der Nummern anpassen werden können

In der Voreinstellung erzeugen die KOMA-Script-Klassen ein Inhaltsverzeichnis, bei dem die einzelnen Ebenen entsprechend ihrer Hierarchie eingezogen sind. Teile und Kapitel werden bei scrbook und scrreprt linksbündig gesetzt, wobei für die Nummern eine feste Breite reserviert ist. Abschnitte werden um die Breite eingezogen, die für die Kapitelnummern reserviert ist. Auch hier wird für die Nummern wieder eine feste Breite reserviert. Unterabschnitte werden bis hinter die Nummernbreite für Abschnitte eingezogen. Auch für deren Nummern ist eine feste Breite reserviert. Es ergibt sich ein Bild mit vertikalen Fluchtlinien sowohl links von Nummern als auch links von den Texten, wobei die Fluchtlinie links von der Nummer der untergeordneten Ebene jeweils mit der Fluchtlinie links des Textes der aktuellen Ebene übereinstimmt.

Bei der Klasse scrartcl tritt die Abschnittebene an Stelle der Kapitelebene.

Teilweise sind die fest vorgegebenen Breiten jedoch zu gering oder auch zu groß, um ein ausgewogenes Bild zu ergeben. Für diesen Fall bieten die Klassen selbst die Option toc=flat. Dabei erfolgt kein hierarchischer Einzug mehr und gleichzeitig wird die Breite für die nun gemeinsame Nummernspalte durch die größte tatsächlich benötigten Breite aller Gliederungsnummern im Inhaltsverzeichnis bestimmt. Hierfür werden mehrere LaTeX-Läufe benötigt.

Darüber hinaus gibt es aber auch die Möglichkeit, für jede einzelne Ebene über die Eigenschaft dynnumwidth des Verzeichniseintragsstils tocline lediglich die Breite, die für die Nummer dieser Ebene benötigt wird, automatisch ermitteln zu lassen. Setzt man diese Eigenschaft für alle Ebenen (bzw. für alle nummerierten Ebenen):

\documentclass{scrbook}
\usepackage{blindtext}
\RedeclareSectionCommands[tocdynnumwidth]{chapter,section,subsection}
\begin{document}
\tableofcontents
\chapter{First Chapter}
\section{First Section}
\subsection{First Subsection}
\subsubsection{First Subsubsection}

\setcounter{chapter}{99}
\chapter{Second Chapter}
\setcounter{section}{99}
\section{Second Section}
\setcounter{subsection}{99}
\subsection{Second Subsection}
\setcounter{subsubsection}{99}
\subsubsection{Second Subsubsection}
\end{document}

so sind zwar die Abstände zwischen Gliederungsnummer und Text nach drei LaTeX-Läufen jeweils eingehalten, aber die Einzüge der untergeordneten Ebenen orientieren sich nicht mehr an den Einzügen und Nummernbreiten ihrer übergeordneten Ebene, sondern sind weiterhin fest vorgegeben. Dadurch verdoppelt sich die Anzahl der Fluchlinien.

Es sei an dieser Stelle explizit erwähnt, dass eine solche Darstellung nicht grundsätzlich falsch ist. Außerdem ist das gezeigte Beispiel mit dem Wechsel zwischen einstelligen Zahlen auf allen Ebenen hin zu dreistelligen Zahlen auf allen Ebenen natürlich realitätsfremd. Normalerweise sind die Übergänge weniger krass. Beide Extreme können jedoch auftreten.

Vielfach wünschen Anwender:innen, dass bei dieser hierarchischen Darstellung nicht nur der benötigte Platz für die Nummern, sondern auch die Einzüge davon abhängend automatisch bestimmt werden. Ab KOMA-Script 3.31 wird dies mit der neuen Eigenschaft dynindent unterstützt:

\documentclass{scrbook}
\usepackage{blindtext}
\RedeclareSectionCommands[tocdynnumwidth,tocdynindent]{chapter,section,subsection}
\begin{document}
\tableofcontents
\chapter{First Chapter}
\section{First Section}
\subsection{First Subsection}
\subsubsection{First Subsubsection}

\setcounter{chapter}{99}
\chapter{Second Chapter}
\setcounter{section}{99}
\section{Second Section}
\setcounter{subsection}{99}
\subsection{Second Subsection}
\setcounter{subsubsection}{99}
\subsubsection{Second Subsubsection}

\end{document}

Hiermit ergibt sich wieder die gewohnte hierarchisch eingezogene Darstellung jedoch mit automatisch angepassten Einzügen und Nummernbreiten.

Der gezeigte Automatismus hängt jedoch davon ab, dass die Ebenen auch in der gewohnten Weise verwendet werden. Lässt man eine Ebene aus, so versagt der Mechanismus, weil in der Voreinstellung für den Einzug einer untergeordneten Ebene nur der Einzug und die Nummernbreite ihres direkten Vorgängers herangezogen wird. Wird nun eine Ebene übersprungen werden stattdessen die statisch vorbestimmten Werte verwendet, bis dynamisch ermittelte Werte vorliegen. Spätestens bei Verwendung dieser Methode wird daher nicht empfohlen, Ebenen zu überspringen. Es ist aber auch möglich, manuell vorzugeben, welcher Ebene eine andere Ebene folgen soll:

\documentclass{scrbook}
\usepackage{blindtext}
\RedeclareSectionCommand[tocindentfollows=chapter,tocindent=0pt,tocnumwidth=0pt]{subsection}
\RedeclareSectionCommands[tocdynnumwidth,tocdynindent]{chapter,subsection}
\begin{document}
\tableofcontents
\chapter{First Chapter}
\subsection{First Subsection}

\setcounter{chapter}{99}
\chapter{Second Chapter}
\setcounter{subsection}{99}
\subsection{Second Subsection}
\end{document}

Die Angaben für indent und numwidth sind hier notwendig, weil ansonsten die voreingestellten Werte als Mindestwert für einen höheren Einzug sorgen.

Manche Anwender:innen mögen sich nun fragen, warum im Text immer von indent, dynindent, numwidth und dynnumwidth die Rede ist, in den Beispielen aber tocindent, tocdynindent, tocnumwidth und tocdynnumwidth verwendet werden. Das liegt am Unterschied zwischen den Eigenschaften des Verzeichniseintragsstils tocline und den korrespondierenden Optionen für \RedeclareSectionCommand, der auch in der KOMA-Script-Anleitung und im KOMA-Script-Buch erklärt ist. Bei Verwendung von \DeclareTOCStyleEntry oder \DeclareTOCStyleEntries wären direkt die Eigenschaften als Optionen anzugeben, also ohne den Präfix toc.

Statt die ganzen Breiten und Einzüge automatisch bestimmen zu lassen, gibt es übrigens auch die Möglichkeit, manuell zu den vorhandenen Werten einen Wert zu addieren:

\documentclass{scrbook}
\usepackage{blindtext}
\RedeclareSectionCommand[tocnumwidth+=8pt]{chapter}
\RedeclareSectionCommands[tocindent+=8pt]{section,subsection}
\RedeclareSectionCommand[tocnumwidth+=4pt]{section}
\RedeclareSectionCommand[tocindent+=4pt]{subsection}
\RedeclareSectionCommand[tocnumwidth+=3pt]{subsection}
\begin{document}
\tableofcontents
\chapter{First Chapter}
\section{First Section}
\subsection{First Subsection}

\setcounter{chapter}{99}
\chapter{Second Chapter}
\section{Second Section}
\subsection{Second Subsection}
\end{document}

Auch so sind relativ schnell, ansprechende Ergebnisse zu erzielen. Diese Methode funktioniert darüber hinaus auch bereits ab KOMA-Script 3.27.