Die CLI übersetzt aus einer Quell-Sprache in eine oder mehrere Ziel-Sprachen, die beide in .lingo/config.json festgelegt werden:
{
"sourceLocale": "en",
"targetLocales": ["de", "fr", "es", "ja"]
}Quelldateien werden nur gelesen, nie geschrieben. Jede Ziel-Sprache erhält eine eigene Ausgabe, wobei der Sprachcode in das Dateimuster eingesetzt wird (content/en/app.json → content/de/app.json). Siehe Konfiguration.
Sprachcodes#
Verwenden Sie standardisierte BCP 47-Tags. Sowohl ein einfacher Sprachcode (de) als auch ein Sprach-Regions-Tag (de-CH) funktionieren. Die CLI führt keine feste Liste — targetLocales akzeptiert jedes Tag und reicht es an Ihre Engine weiter. Welche Sprachen tatsächlich übersetzt werden und wie gut, hängt vom Modellspektrum der Engine ab, nicht von einer Einschränkung der CLI.
Gängige Beispiele:
| Sprache | Code |
|---|---|
| Englisch | en (oder en-US, en-GB) |
| Spanisch | es (oder es-ES, es-419, es-MX) |
| Französisch | fr (oder fr-FR, fr-CA) |
| Deutsch | de (oder de-CH, de-AT) |
| Portugiesisch | pt-BR, pt-PT |
| Chinesisch | zh-Hans, zh-Hant |
| Japanisch | ja |
| Koreanisch | ko |
Regionale Varianten#
Wählen Sie eine Region, wenn der Dialekt eine Rolle spielt — die Engine liefert passende Schreibweisen und den entsprechenden Wortschatz:
{
"sourceLocale": "en-US",
"targetLocales": ["en-GB", "es-ES", "es-419", "pt-BR", "pt-PT", "fr-CA"]
}en-US → en-GB macht aus "color" "colour"; es-ES → es-419 ersetzt "ordenador" durch "computadora". Wie gut diese Unterschiede getroffen werden, hängt von der Markenstimme und den Anweisungen Ihrer Engine ab, nicht von der CLI.
Rechts-nach-links-Sprachen#
RTL-Sprachen (Arabisch ar, Hebräisch he, Persisch fa, Urdu ur) werden wie alle anderen übersetzt. Die Textrichtung in Ihrer App ist Aufgabe Ihres Renderers; die CLI liefert nur die übersetzten Strings.
Eine Sprache hinzufügen oder entfernen#
Die einzige Änderung ist das Bearbeiten von targetLocales. Um eine neu hinzugefügte Sprache zu befüllen, führen Sie lingo push --backfill-missing aus — siehe Eine Sprache hinzufügen. Wenn Sie eine Sprache entfernen möchten, löschen Sie sie und ihre Dateien mit lingo purge --locale.
