Glossar und Abkürzungen konfigurieren
So richtest du das Glossar und die automatische Abkürzungserkennung für deine easyWebsite ein.
Funktionsweise
Begriffe, die in der abbreviations.yaml (oder den Legacy-Dateien glossar.yaml / abkuerzungen.yaml) definiert sind, werden automatisch in deinen Texten erkannt und hervorgehoben. Beim Hovern erscheint ein Tooltip mit der Definition.
abbreviations.yaml anlegen
Erstelle eine abbreviations.yaml im Root deines dokument-Ordners:
Felder
| Feld | Required | Beschreibung |
|---|---|---|
value | ja | Definition des Begriffs |
variants | nein | Alternative Schreibweisen, die ebenfalls erkannt werden (z. B. Pluralformen) |
type | nein | glossary oder leer. Wird von der CI/LaTeX-Pipeline genutzt, von DWT ignoriert. |
Legacy-Format
Das alte Format mit glossar.yaml und abkuerzungen.yaml wird weiterhin unterstützt:
Für neue Projekte empfehlen wir das einheitliche abbreviations.yaml-Format mit Variants-Unterstützung.
Mehrsprachige Abkürzungen
Bei mehrsprachigen Projekten legst du pro Sprache eine eigene Datei im jeweiligen Sprachordner an:
dokument/
├── de/
│ └── abbreviations.yaml
└── en/
└── abbreviations.yaml
Jede Datei enthält die Begriffe in der jeweiligen Sprache. DWT erzeugt daraus pro Sprache automatisch eine Glossar-Seite (/de/glossar, /en/glossar, …).
Siehe auch: How-to: Mehrsprachigkeit einrichten und abbreviations.yaml Format.
Glossar-Seite im Menü ausblenden
Easy Mode
Developer Mode
Die Glossar-Seite wird automatisch aus den definierten Begriffen generiert. Mit --hide-glossary-page-in-menu bzw. dem entsprechenden CI-Input bleibt sie erreichbar, erscheint aber nicht in der Navigation.