\roman

\roman ist eine LaTeX-Kern-Anweisung zur Ausgabe eines LaTeX-Zählers als kleine römische Zahl.

Verwendung

Syntax

\roman{Zähler}

Parameter

{Zähler}

Zähler ist ein mit \newcounter definierter LaTeX-Zähler, beispielsweise page, part, section etc.

Beschreibung

Der Wert des angegebenen LaTeX-Zählers wird unabhängig von seiner Standard-Darstellung \theZähler als römische Zahl ausgeben, wobei die Kleinbuchstaben i, x, v etc. verwendet werden. Dies gelingt zwar für alle Zahlen > 0, allerdings wird die Ausgabe für sehr große Zahlen (etwa > 4999) eher unbrauchbar. Da die Römer weder negative Zahlen noch die 0 kannten, wird für Werte < 1 nichts ausgegeben.

Ein häufiger Anwenderfehler besteht darin, als Argument von \roman nicht einen LaTeX-Zähler, sondern beispielsweise direkt eine Zahl anzugeben. Dies führt jedoch zu einer Fehlermeldung. Für diesen Zweck könnte jedoch die TeX-Low-Level-Anweisung \romannumeral verwendet werden.

Fehlermeldungen

Missing number, treated as zero.

Diese eher verwirrende Fehlermeldung zeigt an, dass das Argument von \roman kein gültiger LaTeX-Zähler war.

Beispiele

\documentclass{article}
\usepackage{blindtext]
\renewcommand*{\thesection}{\roman{section}}
\begin{document}
\section{Test}
\blindtext
\end{document}

Hier wird die Standard-Darstellung des Zählers section, \thesection, in die Ausgabe einer kleinen römischen Zahl geändert. Dadurch wird dann der Abschnitt »Test« mit der Nummer »i« versehen.

Verwandte Befehle

\Alph, \alph, \arabic, \Roman, \value, \newcounter, \theZähler, \fnsymbol, \romannumeral

Verweise

Die Anweisung \roman ist in den LaTeX-Quellen in Datei ltcounts.dtx definiert und in source2e.pdf dokumentiert.