Was macht i18n & Lokalisierung?
Internationalisierungs- (i18n) und Lokalisierungs- (L10n) Best Practices.
1. Kernkonzepte
| Begriff | Bedeutung |
|---|
| i18n | Internationalisierung – die App übersetzbar machen |
| L10n | Lokalisierung – eigentliche Übersetzungen |
| Locale | Sprache + Region (en-US, tr-TR) |
| RTL | Rechts-nach-links-Sprachen (Arabisch, Hebräisch) |
2. Wann i18n einsetzen
| Projekttyp | i18n nötig? |
|---|
| Öffentliche Web-App | ✅ Ja |
| SaaS-Produkt | ✅ Ja |
| Internes Tool | ⚠️ Vielleicht |
| Ein-Regionen-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 statt Rohtext verwenden
- Übersetzungen nach Funktion gruppieren (Namensräume)
- Pluralisierung unterstützen
- Datums-/Zahlenformate pro Locale handhaben
- Von Anfang an RTL einplanen
- ICU-Nachrichtenformat für komplexe Zeichenketten verwenden
NICHT TUN ❌
- Zeichenketten direkt in Komponenten fest codieren
- Übersetzte Zeichenketten verketten
- Textlänge ignorieren (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 |
| Fest codierte Zeichenketten | Linter/Prüfskript verwenden |
| Datumsformat | Intl.DateTimeFormat nutzen |
| Zahlenformat | Intl.NumberFormat nutzen |
| 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 | Erkennt fest codierte Zeichenketten & fehlende Übersetzungen | python scripts/i18n_checker.py <projekt_pfad> |