Internationalisierungs-Helper
Hilft bei der Verwaltung von Internationalisierung (i18n) und Lokalisierung (l10n) in mehrsprachigen Anwendungen.
Wann verwenden
- Benutzer fordert i18n-Unterstützung an
- Neue Sprachen hinzufügen
- Nicht übersetzte Zeichenketten finden
- Übersetzungsdateien verwalten
- Benutzer erwähnt "Übersetzung", "i18n", "l10n", "Locale"
Anleitung
1. i18n-Framework erkennen
JavaScript/React:
- react-i18next
- react-intl (FormatJS)
- i18next
- LinguiJS
Vue:
- vue-i18n
Python:
- gettext
- Django i18n
- Flask-Babel
Ruby/Rails:
- I18n gem (eingebaut)
Suche nach Imports, Konfigurationsdateien oder Übersetzungsverzeichnissen.
2. Hartcodierte Zeichenketten finden
Suche nach nicht übersetztem Text:
// Schlecht: Hartcodiert
<button>Absenden</button>
<p>Willkommen, {user.name}!</p>
// Gut: Übersetzt
<button>{t('common.submit')}</button>
<p>{t('welcome.message', { name: user.name })}</p>
Suchmuster:
- Zeichenketten in JSX/Template-Tags
- Hinweis-/Fehlermeldungen
- Formularbeschriftungen und Platzhalter
- Schaltflächentexte
- Validierungsmeldungen
Ausschließen: Codekommentare, console.log, Testzeichenketten
3. In Übersetzungsdateien extrahieren
React-i18next Format (JSON):
{
"common": {
"submit": "Absenden",
"cancel": "Abbrechen"
},
"welcome": {
"message": "Willkommen, {{name}}!"
}
}
Gettext Format (.po):
msgid "submit_button"
msgstr "Absenden"
msgid "welcome_message"
msgstr "Willkommen, %(name)s!"
4. Übersetzungsschlüssel organisieren
Bewährte Methoden:
- Nach Feature benennen:
users.profile.title - Gemeinsame Zeichenketten gruppieren:
common.buttons.save - Kontext beschreiben, nicht Inhalt:
errors.login.invalidnichterrors.wrong_password - Einheitliche Namenskonvention
5. Übersetzungsabdeckung prüfen
Vergleiche Locale-Dateien, um fehlende Übersetzungen zu finden:
en.json: 150 Schlüssel
es.json: 142 Schlüssel (8 fehlen)
fr.json: 150 Schlüssel ✓
Fehlend in es.json:
- users.profile.bio
- settings.privacy.title
[...]
6. Pluralisierung handhaben
Verschiedene Sprachen haben unterschiedliche Pluralregeln:
// react-i18next
t('items', { count: 0 }) // "0 Elemente"
t('items', { count: 1 }) // "1 Element"
t('items', { count: 5 }) // "5 Elemente"
// Übersetzungsdatei
{
"items_zero": "{{count}} Elemente",
"items_one": "{{count}} Element",
"items_other": "{{count}} Elemente"
}
7. Datums-, Zeit- und Zahlenformatierung
Verwende Locale-bewusste Formatierung:
// Zahlen
const preis = new Intl.NumberFormat('de-DE', {
style: 'currency',
currency: 'EUR'
}).format(29,99);
// Daten
const datum = new Intl.DateTimeFormat('de-DE').format(new Date());
8. RTL (Rechts-nach-Links)-Unterstützung
Für Arabisch, Hebräisch:
- CSS:
direction: rtl; - HTML:
<html dir="rtl"> - Logische Eigenschaften:
margin-inline-startstattmargin-left
9. Übersetzungsvorlage generieren
Erstelle eine Vorlage für ein neues Locale:
# Schlüssel aus Basissprache kopieren, Werte leer lassen
cp locales/en.json locales/de.json
# Zum Übersetzen markieren
10. Bewährte Methoden
- Übersetzungen in separaten Dateien halten
- Schlüssel verwenden, nicht Quelltext als Schlüssel
- Übersetzern Kontext geben
- Mit langen Zeichenketten testen (Deutsch ist oft länger)
- ICU MessageFormat für komplexe Zeichenketten verwenden
- Übersetzte Zeichenketten nicht verketten
- Allen benutzersichtigen Text extrahieren
Unterstützende Dateien
templates/i18n-config.js: Konfigurationsbeispieletemplates/locale-file.json: Übersetzungsdateivorlage