Internationalisierung von Websites
Komplette Arbeitsablauf für die Integration mehrsprachiger Unterstützung in Next.js-Websites mit SEO-Best-Practices.
Wann dieses Skill verwendet werden sollte
- Hinzufügen neuer Sprachversionen zu einer bestehenden Website
- Einrichten von i18n (Internationalisierung) für eine neue Website
- Konfigurieren von SEO für mehrere Sprachen
- Benutzer erwähnt: "Sprache hinzufügen", "Übersetzung", "Lokalisierung", "hreflang", "mehrsprachig"
Unterstützte Sprachen
Häufige Zielmärkte:
- 🇺🇸 Englisch (en) - Globaler Markt
- 🇯🇵 Japanisch (ja) - Asiatischer Markt
- 🇨🇳 Chinesisch (zh) - Chinesischer Markt
Erweiterte Unterstützung verfügbar für:
- Koreanisch (ko), Portugiesisch (pt), Spanisch (es), Französisch (fr), Deutsch (de)
- Arabisch (ar), Vietnamesisch (vi), Hindi (hi), Indonesisch (id), Thailändisch (th)
- Traditionelles Chinesisch (zh-hk), Italienisch (it), Russisch (ru)
Internationalisierungs-Workflow
Kopieren Sie diese Checkliste und verfolgen Sie Ihren Fortschritt:
i18n-Fortschritt:
- [ ] Schritt 1: Basis-Sprachdateien vorbereiten
- [ ] Schritt 2: Neue Sprachdateien hinzufügen
- [ ] Schritt 3: Konfigurationsdateien aktualisieren
- [ ] Schritt 4: Übersetzungen hinzufügen
- [ ] Schritt 5: SEO-Elemente konfigurieren
- [ ] Schritt 6: Validieren und testen
Schritt 1: Basis-Sprachdateien vorbereiten
Stellen Sie sicher, dass englische (en.json) Dateien als Vorlagen vorhanden sind:
Erforderliche Verzeichnisse:
i18n/messages/en.json- Hauptübersetzungeni18n/pages/landing/en.json- Landingpage-Übersetzungen
Struktur überprüfen:
# Prüfen, ob Basisdateien existieren
ls i18n/messages/en.json
ls i18n/pages/landing/en.json
Falls nicht vorhanden, erstellen Sie sie mit vollständigen Übersetzungsschlüsseln für Ihre Website.
Schritt 2: Neue Sprachdateien hinzufügen
Führen Sie das Skript zum Hinzufügen von Sprachen aus:
node scripts/i18n-add-languages.mjs
Was dieses Skript tut:
- Kopiert
en.jsonin alle Zielsprachdateien - Aktualisiert
i18n/locale.tsmit neuen Locales - Aktualisiert
i18n/request.tsmit Sprachzuordnungen - Aktualisiert
public/sitemap.xmlmit neuen Sprach-URLs
Skript-Konfiguration (in i18n-add-languages.mjs):
languages-Array - Liste der hinzuzufügenden SprachenlanguageNames-Objekt - Anzeigenamen der SprachentargetDirs-Array - Verzeichnisse mit Übersetzungsdateien
Siehe WORKFLOW.md für eine detaillierte Schritt-für-Schritt-Anleitung.
Schritt 3: Konfigurationsaktualisierungen überprüfen
Überprüfen Sie i18n/locale.ts:
export const locales = ["en", "ja", "zh", "ko", ...];
export const localeNames: any = {
en: "English",
ja: "日本語",
zh: "中文",
ko: "한국어",
...
};
Überprüfen Sie i18n/request.ts:
- Sprachcode-Zuordnungen konfiguriert
zh-CN→zh,zh-HK→zh-hkZuordnungen vorhanden
Überprüfen Sie public/sitemap.xml:
- Alle Sprachversionen aufgeführt
hreflang-Tags für jede URL vorhanden
Schritt 4: Übersetzungen hinzufügen
Option A: Mittels KI-Übersetzung (schneller, aber Überprüfung erforderlich):
# Strukturierte Daten und Preisübersetzungen hinzufügen
node scripts/i18n-add-schema.js
Konfigurieren Sie Übersetzungen im translations-Objekt des Skripts.
Option B: Manuelle Übersetzung (für Qualität empfohlen):
Bearbeiten Sie jede Sprachdatei mit korrekten Übersetzungen:
# Sprachdatei öffnen
code i18n/messages/ja.json
Best Practices für Übersetzungen:
- Verwenden Sie nach Möglichkeit Muttersprachler
- Behalten Sie SEO-Keywords in der Zielsprache bei
- Passen Sie Inhalte an die lokale Kultur an, übersetzen Sie nicht nur
- Halten Sie die Formatierung konsistent (Platzhalter, Variablen)
Siehe reference/locale-codes.md für die Referenz der Sprachcodes.
Schritt 5: SEO-Elemente konfigurieren
hreflang-Tags - Automatisch über Sitemap, aber überprüfen:
Siehe reference/hreflang-guide.md für die vollständige Anleitung.
Lokalisierte Meta-Tags - Übersetzen Sie in jeder Sprachdatei:
{
"metadata": {
"title": "Ihr Seitentitel",
"description": "Ihre SEO-Beschreibung"
}
}
URL-Struktur - Überprüfen Sie das korrekte Format:
- Englisch:
https://example.com/oderhttps://example.com/en/ - Japanisch:
https://example.com/ja/ - Chinesisch:
https://example.com/zh/
Schritt 6: Validieren und testen
Projekt bauen:
npm run build
KRITISCH: Beheben Sie alle Fehler, bevor Sie fortfahren.
Manuelles Testen:
-
Sprachumschalter:
- Besuchen Sie jede Sprachversion
- Überprüfen Sie, ob der Sprachumschalter alle Sprachen anzeigt
- Klicken Sie auf jeden Sprachlink, überprüfen Sie, ob die richtige Seite geladen wird
-
Inhaltsanzeige:
- Überprüfen Sie, ob alle Seiten in jeder Sprache korrekt dargestellt werden
- Stellen Sie sicher, dass kein unübersetzter Text vorhanden ist (prüfen Sie auf Englisch in nicht-englischen Seiten)
- Testen Sie die korrekte Anzeige von Sonderzeichen (Japanisch, Chinesisch, Arabisch)
-
SEO-Elemente:
- Überprüfen Sie, ob das Attribut
<html lang="...">mit der Seitensprache übereinstimmt - Stellen Sie sicher, dass
<link rel="alternate" hreflang="...">-Tags vorhanden sind - Überprüfen Sie, ob die Meta-Tags in der korrekten Sprache sind
- Überprüfen Sie, ob das Attribut
Automatisierte Validierung:
# Sitemap überprüfen
curl https://ihre-site.com/sitemap.xml | grep hreflang
# hreflang validieren (Online-Tool verwenden)
# Google Search Console > Internationalisierung > hreflang
SEO-Checkliste - Siehe reference/seo-checklist.md.
Wenn die Validierung fehlschlägt:
- Überprüfen Sie die Fehlermeldungen sorgfältig
- Prüfen Sie die Konfigurationsdateien auf Tippfehler
- Stellen Sie sicher, dass die Sprachcodes korrekt sind
- Kehren Sie zu Schritt 3 zurück und beheben Sie die Probleme
Fahren Sie erst fort, wenn alle Validierungen bestanden sind.
Wichtige Hinweise
Sprachcode-Standards
Verwenden Sie ISO 639-1 (zweistellige Codes) mit optionalen regionalen Varianten:
en- Englischja- Japanischzh- Vereinfachtes Chinesischzh-hk- Traditionelles Chinesisch (Hongkong)pt- Portugiesischpt-br- Brasilianisches Portugiesisch
Siehe reference/locale-codes.md für die vollständige Liste.
SEO-Auswirkungen
Korrekte i18n verbessert SEO durch:
- Ansprechen von Benutzern in ihrer Muttersprache
- Vermeidung von Duplicate-Content-Strafen
- Hilfe für Suchmaschinen, die richtige Sprachversion auszuliefern
Häufige SEO-Fehler, die vermieden werden sollten:
- ❌ Automatische Weiterleitung basierend auf IP (verhindert das Crawlen aller Versionen durch Suchmaschinen)
- ❌ Fehlende hreflang-Tags (verursacht Duplicate-Content-Probleme)
- ❌ Inkonsistente URL-Struktur über Sprachen hinweg
- ❌ Unübersetzte Meta-Tags
Übersetzungsqualität
KI-Übersetzung vs. menschliche Übersetzung:
- ✅ KI: Schnell, kostengünstig, gut für den ersten Entwurf
- ⚠️ KI: Kann kulturelle Nuancen übersehen, erfordert Überprüfung
- ✅ Mensch: Bessere Qualität, kulturelle Anpassung
- ⚠️ Mensch: Langsamer, teurer
Empfohlener Ansatz:
- KI verwenden, um erste Übersetzungen zu generieren
- Muttersprachler überprüfen und verfeinern lassen
- Mit Benutzern des Zielmarktes testen
- Basierend auf Feedback iterieren
Next.js i18n Routing
Das System verwendet next-intl für das Routing:
- Automatische Erkennung des Locales aus der URL
- Sprachumschalter-Komponente
- Lokalisierte Navigation
Konfiguration in i18n/locale.ts und i18n/request.ts.
Aufgaben nach der Internationalisierung
Nach dem Hinzufügen von Sprachen:
- Aktualisierte Sitemap bei Google Search Console einreichen
- Separate Search Console-Eigenschaften für jede Sprache/Region erstellen
- Internationalen organischen Traffic in Analytics überwachen
- Übersetzungen A/B-testen, wenn die Conversion-Raten sprachabhängig variieren
- Benachrichtigungen für internationale Crawl-Fehler einrichten
Skript-Standorte
Alle i18n-Skripte befinden sich im scripts/-Verzeichnis:
i18n-add-languages.mjs- Neue Sprachdateien hinzufügeni18n-add-schema.js- Strukturierte Datenübersetzungen hinzufügen
Referenzmaterialien
- WORKFLOW.md - Detaillierter Schritt-für-Schritt-Workflow
- reference/hreflang-guide.md - hreflang-Implementierungsleitfaden
- reference/locale-codes.md - Referenz der Sprachcodes
- reference/seo-checklist.md - Internationale SEO-Checkliste
Zur Fehlerbehebung siehe den Abschnitt zur Fehlerbehebung in WORKFLOW.md.