Produkttexte sind localization-ready, wenn du sie zuerst in einer einzigen Quelle bündelst. Als Literale über Komponenten verstreute Texte machst du durch Umschreiben nicht localization-ready, denn es gibt keine verbindliche Quelle zum Übersetzen. Klarheit, Glossare und Styleguides sind wichtig, zahlen sich aber erst aus, wenn die Strings in einem Katalog liegen. Diese Seite zeigt die Reihenfolge, die funktioniert.
Die meisten Ratgeber zu diesem Thema setzen bei Schritt zwei an. Sie raten dir, in einfacher Sprache zu schreiben, Redewendungen zu vermeiden und Übersetzenden Kontext zu geben. Das sind alles gute Ratschläge, aber keiner lässt sich umsetzen, solange dieselbe Meldung in fünf leicht abweichenden Varianten über deine Komponenten verteilt ist. Den begrifflichen Hintergrund und das Argument, warum die Codebase die Source of Truth für Produkttexte sein sollte, findest du unter Code-native Produkttexte. Diese Seite zeigt die praktische Reihenfolge der Schritte.
Was bedeutet localization-ready?
Es bedeutet: Du gibst deine Texte an Übersetzende oder ein Übersetzungstool, und die liefern eine korrekte Fassung, ohne raten zu müssen. Dafür müssen drei Bedingungen erfüllt sein: Jeder String existiert an genau einer verbindlichen Stelle, jeder String sagt eine klare Sache, und wer ihn übersetzt, erkennt, wo und wie er verwendet wird.
Die drei Bedingungen lassen sich nicht gleich leicht nachrüsten. Klare Formulierungen kannst du String für String verbessern. Kontext lässt sich als Notiz ergänzen. Aber „genau eine verbindliche Stelle“ ist strukturell. Fehlt sie, haben die beiden anderen nichts Stabiles, woran sie ansetzen können: Du kannst keinen String verbessern, dessen Zwilling in einer anderen Datei liegt, und du kannst keine Meldung annotieren, die keine eindeutige Adresse hat.
Warum begrenzt die Quelle die Qualität der Übersetzung?
Weil eine Übersetzung ein abgeleitetes Werk ist und abgeleitete Werke jeden Fehler dessen erben, woraus sie entstehen. Eine Übersetzung trägt die Mehrdeutigkeit der Quelle in jede Zielsprache, und die Inkonsistenz ebenso. Steht in der Quelle auf einem Screen „Sign in“, auf einem anderen „Log in“ und auf einem dritten „Login“, hast du in jeder Sprache drei Begriffe, unabhängig voneinander übersetzt, und keine Möglichkeit zu sagen, welcher gemeint ist.
Deshalb setzt auch die übliche Lösung, die Übersetzungen zu polieren, am falschen Ende an. Jede Sprache, die du hinzufügst, vervielfacht die Kosten einer unbereinigten Quelle. Die Quelle einmal zu korrigieren korrigiert sie überall, auch in Sprachen, die du noch gar nicht hinzugefügt hast.
Für den zugrunde liegenden Fehler gibt es einen Namen. Copy Drift bedeutet: Für Nutzer sichtbarer Text entfernt sich über verschiedene Oberflächen und im Lauf der Zeit von seiner freigegebenen Quelle, weil es keine einzige Source of Truth gibt. Was ist Copy Drift behandelt die Ursachen. Bei der Lokalisierung wird es teuer, weil sich der Drift in jede Sprache fortpflanzt.
Warum lassen sich verstreute Texte nicht localization-ready machen?
Weil es nichts gibt, was du übergeben könntest. Ein Literal in einer Komponente ist keine Einheit, die ein Übersetzungsschritt aufnehmen kann. Es ist mit Markup und Logik vermischt, es kann aus Fragmenten zusammengesetzt sein, und derselbe Satz kann in mehreren Dateien mit kleinen Abweichungen vorkommen, die niemand bewusst gewählt hat.
Diese Strings direkt im Code umzuschreiben ändert daran nichts. Du kannst jeden einzelnen klarer formulieren und hast trotzdem keinen Katalog, keine verbindliche Liste dessen, was das Produkt sagt, und keine Möglichkeit zu wissen, ob du alle gefunden hast. Das Ergebnis sind aufgeräumtere Texte an denselben verstreuten Orten.
Der erste Schritt ist daher keine Redaktionsarbeit, sondern Sammelarbeit: Bring jeden für Nutzer sichtbaren String in einen Katalog mit einer Quellsprache, der im Repository liegt und von den Komponenten per Key referenziert wird. Ändere dabei den Wortlaut nicht. In diesem Durchgang geht es darum festzustellen, was das Produkt aktuell sagt – auch dort, wo es sich widerspricht.
Wie sammelst du die Strings ein?
Erst in einen Katalog verschieben, dann verbessern. Dafür gibt es zwei Gründe. Ein gemischter Durchgang, bei dem du beim Verschieben umformulierst, verschleiert vor Reviewern und vor dir selbst, was sich geändert hat. Und sobald alles in einer Datei liegt, sind Duplikate und Beinahe-Duplikate nicht mehr unsichtbar: Sie stehen nebeneinander, und das Aufräumen heißt nur noch, eine Datei zu lesen.
Praktisch heißt das:
- Wähle pro Quellsprache einen Katalog im Repo. Eine maßgebliche Fassung, die Menschen wie Tools lesen können. Wie du ihn aufbaust und Keys benennst, steht in so hältst du UI-Texte in einer Codebase konsistent. Es ist derselbe Katalog, daher dient diese Seite als Referenz fürs Layout und wiederholt es hier nicht.
- Ersetze die Literale durch Key-Referenzen. Das gilt für jeden String, den ein Nutzer lesen kann – auch für Button-Labels, Fehlermeldungen, Empty States, Tooltips und Texte für Barrierefreiheit, die üblichen Nachzügler.
- Halte Sätze ganz. Wird eine Nachricht aus Fragmenten zusammengesetzt, mach daraus einen Eintrag mit Variablen. So entspricht die Einheit, die Übersetzende sehen, genau dem, was Nutzer lesen. Die Wortstellung unterscheidet sich zwischen Sprachen, und ein im Code zusammengebauter Satz kann ihr nicht folgen.
- Formuliere noch nicht um. Widerstehe der Versuchung. Du wirst die holprigen Stellen finden – notiere sie und mach weiter.
Wenn diese Liste nach einem Monat sorgfältiger Arbeit in einer großen Codebase aussieht, ist das der ehrliche Aufwand dieses Schritts – und der Grund, warum die meisten Teams hier steckenbleiben.
Was tust du, wenn die Strings in einem Katalog liegen?
Jetzt hat der bekannte Rat endlich einen Ansatzpunkt. Mit einem Katalog wird jeder dieser Schritte zu einem einzigen Durchgang statt zu einer Suche:
- Entferne Duplikate und Beinahe-Duplikate. Wähle für jede Nachricht den freigegebenen Wortlaut und lass jede Verwendung darauf verweisen.
- Lege die Begriffe fest, die nie variieren dürfen. Feature-Namen, die Verben für Kernaktionen, Wörter, die du bewusst nicht verwendest. Schreib sie einmal auf. Das ist dein Glossar, und es ist kurz.
- Schreib klar. Aktiv, keine Redewendungen, keine Witze, die vom Wortspiel einer Sprache abhängen, Akronyme ausgeschrieben, wo sie missverständlich sein könnten. Jeder String sagt eine Sache.
- Gib Übersetzern Kontext. Eine Notiz dazu, wo der String erscheint und wofür eine Variable steht. Kurze Strings wie „Post“ oder „Order“ sind die klassische Falle: Substantiv oder Verb, und die Zielsprache braucht womöglich für beides ein anderes Wort.
- Plane Länge ein. Übersetzter Text ist oft länger als die Quelle, also gestalte Layouts, die nicht brechen, wenn ein Label wächst. Betrachte das als Designvorgabe statt als Zahl, die du einplanst.
Jeder Schritt geht schnell, weil der Katalog der eine Ort ist, an dem er stattfindet. Ohne Katalog sind dieselben fünf Schritte fünf Schnitzeljagden durch die Codebase, und du weißt nie, wann du fertig bist.
Was solltest du klären, bevor du einen Übersetzungsdienstleister oder ein Tool wählst?
Die Quelle und den Review-Weg. Ein Dienstleister oder Tool übersetzt, was du ihm gibst. Gib ihm einen sauberen Katalog und ein kurzes Glossar, dann kann es gute Arbeit leisten. Gib ihm verstreute Literale, und du zahlst dafür, die Inkonsistenzen zu übersetzen, und danach nochmal, um sie in jeder Sprache zu korrigieren.
Entscheide zuerst drei Dinge: welche Datei die Source of Truth ist, wer eine Textänderung freigibt und wie ein geänderter oder neuer String in die Übersetzung gelangt – von Hand, per Skript oder über einen Pull Request, der die Übersetzungen gleich mitbringt. Letzteres verhindert, dass Übersetzungen hinter der Quelle zurückfallen, das Problem aus warum Übersetzungsdateien aus dem Takt geraten.
Was ändert sich, wenn Texte schon im Repository liegen?
Lokalisierung ist kein separates Projekt mehr. Liegt der Katalog im Repo, erscheint ein neuer oder geänderter String als Zeile im Diff, Übersetzungen davon lassen sich im selben Pull-Request-Flow wie der Code erzeugen und reviewen, und niemand muss eine Tabelle exportieren und hoffen, dass sie in der richtigen Reihenfolge zurückkommt.
Deshalb ist es in einer Codebase dieselbe Aufgabe, Texte konsistent und lokalisierungsbereit zu halten. Beides hängt von einer verbindlichen Quelle ab. Mach die Arbeit einmal, und du bekommst beides. Teams, die mit KI-Coding-Tools bauen, merken das früher, weil ein Agent stillschweigend umformuliert oder ein Literal wieder einführt, solange weder Katalog noch Lint-Regel im Weg stehen; so hindest du KI-Coding-Agents daran, deine UI-Texte umzuschreiben behandelt diesen Fall.
Wo globalize.now ins Spiel kommt
globalize.now ist ein code-natives Copy-Management-System mit integrierter Lokalisierung, und der oben beschriebene Single-Sourcing-Schritt ist der Teil, den es für dich übernimmt. Du verbindest in der App ein GitHub- oder GitLab-Repository. Ein Scan ermittelt, was vorhanden ist. Liegen die Strings als Literale in Komponenten, verschiebt eine einmalige Konvertierung sie hinter Keys in einen Katalog und ergänzt das i18n-Setup, falls noch keines existiert; nutzt du bereits eine Bibliothek wie next-intl, react-i18next, i18next oder Lingui, arbeitet es mit dem, was du hast. Das Ergebnis kommt als Pull Request auf einem eigenen Branch an, sodass der erste Katalog genau den oben beschriebenen Review durchläuft. Danach werden neue Quell-Strings, die du hinzufügst, von Push-Jobs übersetzt, die einen Pull Request mit dem Ergebnis öffnen. Das Repository bleibt die einzige Source of Truth, und der Leitfaden zu bestehendem i18n zeigt, was der Scan findet, wenn bereits ein Setup vorhanden ist.
Ziel ist, dass dieselbe Disziplin über Marketing-Site, Landingpage und Produkt hinweg aus einer Quelle gilt. Das ist die Richtung, nichts, was du heute kaufen kannst. Die Preise findest du auf der Preisseite.
Die Reihenfolge in Kürze
- Sammle jeden für Nutzer sichtbaren String in einem Katalog im Repository. Formuliere nichts um.
- Halte Sätze ganz und referenziere jeden String per Key.
- Entferne Duplikate und lege den freigegebenen Wortlaut einmalig fest.
- Schreib das kurze Glossar der Begriffe, die nie variieren.
- Überarbeite die Texte in klarer Sprache und ergänze Kontextnotizen für Übersetzer.
- Lege fest, wer Wortlaut freigibt und wie geänderte Strings in die Übersetzung gelangen.
- Erst dann wählst du den Übersetzungsdienstleister oder das Tool aus oder wechselst es.
Wenn der erste Schritt nach einem Monat Arbeit aussieht: Verbinde ein Repository, lies den Plan, den globalize.now vorschlägt, und prüfe den Pull Request, den es öffnet.
globalize.now konvertiert hartcodierte App-Texte in übersetzungsreife Locale-Dateien und hält sie aktuell, während Sie veröffentlichen.
Probiere globalize.now kostenlos