Umstieg auf Glossaries-Package

.vscode/settings.json

@@ -1,51 +1,83 @@
 {
     "cSpell.words": [
-        "acro",
         "amssymb",
         "Autorreferat",
         "belowskip",
         "Bera",
         "biber",
+        "bspw",
+        "CALLGLO",
         "captionsetup",
         "cauthor",
+        "CEINR",
         "CFANCYFONTS",
+        "CHASABSTRACT",
         "citestyle",
+        "CKUSCHE",
+        "Computerphile",
         "csquotes",
+        "CTAN",
         "deckblatt",
         "defernumbers",
         "dhge",
         "dhgefigure",
+        "dhgeparagraph",
         "einkommentieren",
         "enumitem",
         "etoolbox",
         "euler",
         "fancyhdr",
         "fancyplain",
+        "footcite",
         "footmisc",
         "giveninits",
+        "glspl",
+        "graphicspath",
         "graphicx",
+        "Hahner",
         "hidelinks",
+        "hovern",
         "hyperfootnotes",
         "ibidtracker",
         "icomma",
         "ifthen",
+        "includegraphics",
+        "Kogel",
         "labelfont",
+        "latexmk",
         "literatur",
         "lmodern",
+        "longfigure",
+        "longnewglossaryentry",
+        "longplural",
         "mathrm",
         "minalphanames",
         "minbibnames",
+        "newacronym",
+        "newcommand",
+        "newglossaryentry",
         "ngerman",
         "Palatino",
         "pdfauthor",
+        "pdflatex",
+        "Plantuml",
+        "Prenote",
+        "Prillwitz",
+        "Pygments",
         "secnumdepth",
         "setspace",
+        "shortplural",
         "singlelinecheck",
+        "Stackoverflow",
+        "supercite",
+        "synctex",
+        "texstudio",
         "Thesenblatt",
         "titletoc",
         "tocdepth",
         "tocloft",
         "totcount",
+        "usepackage",
         "xparse",
         "xpatch"
     ]

.vscode/tex_snippets.code-snippets

@@ -9,19 +9,25 @@
     "Abkürzung": {
         "prefix": ["abk", "dhgeabk"], // auf welchem namen der snippet auffindbar ist
         "scope": "latex,tex", // welche files der snippet betreffen soll
-        "body": ["\\DeclareAcronym{${1:ac-used-name}}{",
-                "   short = {${2:abk}},",
-                "   long = {${3:non_abk}}",
-                "}"
+        "body": ["\\newacronym{${1:abk-id}}",
+                "    {${2:abk}}",
+                "    {${3:non_abk}}"
         ], // einzufügender snippet
-        "description": "Insert \\DeclareAcronym" // beschreibung
+        "description": "Insert \\newacronym" // beschreibung
     },
     "Abkürzung - singleline": {
         "prefix": ["singleabk", "singledhgeabk"], // auf welchem namen der snippet auffindbar ist
         "scope": "latex,tex", // welche files der snippet betreffen soll
-        "body": ["\\DeclareAcronym{${1:ac-used-name}}{short = {${2:abk}}, long = {${3:non_abk}}}"
+        "body": ["\\newacronym{${1:abk-id}}{{${2:abk}}{${3:non_abk}}}"
         ], // einzufügender snippet
         "description": "Insert singleline \\DeclareAcronym" // beschreibung
+    },
+        "Glossar": {
+        "prefix": ["gls", "dhgegls"], // auf welchem namen der snippet auffindbar ist
+        "scope": "latex,tex", // welche files der snippet betreffen soll
+        "body": ["\\newglossaryentry{${1:gls-id}}{name=${2:name}}{description=${3:desc}}"
+        ], // einzufügender snippet
+        "description": "Insert \\newglossaryentry" // beschreibung
     },
     // Im 'body' könne parameter verwendet werden, um bestimmte Ziele zu erreichen. (z.B. tabbing)
     // Nummern entsprechen Reihenfolge

README.md

@@ -26,7 +26,10 @@ Inoffizielles LaTeX-Template für Projektarbeiten für Technik-Studiengänge an
 - [Abbildungen](#abbildungen)
   - [LaTeX Abbildungen](#latex-abbildungen)
   - [dhge-latex Abbildungen](#dhge-latex-abbildungen)
-- [Abkürzungen](#abkürzungen)
+- [Abkürzungen und Glossar-Einträge](#abkürzungen-und-glossar-einträge)
+  - [Abkürzungen](#abkürzungen)
+  - [Glossar-Einträge](#glossar-einträge)
+  - [Weiterführende Dokumentation](#weiterführende-dokumentation)
 - [Anlagenverzeichnis](#anlagenverzeichnis)
   - [Verwendung](#verwendung)
     - [Longfigure](#longfigure)
@@ -38,6 +41,8 @@ Inoffizielles LaTeX-Template für Projektarbeiten für Technik-Studiengänge an
   - [Probleme im Kusche Mode](#probleme-im-kusche-mode)
 - [Abstract](#abstract)
 - [Absatztrenner](#absatztrenner)
+- [Troubleshooting](#troubleshooting)
+  - [Glossaries](#glossaries)
 
 # Installation
 
@@ -230,7 +235,7 @@ Beispiel:
 - Abbildungen werden durch das Template in `assets/img` gefunden.
   - `\includegraphics{<imgName>}` entspricht `\includegraphics{assets/img/<imgName>}`
   - anpassbar durch `\graphicspath {{<newImagePath>}}`
-    - **`<newImagePath>`** ist aus der sicht von `build/` zu sehen
+    - **`<newImagePath>`** ist aus der Sicht von `build/` zu sehen
     - `\graphicspath {{../assets/img/}}}`
 
 ## LaTeX Abbildungen
@@ -287,121 +292,125 @@ Beispiel:
 
 Der `dhgefigure` Befehl wird nun auch als Snippet für Visual-Studio-Code mitgeliefert.
 
-# Abkürzungen
+# Abkürzungen und Glossar-Einträge
+
+## Abkürzungen
 
 ```latex
-\DeclareAcronym{1}{
-  short = {2},
-  long = {3}
-  }
+\newacronym{key}{short}{long}
 ```
 
-1. ID der Abkürzung, damit wird im Fließtext später referenziert.
-2. Die Abkürzung selbst
-3. Der ausgeschriebene Begriff
+1. ``key``: ID der Abkürzung, damit wird im Fließtext später referenziert.
+2. ``short``: Die Abkürzung selbst
+3. ``long``: Der ausgeschriebene Begriff
 
 Beispielweise:
 
 ```latex
-\DeclareAcronym{dhge}{
-  short = {DHGE},
-  long = {Duale Hochschule Gera-Eisenach}
-}
+\newacronym{ac:dhge}{DHGE}{Duale Hochschule Gera-Eisenach}
 ```
 
 Im Fließtext wird dann mit
 
 ```latex
-\ac{dhge}
+\gls{ac:dhge}
 ```
 
 die Abkürzung aufgerufen.
 Dies sind die Pflicht-Argumente. Es gibt weitere Einstellungsmöglichkeiten bei dem Deklarieren von Abkürzungen, die in der unten stehenden Dokumentation nachgelesen werden können. Eine sinnvolle Auswahl davon:
 
 ```latex
-\DeclareAcronym{1}{
-  short = {2},
-  long = {3},
-  short-plural = {4},
-  long-plural = {5},
-  alt = {8}
-  }
+\newacronym [
+  longplural={1},
+  shortplural={2}
+] {3}{4}{5}
 ```
 
-ODER
+1. Die ausgeschriebene Pluralform
+2. Die Pluralform der Abkürzung
+3. ID der Abkürzung, damit wird im Fließtext später referenziert
+4. Die Abkürzung selbst
+5. Der ausgeschriebene Begriff
 
-```latex
-\DeclareAcronym{1}{
-  short = {2},
-  long = {3},
-  short-plural-form = {6},
-  long-plural-form = {7},
-  alt = {8}
-  }
-```
+Die Optionen 1 und 2 sind optional.
+Beachten Sie jedoch, dass die Optionen mit einem Komma getrennt sind.
 
-1. ID der Abkürzung, damit wird im Fließtext später referenziert.
-2. Die Abkürzung selbst
-3. Der ausgeschriebene Begriff
-4. Buchstabe oder Silbe, die der Abkürzung im Plural angehangen wird
-5. Buchstabe oder Silbe, die dem ausgeschriebenen Wort im Plural angehangen wird
-6. Plural-Form der Abkürzung, ersetzt die Abkürzung komplett
-7. Plural-Form des Wortes, ersetzt das Wort komplett
-8. Alternative zum ausgeschriebenen Wort
+An einem Beispiel:
 
-Die Angaben 4 bis 8 sind optional.
+```latex
+\newacronym [
+  longplural={Jacobi-Matrizen},
+  shortplural={JMs}
+] {ac:jm}{JM}{Jacobi-Matrix}
+```
 
 Die Pluralform lässt sich mit
 
 ```latex
-\acp{1}
+\glspl{key}
 ```
 
-aufrufen, die Alternativform mit
+aufrufen.
+Ebenso kann der erste Buchstabe einer Abkürzung groß geschrieben werden (wenn er in der Abkürzung selbst klein geschrieben ist): ``\Gls{key}``.
+Das ist kombinierbar mit ``\glspl{key}``, also:
 
 ```latex
-\aca{1}
+\Glspl{key}
 ```
 
-Beispiel:
+Das Abkürzungsverzeichnis wird dann automatisch erstellt. Dabei ist zu beachten, dass unter Umständen bis zu zwei Kompilierungen notwendig sind, wenn eine Abkürzung hinzugefügt oder entfernt wurde, damit das Verzeichnis korrekt erstellt wird.
+
+***
+
+Für das Erstellen von Abkürzungen wird ein Snippet für Visual-Studio-Code mitgeliefert: `abk` / `dhgeabk`.
+
+Für mehr Informationen kann die [Glossaries Package Documentation](https://ctan.org/pkg/glossaries?lang=de) gelesen werden.
+
+## Glossar-Einträge
+
+Glossar-Einträge verhalten sich ähnlich zu den eben vorgestellten Abkürzungen und werden ebenso mit ``\gls{key}`` oder möglichen Alternativ-Formen aufgerufen.
+
+Glossar-Einträge werden im einfachsten Falle wie folgt angelegt:
 
 ```latex
-\DeclareAcronym{jpg}{
-  short = {JPEG},
-  long = {Joint Photographic Experts Group},
-  short-plural-form = {JPEGs},
-  long-plural-form = {Joint Photographic Experts Groups},
-  alt = {JPG}
-  }
+\newglossaryentry{1}{
+  name={2},
+  description={3}
+}
 ```
 
-ODER
+1. ID des Eintrages, damit wird im Fließtext später referenziert
+2. Der Begriff, der im Glossar erklärt werden soll
+3. Die Erklärung des Begriffes
+
+Im Fließtext wird dann mit ``\gls{key}`` der Eintrag verknüpft, wobei der Begriff im Text erscheint.
+
+Sollte die Beschreibung des Begriffs allerdings **länger** als die verbleibende **Seitenbreite** sein, muss der Eintrag mit ``\longnewglossaryentry`` angelegt werden.
+Von den Optionen ändert sich dabei nichts.
+
+An einem Beispiel:
 
 ```latex
-\DeclareAcronym{jpg}{
-  short = {JPEG},
-  long = {Joint Photographic Experts Group},
-  short-plural = {s},
-  long-plural = {s},
-  alt = {JPG}
-  }
+\newglossaryentry{gls:ereignisanzeige}{
+    name={Ereignisanzeige},
+    description={Zentrale Schnittstelle für Logs auf Microsoft Windows Systemen}
+}
 ```
 
-Aufruf:
+Im Fließtext wird dann referenziert:
 
 ```latex
-\ac{jpg} % Normale Form
-\acp{jpg} % Plural-Form
-\aca{jpg} % Alternativ-Form
+[...]
+Eine entsprechende Fehlermeldung war \gls{gls:ereignisanzeige} zu sehen.
+[...]
 ```
+<!--ja ich weiß doch auch nicht, denk dir was besseres aus, LG ZPM :-)-->
 
-Das Abkürzungsverzeichnis wird dann automatisch erstellt. Dabei ist zu beachten, dass unter Umständen bis zu vier Kompilierungen notwendig sind, wenn eine Abkürzung hinzugefügt oder entfernt wurde, damit das Verzeichnis korrekt erstellt wird.
-
-***
+## Weiterführende Dokumentation
 
-Für das Erstellen von Abkürzungen wird nun auch ein Snippet für Visual-Studio-Code mitgeliefert: `abk` / `dhgeabk`.
+[Anfängerfreundliche Glossaries-Doku](https://ctan.mirror.norbert-ruehl.de/macros/latex/contrib/glossaries/glossariesbegin.pdf)
 
-Für mehr Informationen kann die [Acro Package Documentation](https://mirror.physik.tu-berlin.de/pub/CTAN/macros/latex/contrib/acro/acro-manual.pdf) gelesen werden.
+[Glossaries CTAN-Seite](https://www.ctan.org/pkg/glossaries)
 
 # Anlagenverzeichnis
 
@@ -449,7 +458,7 @@ Das ist besonders für Code-Beispiele für den Anhang praktisch.
 
 ***
 
-Bei Proxy-Problemen mit pip, kann auch das `Pygments.whl` file runtergeladen und dann mit pip installiert werden.
+Bei Proxy-Problemen mit pip, kann auch die `Pygments.whl` Datei heruntergeladen und dann mit pip installiert werden.
 [Pygments Download](https://pypi.org/project/Pygments/#files)
 
 # Spezielle Abschnitte
@@ -513,3 +522,12 @@ Der LaTeX Standard sind Einrückungen, Abstände sind aus beliebten WYSIWYG-Edit
 An der Studienrichtung Technik der DHGE werden Abstände in Arbeiten bevorzugt, weshalb das die Voreinstellung des Templates ist.
 
 Wenn Einrückungen bevorzugt werden, kann das in der ``config.tex`` geändert werden, indem der ``CEINR``-Schalter auf ``1`` gesetzt wird.
+
+# Troubleshooting
+
+## Glossaries
+
+- Symptom: das Glossar ist leer
+  - Prüfen Sie, ob Sie mit ``\gls`` auf mindestens ein Glossar-Eintrag verweisen oder ``CALLGLO`` in ``config.tex`` auf ``1`` gesetzt haben
+  - Wenn Sie kein ``latexmk`` verwenden, müssen Sie ggf. zwei mal kompilieren
+  - entfernen Sie den Projekt-Cache (``template.aux``, ``template.bbl``, ``template.bcf``, ``template.blg``, ...) und kompilieren Sie erneut (ggf. zwei mal)

abk.tex

@@ -1,9 +1,12 @@
-% Definieren Sie hier Ihre Abkürzungen anhand des DHGE Beispiels.
-% Wenn Sie DHGE dann im Text verwenden, rufen sie einfach \ac{dhge} auf.
+% Definieren Sie hier Ihre Abkürzungen und Glossar-Einträge anhand der Beispiele.
+% Wenn Sie diese dann im Text verwenden, rufen Sie einfach \gls{key} auf, z.B. \gls{ac:dhge}.
 % LaTeX kümmert sich um den Rest.
-% Für alles Weitere schauen Sie sich bitte die Dokumentation des Acro Packages an.
+% Wenn alle Abkürzungen auch ohne Verweis darauf generiert werden sollen, ist ein Schalter dafür in config.tex verfügbar.
+% Eine ausführliche, anfängerfreundliche Dokumentation ist unter https://www.overleaf.com/learn/latex/Glossaries abrufbar.
 
-\DeclareAcronym{dhge}{
-    short = {DHGE},
-    long = {Duale Hochschule Gera-Eisenach},
+\newglossaryentry{gls:gloss}{
+    name={Glossar},
+    description={Ein Glossar ist eine Liste von Wörtern mit beigefügten Bedeutungserklärungen oder Übersetzungen. (Wikipedia)}
 }
+
+\newacronym[]{ac:dhge}{DHGE}{Duale Hochschule Gera-Eisenach}

build/components/package.config.tex

@@ -4,7 +4,7 @@
 \usepackage[hyperfootnotes = false, hidelinks]{hyperref}
 \usepackage{amssymb}
 \usepackage{fancyhdr}
-\usepackage[version = 3]{acro}
+\usepackage[toc,nonumberlist,style=super]{glossaries}
 \usepackage{enumitem}
 \usepackage[style=german]{csquotes}
 \usepackage[backend=biber,