Acro LaTeX Paket

Das acro Paket (V3.3 2020/11/21) ist dafür gemacht, um Abkürzungen und Akronyme innerhalb eines Dokumentes zu setzen und diese dann in Form einer Liste, zum Beispiel ein Abkürzungsverzeichnis an einer bestimmten Stelle anzuzeigen. Der wesentliche Unterschied zu anderen Abkürzungsverzeichnispaketen ist wohl der, dass das arco Paket über eine interne automatische Sortierung für die Listen verfügt. Dadurch entfällt das manuelle Setzen einer sortierten Liste. Darüber hinaus enthält das Paket eine Vielzahl an zusätzlichen Funktionen, die es von den anderen Paketen für dieses Feld abhebt. Aufgrund des Umfangs der möglichen Funktionen wird hier nur auf die Basis Funktionen eingegangen.

acro einbinden

Das acro Paket wird mit \usepackage{acro} eingebunden. Das Paket selbst bindet wiederum die Pakete expl, xparse und l3keys2e ein. Die Optionen beziehen sich auf die Vorgänger Version 2, und die damit zuhängenden Unterschiede bei den genutzten Befehlen. Sie sind für den Fall interessant, wenn ein bereits bestehendes älteres Dokument überarbeitet wird.

version Hat den Wert 3 und kann auf den Wert 2 gesetzt werden. Damit können noch die inzwischen veralteten Befehle weiter genutzt werden und das bestehende Dokument muss nicht geändert werden.

upgrade Die Upgradeoption hat per Default den Wert true, und liefert Hinweise darauf, welche Befehle überarbeitet beziehungsweise geändert werden müssen.

Abkürzungen erstellen

Die Abkürzungen beziehungsweise die Akronyme werden mithilfe des \DeclareAcronym Befehls definiert. Die Definition erfolgt in der Präambel, also noch vor \begin{document}. Es ist auch möglich und im Allgemeinen auch sinnvoll, die Definitionen in einer Separaten Tex Datei auszulagern und diese Datei dann per \input nach dem acro Paket und vor\begin{document} in das Dokument einzubinden.

\DeclareAcronym{ecu}{
short = ECU ,
long = European currency unit ,
short-plural = s ,
long-plural = s ,
sort = Europeancurrencyunit
}

Das Kürzel (ID) dient im Dokument zum Aufrufen der Abkürzung.

short definiert die Kurzschreibweise
long die ausgeschrieben Langform
Bei short-plural und long-plural handelt es sich um die Pluralendungen.
sort wird für die spätere Sortierung genutzt. Im Fall, dass sort nicht gesetzt wurde, wird anhand des Kürzels (ID) sortiert.

Abkürzungen und Akronyme aufrufen

Mit den nachfolgenden Befehlen kann die Abkürzung beziehungsweise das Akronym im Text aufgerufen werden.

\ac{Kuerzel} wird der Befehl \ac{Kuerzel} das erste Mal verwendet, erhält man die Langform des Ausdrucks und zusätzlich die geklammerte Kurzform. Wird der Befehl danach wieder mit dem gleichen Kürzel, erhält man die Kurzform dann aber ohne Klammern.
\acl{Kuerzel} schreibt die Langform des Ausdrucks.
\acs{Kuerzel} schreibt die Kurzform.
\aclp{Kuerzel} schreibt die Langform des Plurals des Ausdrucks.
\acsp{Kuerzel}schreibt die Kurzform des Plurals.
\acf{Kuerzel} verhält sich wie \ac{Kuerzel} Befehl, wenn er das erste Mal aufgerufen wurde. Unabhängig davon, wie oft das Kürzel bereits aufgerufen wurde, wird bei der Verwendung von \acf{Kuerzel} die ausgeschriebene Langform des Ausdrucks und die geklammerte Abkürzung gesetzt.

Abkürzungsverzeichnis einfügen

Mit dem Befehl \printacronyms wird an der gewünschten Stelle das Abkürzungsverzeichnis gesetzt.

Hinweise

Komma in der Abkürzung

Für den Fall, dass die Abkürzung selbst ein oder mehrere Kommata enthält, erhält man bei normalen Vorgehen eine Fehlermeldung, da die Kommata zum Trennen der Einträge innerhalb des \DeclareAcronym Befehls verwendet werden. Eine mögliche Lösung ist das zusätzliche Klammern mit geschweiften Klammern der Abkürzung, wie im nachfolgenden Beispiel gezeigt.

\DeclareAcronym{pdca}{
short = 2{,}4-PDCA,
long = 2{,}4-Pyridinedicarboxylic Acid (hydrate),
class = chem
}

Umbennen des Verzeichnis

Der Name des Verzeichnisses lässt sich über die Option des \printacronyms Befehl verändern.

\printacronyms[name=Acronyms]

Versionsunterschiede beim Erstellen des Verzeichnisses

Zwischen der Version 2.x und 3.x gibt es für den Fall, dass verschiedene Verzeichnisse, zum Beispiel ein Abkürzungsverzeichnis und ein Akronymverzeichnis, erstellt werden sollen unterschiedliche Lösungen.

Mit Version 2.3

\documentclass{article}
\usepackage[utf8]{inputenc}
%...
\usepackage{acro}
\DeclareAcronym{eg}{
short = e.g,
long = for example,
class = abbrev}

\DeclareAcronym{ASAP}{
short = ASAP,
long = as soon as possible,
class = acronym}

%...
\begin{document}
%...
\printacronyms[name=Abbreviations, include-classes=abbrev]
\printacronyms[name=Acronyms, include-classes=acronym]
%...
\ac{ASAP} and \ac{eg}
\end{document}

Mit Version 3.3

\documentclass{article}
\usepackage[utf8]{inputenc}
%...
\usepackage{acro}
\DeclareAcronym{eg}{
short = e.g,
long = for example,
tag = abbrev}

\DeclareAcronym{ASAP}{
short = ASAP,
long = as soon as possible,
tag = acronym}

%...
\begin{document}
%...
\printacronyms[name=Abbreviations, include=abbrev]
\printacronyms[name=Acronyms, include=acronym]
%...
\ac{ASAP} and \ac{eg}
\end{document}

Innerhalb der umfangreichen Dokumentation befinden sich noch viele weitere Funktionen und Einstellungen.

Literatur

ACRO, V3.3, 21/11/2020, Typeset Acronyms and other Abbreviations, Clemens NIEDERBERGER
Abgerufen unter https://ctan.org/pkg/acro am 11.12.2020