Best Practices für die Softwarelokalisierung: Vollständiger Leitfaden für Entwickler

Erfahren Sie mehr über Best Practices für die Softwarelokalisierung: Bereiten Sie Code vor, verarbeiten Sie dynamische Inhalte und erstellen Sie flexible UI-Layouts für globale Märkte. Vollständiger Leitfaden mit Beispielen und einem kostenlosen Übersetzungstool.

Ihre App wurde gerade in Frankreich veröffentlicht. Der Traffic steigt, die Anmeldungen laufen gut und dann füllt sich Ihr Posteingang mit Support-Tickets. Benutzer können nicht auf die Schaltfläche „Jetzt kaufen“ klicken, weil sie abgeschnitten wurde. Formulare werden nicht gesendet. Navigationsmenüs brechen über zwei Zeilen um. Ihre sorgfältig gestaltete Benutzeroberfläche sieht völlig kaputt aus.

Das passiert, wenn Sie den Softwarelokalisierungsprozess überspringen und direkt zur Übersetzung übergehen. Der Text wird übersetzt, aber Ihre App wurde nicht dafür entwickelt, ihn zu verarbeiten.

So könnte das Problem aussehen:

Der Grund? Weil Ihr Code ungefähr so aussieht:

<button style="width: 120px">Änderungen speichern</button>

<button style="width: 120px">Save Changes</button>

Dieser Leitfaden führt Sie Schritt für Schritt durch die notwendigen Maßnahmen, bevor Sie auch nur eine einzige Zeichenkette übersetzen. Sie erfahren, wie Sie:

• Verwenden Sie separate Dateien für lokalisierbare Inhalte
• Behandeln Sie Platzhalter und dynamische Inhalte
• Bereiten Sie die Benutzeroberfläche auf Texterweiterung vor
• Laden Sie die richtige Sprache für Ihre Nutzer
• Richten Sie automatisierte Übersetzungen ein

Am Ende wissen Sie, wie Sie lokalisierte Software ausliefern, die tatsächlich funktioniert – nicht nur Software, die übersetzt wurde.

Schritt 1: Verwenden Sie separate Dateien für lokalisierbare Inhalte

Folgendes passiert, wenn Sie Zeichenketten fest im Code verankern: Übersetzungstools scannen Ihre Codebasis und suchen nach Text, der in Ressourcendateien wie JSON, PO oder YAML übersetzt werden soll. Sie finden… nichts. Weil sie keine Zeichenketten erkennen können, die in Ihren JavaScript-, PHP- oder Ruby-Dateien versteckt sind.

Dies ist der häufigste Fehler bei der Softwarelokalisierung. Die meisten gescheiterten Lokalisierungsprojekte scheitern genau hier, weil Teams zu spät erkennen, dass sie Tausende von fest codierten Zeichenketten refaktorieren müssen.

Was zählt als benutzerorientierter Text?

Alles, was Ihre Benutzer sehen können:

• UI-Beschriftungen, Schaltflächen und Menüpunkte
• Fehlermeldungen und Validierungstext
• E-Mail-Vorlagen und Benachrichtigungen
• Hilfetext, Tooltips und Placeholder-Text
• Erfolgs-/Bestätigungsnachrichten

All dies muss in separate Dateien gespeichert werden.

React Beispiel:

// Falsch - fest codiert
<button>Submit</button>

// Richtig - mit react-intl
<button>{t('submit_button')}</button>

// Wrong - hard-coded
<button>Submit</button>

// Right - using react-intl
<button>{t('submit_button')}</button>

WordPress Beispiel:

// Falsch - fest codiert
echo 'Submit';

// Richtig - mit WordPress i18n
echo __( 'Submit', 'your-textdomain' );

// Wrong - hard-coded
echo 'Submit';

// Right - using WordPress i18n
echo __( 'Submit', 'your-textdomain' );

Rails Beispiel:

# Falsch - fest codiert
flash[:notice] = "Profile updated successfully"

# Richtig - mit Rails I18n
flash[:notice] = t('profile.update_success')

# Wrong - hard-coded
flash[:notice] = "Profile updated successfully"

# Right - using Rails I18n
flash[:notice] = t('profile.update_success')

Welches Dateiformat sollten Sie verwenden?

Wählen Sie das Ressourcendateiformat basierend auf Ihrem Framework aus:

• .json – JavaScript Frameworks (React, Vue, Angular)
• .po/.pot – WordPress, PHP, Python (gettext)
• .yaml/.yml – Ruby on Rails
• .xml – Android (strings.xml)
• .xcstrings – iOS/macOS

Schritt 2: Platzhalter und dynamische Inhalte richtig verarbeiten

Wenn Sie Benutzerdaten in Zeichenketten einfügen – wie Namen, Zahlen oder Daten – verwenden Sie keine Zeichenkettenverkettung.

Verschiedene Sprachen haben unterschiedliche Wortreihenfolgen. Die Verkettung unterbricht dies, indem sie Sätze in Fragmente aufteilt, die nicht neu geordnet werden können.

Das folgende Beispiel erstellt drei separate Teile, die Übersetzer nicht neu anordnen können. In Sprachen wie Japanisch, in denen sich die Wortreihenfolge vom Englischen unterscheidet, wird die Übersetzung grammatikalisch falsch.

Falsches Beispiel (String-Verkettung)

const name = 'John';
const message = 'Hello, ' + name + '!';

const name = 'John';
const message = 'Hello, ' + name + '!';

Verwenden Sie stattdessen Platzhalter, mit denen Übersetzer den vollständigen Satz steuern können:

Korrekte Beispiele

msgid "Hello, %s!"
msgstr ""

msgid "Hello, %s!"
msgstr ""

{
 "greeting": "Hello, {name}!"
}

{
  "greeting": "Hello, {name}!"
}

greeting: "Hello, %{name}!"

greeting: "Hello, %{name}!"

Stellen Sie sicher, dass Sie eine Placeholder-Syntax verwenden, die mit Ihrem Framework funktioniert:

Schritt 3: Design für Texterweiterung

Erinnern Sie sich an die Schaltfläche aus der Einleitung? Diejenige, auf der auf Englisch „Save“ stand, die aber auf Französisch abgeschnitten wurde?

Das ist Texterweiterung, und sie ist nicht selten. Das erwartet Sie:

• Deutscher Text ist typischerweise 30 % länger als Englisch
• Französisch ist etwa 20 % länger
• Chinesisch und Japanisch sind oft kürzer (haben aber andere Probleme)

Dies sind Durchschnittswerte, und einzelne Wörter können sich aufblähen. „FAQ“ wird im Spanischen zu „Preguntas frecuentes“ – das ist eine Erweiterung um 567 %.

Bevor Sie mit dem Programmieren beginnen, überlegen Sie, wie sich verschiedene Sprachen während der Entwurfsphase auf den Platz auswirken. Verwenden Sie flexible Muster, damit Schaltflächen mit dem Text wachsen können, anstatt abgeschnitten zu werden. Dies spart später Zeit bei der Fehlersuche in Layoutproblemen.

Für einen tieferen Einblick in Layoutmuster lesen Sie wie Sie Layoutprobleme mit langen Übersetzungen vermeiden.

Schritt 4: Schreiben Sie Inhalte, die tatsächlich übersetzbar sind

Ihr Schreibstil ist wichtiger, als Sie denken. Vages, cleveres oder idiomatisches Englisch kann in anderen Sprachen zu Unsinn werden.

✓ Schreiben Sie vollständige Sätze

Eine Zeichenkette wie „Keine Artikel im Warenkorb“ könnte mehrere Dinge bedeuten. Gibt es keinen Warenkorb? Befinden sich keine Artikel im Warenkorb? Ihr Übersetzer (oder Ihr Übersetzungstool) muss raten.

Ein klares Subjekt mit einem klaren Verb macht die Bedeutung klar, was auch die Zeichenkette leicht übersetzbar macht.

Korrekte Beispiele

"Sie haben keine gespeicherten Artikel in Ihrem Warenkorb."

"You have no saved items in your cart."

Dies gibt klar an, was leer ist (Warenkorb) und was er enthalten soll (gespeicherte Artikel).

Vermeiden Sie Redewendungen

„This is a piece of cake“ wird oft im Englischen verwendet, lässt sich aber nicht gut in andere Sprachen übersetzen. Wenn es wörtlich übersetzt wird, werden Ihre deutschen Benutzer sehr verwirrt sein, warum Ihre App über Desserts spricht.

Halten Sie es einfach

Sagen Sie nicht „eliminieren“, wenn „entfernen“ funktioniert. Sagen Sie nicht „nutzen“, wenn Sie „verwenden“ sagen können. Einfache Wörter lassen sich zuverlässiger und klarer übersetzen.

Schritt 5: Richten Sie die Spracherkennung ein

Sobald Ihre Zeichenketten externalisiert und Ihre Benutzeroberfläche flexibel ist, müssen Sie erkennen, welche Sprache jedem Benutzer angezeigt werden soll.

Die meisten Frameworks enthalten i18n-Bibliotheken, die dies automatisch erledigen:

• React mit react-i18next

Installieren Sie react-i18next mit npm und konfigurieren Sie es dann so, dass es die Browsersprache erkennt und Ihre Übersetzungsdateien lädt.

• Ruby on Rails

Rails enthält I18n standardmäßig. Konfigurieren Sie es in config/application.rb. Erkennen Sie dann die Sprache des Benutzers in Ihrem ApplicationController.

• WordPress

WordPress übernimmt die Spracherkennung automatisch. Benutzer legen ihre Website-Sprache unter Einstellungen → Allgemein fest, und WordPress lädt die entsprechende .mo-Datei aus wp-content/languages/. Für mehrsprachige Websites, auf denen verschiedene Benutzer unterschiedliche Sprachen benötigen, benötigen Sie ein Plugin wie WPML, um die Sprachauswahl pro Benutzer zu verwalten.

Legen Sie eine Fallbacksprache fest

Legen Sie Ihre Fallbacksprache auf Ihre Primärsprache fest. Wenn eine Übersetzungsdatei nicht existiert oder Strings fehlen, sehen Benutzer den Fallback anstelle von fehlerhaftem Text oder Übersetzungsschlüsseln.

Fügen Sie einen Sprachumschalter hinzu (falls erforderlich)

Die meisten Anwendungen sollten die Browser- oder Gerätespracheeinstellungen des Benutzers automatisch berücksichtigen. Wenn Sie jedoch zulassen möchten, dass Benutzer dies manuell überschreiben – was bei Webanwendungen üblich ist – fügen Sie einen Sprachumschalter hinzu und speichern Sie deren Auswahl:

// Speichern der manuellen Sprachauswahl des Benutzers
localStorage.setItem('userLanguage', selectedLanguage);

// Zuerst auf manuelle Auswahl prüfen, dann Browser-Standard verwenden
const userLanguage = localStorage.getItem('userLanguage') || navigator.language;

// Save user's manual language selection
localStorage.setItem('userLanguage', selectedLanguage);

// Check for manual selection first, then use browser default
const userLanguage = localStorage.getItem('userLanguage') || navigator.language;

Mobile Apps enthalten in der Regel keine Sprachumschalter, da Benutzer erwarten, dass Apps ihren Geräteeinstellungen folgen.

Schritt 6: Automatisieren Sie Ihren Softwareübersetzungsprozess

Wenn Ihr Lokalisierungsprozess so aussieht, machen Sie etwas falsch:

1. Zeichenketten in eine Tabelle exportieren
2. Tabelle per E-Mail an den Übersetzer senden
3. 3 Tage warten
4. Tabelle zurückerhalten
5. Übersetzungen manuell in JSON-Dateien kopieren
6. Feststellen, dass Sie 12 Zeichenketten übersehen haben
7. Wiederholen

Das ist langsam, fehleranfällig und nicht skalierbar.

So sollten Sie es stattdessen machen: Verwenden Sie ein Übersetzungstool, das eine kontinuierliche Lokalisierung ermöglicht.

PTC ist ein KI-Übersetzungstool, das den Übersetzungsprozess automatisiert. Sie können es in Ihr GitHub-, GitLab– oder Bitbucket-Repository integrieren oder die API für die CI/CD-Integration verwenden. Wenn Sie Zeichenketten aktualisieren, erfolgen die Übersetzungen automatisch.

Es ist kostenlos für 20.000 Wörter in 2 Sprachen, danach zahlen Sie nur für das, was Sie übersetzen. Kein Abonnement, und der Einstieg dauert weniger als 5 Minuten.

Schritt 7: Testen Sie lokalisierte Versionen vor der Veröffentlichung

Sie sollten nicht nur prüfen, ob der übersetzte Text angezeigt wird. Testen Sie die tatsächliche Funktionalität in jeder Sprache.

• Layout: Passt der Text, ohne abgeschnitten zu werden? Funktioniert die Navigation noch oder sehen Sie einen Überlauf?
• Funktionalität: Werden Formulare gesendet? Werden Fehlermeldungen in der richtigen Sprache angezeigt? Kann die Suche Akzentzeichen verarbeiten (é, ñ, ü)?
• Formatierung: Sind die Datumsangaben im richtigen Format (TT/MM vs. MM/TT)? Sind Zahlen korrekt formatiert (1.000,00 vs. 1.000,00)? Steht die Währung an der richtigen Position (100 € vs. 100€)?

Testen Sie dies, bevor Sie es in die Produktion überführen. Es ist nicht die Art und Weise, wie Sie Lokalisierungsfehler entdecken möchten, wenn Sie herausfinden, dass Ihr deutscher Checkout-Prozess defekt ist, wenn Benutzer anfangen, negative Bewertungen abzugeben.