Inhaltsverzeichnis
Wie AI Context und Glossary Management Ihre Marke über alle Sprachen hinweg konsistent halten
Die Terminologie Ihres Produkts ist Teil Ihrer Marke. Wenn ein Nutzer auf Englisch „workspace" sieht, auf einem spanischen Bildschirm „espacio de trabajo" und auf einem anderen „área de trabajo", untergräbt diese Inkonsistenz das Vertrauen. Multiplizieren Sie das auf 15 Sprachen und Hunderte von Begriffen, und Sie haben ein Markenkohärenzproblem, das keine manuelle Überprüfung lösen kann.
Dieses Tutorial führt durch die AI Context- und Glossary-Management-Funktionen von better-i18n — von der automatisierten Website-Analyse über Begriffsgenehmigungsworkflows bis hin zur DeepL-Synchronisierung — damit Sie Markenterminologiekonsistenz in großem Maßstab durchsetzen können.
Was Sie aufbauen werden
Am Ende dieses Tutorials haben Sie:
- Ein Kontextprofil, das aus dem tatsächlichen Inhalt Ihrer Website erstellt wurde
- Ein Glossary von Markenbegriffen, das automatisch extrahiert und von Ihrem Team verfeinert wurde
- Einen Genehmigungsworkflow, der verhindert, dass nicht genehmigte Begriffe in die Produktion gelangen
- Eine DeepL-Synchronisierung, die Ihr Glossary bei maschinellen Übersetzungen durchsetzt
Schritt 1: Analysieren Sie Ihre Website mit dem Context Crawler
Der schnellste Weg, Ihr Übersetzungs-Glossary zu initialisieren, besteht darin, die AI das analysieren zu lassen, was Sie bereits veröffentlicht haben.
Website-Analyse durchführen
Navigieren Sie in Ihrem better-i18n-Projekt-Dashboard zu AI Context und wählen Sie Website Analysis. Geben Sie die URL der Marketing-Website Ihres Produkts ein — zum Beispiel https://yourproduct.com.
Der Context Crawler verwendet die Firecrawl API, um Inhalte von Ihren Seiten zu rendern und zu extrahieren. Im Gegensatz zu einfachen HTML-Scrapern verarbeitet Firecrawl JavaScript-gerenderte Inhalte, Single-Page-Applications und dynamisch geladene Abschnitte. Er folgt internen Links, um eine umfassende Karte des Inhalts Ihrer Website zu erstellen.
Was die Analyse produziert
Nach dem Crawlen analysiert die AI den extrahierten Inhalt und identifiziert:
- Markenbegriffe — Produktnamen, Funktionsnamen und geprägte Vokabeln (z. B. „Workstream," „Sprint Board," „FlowMetrics")
- Navigationsvokabular — Menübezeichnungen, CTAs und Breadcrumb-Texte, auf die Benutzer wiederholt stoßen
- Domänenspezifische Sprache — Branchenbegriffe, die Ihr Produkt verwendet und die präzise, konsistente Übersetzungen erfordern
- Tonsignale — Ob Ihr Inhalt formell, lässig oder technisch ist, was der AI hilft, im richtigen Register zu übersetzen
Jeder erkannte Begriff enthält die Quell-URLs, an denen er gefunden wurde, eine vorgeschlagene Definition und Häufigkeitsdaten, die zeigen, wie oft er auf Ihrer Website erscheint.
Schritt 2: Analysieren Sie Ihr Repository für Framework-Kontext
Die Website-Analyse erfasst Ihre öffentlich zugängliche Terminologie. Die Repository-Analyse erfasst den technischen Kontext, der AI-Übersetzungen genauer macht.
Verbinden Sie Ihr GitHub-Repository
Wählen Sie im Abschnitt AI Context die Option Repository Analysis und geben Sie Ihre GitHub-Repository-URL an. Der Analyzer unterstützt öffentliche Repos direkt und private Repos über Ihre GitHub-Integration.
Was die Repository-Analyse erkennt
Der Analyzer untersucht Ihre Codebasis, um Folgendes zu identifizieren:
- Framework und i18n-Bibliothek — React mit next-intl? Vue mit vue-i18n? Flutter mit ARB-Dateien? Der erkannte Stack teilt der AI mit, welche Interpolationssyntax, welches Pluralisierungsformat und welche Nachrichtenkonventionen verwendet werden sollen.
- Namespace-Struktur — Wie Ihr Projekt Übersetzungsschlüssel organisiert, sodass neue Übersetzungen bestehenden Mustern folgen.
- Vorhandene Terminologie — Begriffe, die bereits in Ihrer Codebasis verwendet werden und im Glossary sein sollten, es aber möglicherweise nicht sind.
- String-Muster — Datumsformate, Zahlenformate und Pluralisierungsansätze, die Übersetzungsregeln beeinflussen.
Dieser Kontext ist an Ihr Projekt angehängt und wird automatisch in jedem AI-Übersetzungsauftrag verwendet — kein manuelles Prompt Engineering erforderlich.
Schritt 3: Glossary-Begriffe überprüfen und genehmigen
Beide Analysemodi erzeugen Kandidatenbegriffe, die als Entwürfe in Ihr Glossary eingehen. Hier wird der Begriffsworkflow entscheidend.
Der Begriff-Lebenszyklus
Jeder Glossary-Begriff folgt einem vierstufigen Lebenszyklus:
| Status | Bedeutung | In Übersetzung durchgesetzt? |
|---|---|---|
| Entwurf | Neu erstellt oder importiert. Sichtbar, aber nicht durchgesetzt. | Nein |
| Eingereicht | Bereit zur Überprüfung. Signalisiert Vollständigkeit. | Nein |
| Genehmigt | Überprüft und akzeptiert. Aktiv in allen Workflows. | Ja |
| Abgelehnt | Nicht akzeptiert. Kann überarbeitet und erneut eingereicht werden. | Nein |
Nur genehmigte Begriffe werden in AI-Übersetzungsprompts eingefügt und im Überprüfungseditor hervorgehoben. Dies verhindert das häufige Glossary-Management-Problem, bei dem halbfertige oder umstrittene Begriffe mehr Inkonsistenz verursachen, als sie lösen.
Vorgeschlagene Begriffe überprüfen
Navigieren Sie nach einer Website- oder Repository-Analyse zu Ihrem Glossary und filtern Sie nach Entwurfs-Status. Für jeden vorgeschlagenen Begriff:
- Überprüfen Sie den Quellbegriff — Ist dies tatsächlich ein Markenbegriff, der eine kontrollierte Übersetzung erfordert, oder ist es eine allgemeine Sprache?
- Übersetzungen hinzufügen oder bearbeiten — Der Crawler kann Übersetzungen basierend auf erkannten Mustern vorschlagen. Überprüfen und korrigieren Sie diese für jede Zielsprache.
- Regeln festlegen — Markieren Sie Begriffe als nie-übersetzen, wenn sie unverändert durchgehen sollen (Produktnamen, Markennamen, technische Bezeichner).
- Zur Genehmigung einreichen — Sobald Sie mit der Begriffsdefinition und den Übersetzungen zufrieden sind, reichen Sie ihn zur Teamüberprüfung ein.
- Genehmigen oder ablehnen — Ein Prüfer (Sie oder ein Teammitglied) genehmigt den Begriff zur Durchsetzung oder lehnt ihn mit Feedback ab.
Praktisches Beispiel
Angenommen, Ihre Website-Analyse findet, dass „FlowMetrics" 47 Mal auf Ihrer Website vorkommt. Der Crawler schlägt es als Markenbegriff mit einem nie-übersetzen-Flag vor. Sie überprüfen es, bestätigen, dass das Flag korrekt ist, fügen eine Definition hinzu („Unser proprietäres Analytics-Dashboard") und genehmigen es. Von diesem Moment an:
- AI-Übersetzung wird „FlowMetrics" in keiner Sprache übersetzen
- Menschliche Prüfer sehen es hervorgehoben, wenn sie es versehentlich übersetzen
- DeepL (nach der Synchronisierung) wird es unverändert erhalten
Schritt 4: Vorhandene Begriffe massenweise importieren
Wenn Sie von einem anderen Lokalisierungstool migrieren oder eine Tabelle mit genehmigter Terminologie haben, müssen Sie Begriffe nicht einzeln eingeben.
JSON-Import
Bereiten Sie eine JSON-Datei mit Ihren als Objekt-Array strukturierten Begriffen vor. Jedes Objekt enthält den Quellbegriff, Zielübersetzungen pro Sprache und optionale Metadaten (Definition, Wortart, Domänen-Tag, nie-übersetzen-Flag).
Laden Sie die Datei über die Import-Funktion des Glossarys hoch. Der Importer:
- Validiert Einträge anhand der konfigurierten Sprachen Ihres Projekts
- Dedupliziert gegen vorhandene Glossary-Begriffe
- Meldet Konflikte, bevor Änderungen angewendet werden
- Erstellt alle importierten Begriffe mit Entwurfs-Status
Führen Sie nach dem Import den Genehmigungsworkflow durch, um die Begriffe zu aktivieren.
JSON-Export
Sie können Ihr Glossary jederzeit als strukturiertes JSON exportieren — nützlich für Backups, Migration, das Einspeisen von Terminologie in externe Dokumentations-Pipelines oder das Teilen mit Übersetzungsagenturen, die außerhalb von better-i18n arbeiten.
Schritt 5: Synchronisieren Sie Ihr Glossary mit DeepL
Wenn Ihre Übersetzungspipeline DeepL enthält — ob durch die AI-Übersetzung von better-i18n oder direkte DeepL API-Aufrufe — stellt die Glossary-Synchronisierung sicher, dass Ihre Terminologieregeln auf Anbieterebene durchgesetzt werden.
So funktioniert die Synchronisierung
- Navigieren Sie zu Ihren Glossary-Einstellungen und wählen Sie Sync to Provider.
- better-i18n konvertiert Ihre genehmigten Begriffe in das Glossary-Format von DeepL und ordnet Ihr mehrsprachiges Glossary automatisch der Sprachpaarstruktur zu, die DeepL erfordert.
- Das Glossary wird über ihre API zu DeepL hochgeladen.
- Alle nachfolgenden DeepL-Übersetzungen für Ihre konfigurierten Sprachpaare respektieren Ihre Terminologie.
Wann neu synchronisiert werden sollte
Synchronisieren Sie neu nach jedem Stapel von Glossary-Änderungen — neue genehmigte Begriffe, aktualisierte Übersetzungen oder entfernte Einträge. Die Synchronisierung ist idempotent: Sie ersetzt das vorherige DeepL-Glossary durch den aktuellen Status Ihrer genehmigten Begriffe.
Schritt 6: Durchsetzung in der Praxis verifizieren
Mit genehmigtem und synchronisiertem Glossary führen Sie eine Testübersetzung durch, um die Durchsetzung in Aktion zu sehen.
AI-Übersetzungstest
Erstellen Sie eine Testzeichenfolge, die mehrere Glossary-Begriffe enthält. Führen Sie die AI-Übersetzung durch und überprüfen Sie die Ausgabe:
- Genehmigte Begriffe sollten genau so erscheinen, wie in Ihrem Glossary definiert
- Nie-übersetzen-Begriffe sollten unverändert durchgehen
- Der Konsistenzvalidator sollte null Glossary-Verletzungen anzeigen
Test im Überprüfungseditor
Öffnen Sie den Überprüfungseditor für eine Übersetzung, die Glossary-Begriffe enthält:
- Glossary-Begriffe sollten inline hervorgehoben sein
- Das Eingeben einer nicht genehmigten Variante sollte einen Autocomplete-Vorschlag mit der genehmigten Übersetzung auslösen
- Falsch verwendete Begriffe sollten mit einem Tooltip unterstrichen sein, der den genehmigten Begriff erklärt
Pflege Ihres Glossarys im Laufe der Zeit
Ein Glossary ist kein einmalig einzurichtendes Tool. Ihr Produkt entwickelt sich weiter, und Ihre Terminologie entwickelt sich damit.
Regelmäßiges erneutes Crawlen
Führen Sie vierteljährlich (oder nach wichtigen Produktlaunches) Website-Analysen durch, um neue Terminologie zu erkennen. Neue Begriffe werden als Entwürfe eingegeben und halten Ihr Glossary aktuell, ohne bestehende Durchsetzung zu unterbrechen.
Erneute Repository-Analyse
Wenn Sie ein neues Framework einführen, eine neue i18n-Bibliothek hinzufügen oder Ihre Namespace-Hierarchie umstrukturieren, führen Sie die Repository-Analyse erneut durch, um das Kontextprofil Ihres Projekts zu aktualisieren.
Begriff-Pensionierung
Wenn eine Produktfunktion umbenannt oder eingestellt wird, aktualisieren oder löschen Sie den entsprechenden Glossary-Begriff. Der Begriffsworkflow stellt sicher, dass Änderungen vor der Auswirkung auf Übersetzungen durch die Überprüfung gehen.
Export für Auditing
Exportieren Sie Ihr Glossary regelmäßig als JSON für Compliance-Audits, Onboarding von Übersetzungsagenturen oder Backups. Der Export enthält alle Begriffsmetadaten, Übersetzungen und Statusinformationen.
Wichtigste Erkenntnisse
- Beginnen Sie mit der Analyse, nicht mit der manuellen Eingabe. Die Website- und Repository-Analyse des Context Crawlers kann ein Glossary in Stunden statt Wochen initialisieren.
- Verwenden Sie den Genehmigungsworkflow. Der Entwurf-zu-Genehmigt-Lebenszyklus verhindert Glossary-Verschmutzung und stellt sicher, dass nur geprüfte Begriffe durchgesetzt werden.
- Synchronisieren Sie mit DeepL für Durchsetzung auf Anbieterebene. Ihre Terminologieregeln sollten mit der Übersetzungsmaschine reisen, nicht nur mit dem Übersetzungstool.
- Kontinuierlich pflegen. Regelmäßiges erneutes Crawlen und erneute Analyse halten Ihr Glossary mit Ihrem sich entwickelnden Produkt ausgerichtet.
Übersetzungs-Glossary-Management geht nicht darum, ein Referenzdokument zu erstellen, das Übersetzer möglicherweise konsultieren. Es geht darum, ein aktives Durchsetzungssystem aufzubauen, das Markenterminologiekonsistenz über jede Sprache, jeden Übersetzer und jede Übersetzungsmaschine, die Ihr Produkt verwendet, automatisch macht.
Starten Sie mit better-i18n und erstellen Sie noch heute Ihr erstes AI-gestütztes Glossary — oder erkunden Sie die Feature-Seiten Glossary Management und Context Crawler für tiefere technische Details.
