i18n & Lokalisierung
Internationalisierung (i18n) und Lokalisierung (L10n) – Best Practices.
1. Kernkonzepte
| Begriff | Bedeutung |
|---|
| i18n | Internationalisierung – App übersetzbar machen |
| L10n | Lokalisierung – tatsächliche Übersetzungen |
| Locale | Sprache + Region (en-US, tr-TR) |
| RTL | Rechts-nach-links-Sprachen (Arabisch, Hebräisch) |
2. Wann i18n verwendet werden sollte
| Projekttyp | i18n nötig? |
|---|
| Öffentliche Web-App | ✅ Ja |
| SaaS-Produkt | ✅ Ja |
| Internes Tool | ⚠️ Vielleicht |
| Einregionale App | ⚠️ Zukunft bedenken |
| Persönliches Projekt | ❌ Optional |
3. Implementierungsmuster
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Welcome to our app"))
4. Dateistruktur
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
5. Best Practices
TUN ✅
- Übersetzungsschlüssel verwenden, keinen Rohtext
- Übersetzungen nach Feature benennen
- Pluralisierung unterstützen
- Datums-/Zahlenformate pro Locale behandeln
- Von Anfang an für RTL planen
- ICU-Nachrichtenformat für komplexe Zeichenfolgen verwenden
NICHT TUN ❌
- Zeichenfolgen in Komponenten hartcodieren
- Übersetzte Zeichenfolgen verketten
- Textlänge annehmen (Deutsch ist 30 % länger)
- RTL-Layout vergessen
- Sprachen in derselben Datei mischen
6. Häufige Probleme
| Problem | Lösung |
|---|
| Fehlende Übersetzung | Fallback auf Standardsprache |
| Hartcodierte Zeichenfolgen | Linter/Checker-Skript verwenden |
| Datumsformat | Intl.DateTimeFormat verwenden |
| Zahlenformat | Intl.NumberFormat verwenden |
| Pluralisierung | ICU-Nachrichtenformat verwenden |
7. RTL-Unterstützung
.container {
margin-inline-start: 1rem;
padding-inline-end: 1rem;
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
8. Checkliste
Vor dem Ausliefern:
Skript
| Skript | Zweck | Befehl |
|---|
scripts/i18n_checker.py | Hartcodierte Zeichenfolgen & fehlende Übersetzungen erkennen | python scripts/i18n_checker.py <Projektpfad> |
Wann es verwendet werden sollte
Diese Fertigkeit ist anwendbar, um den im Überblick beschriebenen Workflow oder die Aktionen auszuführen.
Einschränkungen
- Verwenden Sie diese Fertigkeit nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachliche Überprüfung.
- Bitten Sie um Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.