Product Logo
Tools & Services

Mehrsprachigkeit einrichten

Deine Webseite kann Inhalte in beliebigen Sprachen anbieten. Eingebaute UI-Texte (Suchfeld, Inhaltsverzeichnis, Callouts …) liefert DWT für Deutsch und Englisch. Eigene UI-Texte für weitere Sprachen lassen sich im Developer Mode ergänzen — siehe UI-Übersetzungen.

Voraussetzungen

Einrichtung

Wähle deinen Modus — der jeweilige Tab enthält die vollständige Anleitung. Du musst nicht zwischen den Modi wechseln.

Mehrsprachigkeit aktivieren

Lege pro Sprache einen Unterordner im dokument-Ordner an. Jede Sprache hat ihre eigene abbreviations.yaml:

dokument/
├── de/
│   ├── _meta.yaml
│   ├── abbreviations.yaml
│   └── index.mdx
└── en/
    ├── _meta.yaml
    ├── abbreviations.yaml
    └── index.mdx

Ergänze in der .gitlab-ci.yml die Mehrsprachigkeits-Inputs:

Parameter:

  • multi-language-locales (string): Kommagetrennte Liste der Sprachen (z. B. "de,en", "de,en,fr").
  • multi-language-default-locale (string): Sprache, auf die bei Aufruf ohne Sprachpräfix weitergeleitet wird. Default: de.

Den Root-Redirect (/ → Standardsprache) und die i18n-Konfiguration erzeugt die CI-Komponente automatisch.

Eine weitere Sprache hinzufügen (Beispiel: Französisch)

  1. Locale ergänzen in multi-language-locales:
  2. Seitenordner anlegen und Inhalte übersetzen: dokument/fr/ mit index.mdx, _meta.yaml usw.
  3. Abkürzungen pro Sprache in dokument/fr/abbreviations.yaml — Format siehe abbreviations.yaml Format.

Standardsprache in einem Einzelsprachen-Projekt setzen

Ohne konfigurierte Mehrsprachigkeit ist die Standardsprache Deutsch. Für eine andere eingebaute Sprache (z. B. Englisch) setzt du die Eingabe default-locale:

Der Wert steuert sowohl das lang-Attribut im HTML als auch die Sprache der eingebauten UI-Texte. In mehrsprachigen Projekten (mit multi-language-locales) wird die Eingabe ignoriert.

Ergebnis

Nach der nächsten erfolgreichen Pipeline (Easy Mode) bzw. dem nächsten Build (Developer Mode) siehst du:

  • einen Sprachumschalter in der Navigation,
  • pro Sprache eigene Inhalte unter /{locale}/,
  • pro Sprache eine automatisch erzeugte Glossar-Seite (/de/glossar, /en/glossar, …).

Per-Locale-Abkürzungen und Glossar

In mehrsprachigen Projekten legt jede Sprache ihre eigene abbreviations.yaml im Sprachordner an. DWT erzeugt daraus pro Sprache automatisch eine Glossar-Seite (/de/glossar, /en/glossar, …).

Nächste Schritte