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 verwenden
| Projekttyp | i18n erforderlich? |
|---|
| Öffentliche Web-App | ✅ Ja |
| SaaS-Produkt | ✅ Ja |
| Internes Tool | ⚠️ Eventuell |
| Einregionen-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(_("Willkommen in unserer 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 gruppieren (Namespaces)
- Pluralisierung unterstützen
- Datums-/Zahlenformate pro Locale handhaben
- RTL von Anfang an einplanen
- ICU-Nachrichtenformat für komplexe Zeichenketten nutzen
NICHT TUN ❌
- Zeichenketten in Komponenten hartcodieren
- Übersetzte Zeichenketten verketten
- Textlänge als gegeben 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 Zeichenketten | Linter-/Prüfskript verwenden |
| Datumsformat | Intl.DateTimeFormat nutzen |
| Zahlenformat | Intl.NumberFormat nutzen |
| Pluralisierung | ICU-Nachrichtenformat nutzen |
7. RTL-Unterstützung
.container {
margin-inline-start: 1rem;
padding-inline-end: 1rem;
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
8. Checkliste
Vor der Auslieferung:
Skript
| Skript | Zweck | Befehl |
|---|
scripts/i18n_checker.py | Hartcodierte Zeichenketten & fehlende Übersetzungen erkennen | python scripts/i18n_checker.py <projekt_pfad> |
Verwendung
Dieser Skill ist anwendbar, um den im Überblick beschriebenen Workflow oder die beschriebenen Aktionen auszuführen.
Einschränkungen
- Verwenden Sie diesen Skill nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Fragen Sie nach und bitten Sie um Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.