Seminar Docusaurus – Internationalisierung und Übersetzungsworkflows

Inhaltsübersicht

1. Zielsetzung
2. Schritt 1: Sprachstrategie und Geltungsbereich definieren
3. Schritt 2: i18n-Konfiguration einrichten
4. Schritt 3: Oberflächentexte extrahieren und pflegen
5. Schritt 4: Dokumente, Seiten und Blog lokalisieren
6. Schritt 5: Navigation und Locale-Auswahl konfigurieren
7. Schritt 6: Versionierung mit Übersetzungen koordinieren
8. Schritt 7: Build und Deployment je Locale planen
9. Schritt 8: Übersetzungsqualität und Governance etablieren
10. Praxisphasen
11. Zielgruppe und Voraussetzungen

Zielsetzung

Das Seminar baut eine mehrsprachige Docusaurus-Site mit nachvollziehbarer Locale-Strategie und wartbarem Übersetzungsprozess auf. Konfiguration, Oberflächentexte, Dokumente, Seiten, Blog, Routing, Deployment, Versionskopplung, Qualität und Fallback-Regeln werden praktisch behandelt.

• eine belastbare Locale- und Veröffentlichungsstrategie für Docusaurus festlegen
• Oberfläche und Content-Plugins vollständig lokalisieren
• Übersetzungsstände, Versionen und Freigaben transparent koordinieren
• sprachspezifische Builds, Pfade und Qualitätsprüfungen automatisieren

Seminarinhalte

Schritt 1: Sprachstrategie und Geltungsbereich definieren

Zielmärkte, Pflichtsprachen, Übersetzungsumfang und Aktualitätsziele werden festgelegt. Es wird entschieden, welche Inhalte vollständig, teilweise oder gar nicht lokalisiert werden.

• Standardsprache und unterstützte Locales bestimmen
• Übersetzungspriorität je Inhaltstyp festlegen
• Freigabe- und Aktualitätsziele vereinbaren

Schritt 2: i18n-Konfiguration einrichten

Standard-Locale, Locale-Liste, Bezeichnungen, Schreibrichtung und Pfadverhalten werden in der Site-Konfiguration eingerichtet. Sprachwahl und Browser-Sprache werden bewusst von redaktionellen Freigaben getrennt.

• Locale-Konfiguration typisiert anlegen
• sprachspezifische Labels und HTML-Sprachen setzen
• Pfad- und Domainmodell prüfen

Schritt 3: Oberflächentexte extrahieren und pflegen

Theme- und Plugin-Texte werden in Übersetzungsdateien geschrieben und mit stabilen Schlüsseln verwaltet. Änderungen an der Standardsprache erhalten einen geregelten Abgleich mit vorhandenen Übersetzungen.

• Übersetzungsdateien erzeugen
• Schlüssel, Kontext und Platzhalter kontrollieren
• fehlende oder veraltete Übersetzungen sichtbar machen

Schritt 4: Dokumente, Seiten und Blog lokalisieren

Content-Plugin-Inhalte werden in der vorgesehenen Locale-Struktur abgelegt. IDs und Slugs bleiben bewusst stabil oder werden nach klaren Regeln lokalisiert, damit Navigation und Querverweise funktionieren.

• Dokumente und Assets sprachspezifisch zuordnen
• Seiten und Blogbeiträge lokalisieren
• relative Links und gemeinsame Ressourcen prüfen

Schritt 5: Navigation und Locale-Auswahl konfigurieren

Navbar, Footer, Sidebars und Locale-Umschaltung werden in allen Sprachen getestet. Fehlende Zielseiten dürfen nicht zu irreführenden Sprachwechseln oder unklaren Mischzuständen führen.

• Locale-Dropdown und Labels konfigurieren
• sprachspezifische Navigation prüfen
• Fallback-Verhalten für fehlende Seiten definieren

Schritt 6: Versionierung mit Übersetzungen koordinieren

Produktversionen und Übersetzungsstände werden als getrennte Dimensionen behandelt. Snapshot-Zeitpunkt, Nachübersetzung und Pflege älterer Versionen erhalten klare Regeln.

• Versionierungs- und Übersetzungsrhythmus abstimmen
• Priorität für aktuelle und ältere Versionen festlegen
• eingefrorene Inhalte und Korrekturen behandeln

Schritt 7: Build und Deployment je Locale planen

Alle Sprachen können gemeinsam oder separat gebaut und ausgeliefert werden. Cache, Artefaktgröße, Pfade und Freigaben werden so gestaltet, dass keine unvollständige Locale versehentlich produktiv wird.

• gemeinsamen und separaten Locale-Build vergleichen
• Artefakte und Deployment-Pfade definieren
• Freigabestatus vor Veröffentlichung prüfen

Schritt 8: Übersetzungsqualität und Governance etablieren

Terminologie, Platzhalter, Links, MDX-Syntax und Build-Fähigkeit werden automatisiert und redaktionell geprüft. Verantwortliche, Übergaben und Rückfragen werden im Workflow dokumentiert.

• Terminologie und Stilregeln pflegen
• Syntax-, Link- und Build-Tests pro Locale ausführen
• Übersetzungsstatus und Eigentümerschaft berichten

Praxisphasen

Die einzelnen Arbeitsschritte werden an einer durchgängigen Übungsplattform umgesetzt. Konfigurationen, Inhalte und Prüfungen werden schrittweise erweitert und jeweils mit einem produktionsnahen Build kontrolliert.

• Konfiguration einer zweisprachigen Docusaurus-Site mit Locale-Auswahl und lokalisierten Pfaden
• Übersetzung von Theme-Texten, Dokumenten, Seiten und Navigation
• Entwurf eines Freigabe- und Qualitätsworkflows für Versionen und mehrere Sprachen

Zielgruppe und Voraussetzungen

Zielgruppe: Lokalisierungsverantwortliche, technische Redaktionen, Docusaurus-Entwickler, Produktteams und Build-Verantwortliche

Voraussetzungen: Docusaurus-Grundkenntnisse, sicherer Umgang mit Markdown und grundlegendes Verständnis von Git-basierten Arbeitsabläufen