Sprachen in CLI v0 hinzufügen und verwalten

Wähle die passende Sprachvariante, füge in der älteren Version eine Zielsprache hinzu und kontrolliere die zugehörige Datei sowie das Verhalten in der Anwendung.

In v0 bezeichnet locale.source die Ausgangssprache, während locale.targets die Übersetzungsziele für wiederkehrende Läufe festlegt. Wähle die Variante, die deine Leserschaft braucht, und stelle anschließend sicher, dass Konfiguration, Dateinamen, Backend und Anwendung sie durchgängig verwenden.

Eine Zielsprache hinzufügen #

Um neben Spanisch und Französisch auch Deutsch zu unterstützen, bearbeite i18n.json:

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

Führe die installierte v0-Binärdatei für diese Zielsprache aus:

sh
lingo run --target-locale de

Das Flag überschreibt die Zielliste für diesen Lauf und kann auch eine Sprache auswählen, die nicht in der Konfiguration steht. Füge sie für künftige Läufe zur Konfiguration hinzu. Das Muster für separate Dateien locales/[locale].json schreibt locales/de.json. Sieh dir die Werte an und lade die Datei in der Anwendung, bevor du Deutsch für deine Leserschaft aktivierst.

Für eine noch nicht vorhandene Zielsprache werden alle ausgewählten Schlüssel benötigt. Bei einer vorhandenen Zielsprache bleiben bestehende Werte normalerweise erhalten, und fehlende Schlüssel werden ergänzt. Änderungen am Ausgangstext können dennoch eine erneute Übersetzung erforderlich machen. Kombiniere das erstmalige Hinzufügen einer Sprache nicht mit einem umfassenden erzwungenen Lauf, wenn andere bereits akzeptierte Sprachen unverändert bleiben sollen.

Ein auf eine Zielsprache beschränkter Lauf aktualisiert keine bestehende Prüfsummenreferenz des Ausgangstexts. Ein späterer regulärer Lauf kann geänderte Ausgangstexte erneut aufgreifen. Beachte daher die Regeln zum Abschluss, bevor du davon ausgehst, dass eine auf ein Ziel beschränkte Prüfung die Änderungen dauerhaft abschließt.

Region und Schrift berücksichtigen, wo es darauf ankommt #

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

Sprachen mit Regionsangabe unterscheiden die gewünschten Konventionen: Die englischen Varianten color/colour, die spanischen ordenador/computadora und die portugiesischen trem/comboio zeigen, warum die Sprache allein als Auswahl nicht immer ausreicht. Die Verwendung hängt weiterhin vom Kontext ab; ein Sprach-Tag garantiert nicht, dass jede generierte Formulierung zur Zielgruppe passt. Bei Chinesisch können auch Angaben zur Schrift oder Region wie zh-Hans oder zh-TW nötig sein.

Sieh dir die Listen für deine installierte Version an:

sh
lingo show locale sources
lingo show locale targets

Diese Listen garantieren weder, dass jedes Backend das gewählte Sprachpaar unterstützt, noch die Qualität der Ergebnisse. Teste das Sprachpaar mit einem kleinen Lauf, bevor du den Umfang erweiterst, statt dich auf eine frühere Anzahl unterstützter Sprachen zu verlassen.

Sprachidentität und Dateiaufbau getrennt betrachten #

Die Verarbeitung in der älteren Version vereinheitlicht mehrere plattformspezifische Schreibweisen für API-Anfragen. Für Dateien können dennoch Unterstriche oder Namen nach Android-Ressourcenkonventionen nötig sein. Verwende die Trennzeicheneinstellung und den Dateiaufbau des Formats und sieh dir anschließend den tatsächlichen Ausgabepfad an.

Die Übersetzung setzt weder dir noch spiegelt sie Bedienelemente oder fügt Routing hinzu. Arabisch, Hebräisch, Persisch und Urdu benötigen üblicherweise eine Darstellung von rechts nach links (RTL). Kontrolliere die Oberfläche, die diese Inhalte anzeigt, einschließlich eingebetteter Zahlen und Kennungen. Die Anwendung muss eine neue Sprache erkennen und auch deren Inhalte laden können.

Eine Zielsprache entfernen #

Wenn du einen Code aus locale.targets entfernst, wird er künftig nicht mehr ausgewählt. Bestehende Dateien bleiben erhalten. Entscheide unabhängig davon, ob du sie behalten, nicht mehr bereitstellen oder löschen möchtest. Bereinigen ist ein destruktiver Vorgang, bei dem auch Ausgangsinhalte ausgewählt werden können. Das ist nicht dasselbe wie das Entfernen einer konfigurierten Sprache.