Sprachen hinzufügen

Zuletzt aktualisiert: letztes Quartal · 1 Min. Lesezeit

Veraltet

Diese Doku behandelt die alte CLI (v0). Die aktuelle CLI ist v1. Zur aktuellen CLI-Doku

Fügen Sie neue Zielsprachen hinzu, indem Sie das targets-Array in i18n.json aktualisieren und die CLI ausführen. Für neue Sprachen werden vollständige Übersetzungsdateien erstellt, bestehende Übersetzungen bleiben unverändert.

Eine Sprache hinzufügen#

Aktualisieren Sie Ihre i18n.json-Konfiguration:

json
{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  }
}

Führen Sie die CLI aus:

bash
npx lingo.dev@latest run

Die CLI erstellt für jede neue Sprache vollständige Übersetzungsdateien:

text
locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

Bestehende und neue Sprachen im Vergleich#

Die CLI behandelt bestehende und neue Sprachen unterschiedlich:

Bestehende SprachenNeue Sprachen
VerhaltenEs werden nur fehlende Schlüssel übersetztVollständige Dateien werden von Grund auf neu erstellt
Bestehender InhaltBleibt erhaltenN/A

Regionale Varianten#

Die CLI unterstützt regionale Sprachvarianten mit BCP-47-Tags:

json
{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

Jede Variante erhält eine eigene Übersetzungsdatei mit regionsspezifischer Terminologie, Rechtschreibung und Tonalität.

Gezielte Generierung#

Generieren Sie Übersetzungen für eine bestimmte Sprache, ohne alle Ziele zu verarbeiten:

bash
npx lingo.dev@latest run --target-locale de

Das ist besonders nützlich, wenn Sie Sprachen einzeln hinzufügen und die Qualität prüfen möchten, bevor Sie weiter ausrollen.

Sprachen entfernen#

Entfernen Sie eine Sprache aus dem targets-Array, und die CLI verarbeitet sie nicht mehr. Bestehende Dateien werden nicht gelöscht – entfernen Sie sie bei Bedarf manuell.

Nächste Schritte#