Dokumentation / Übersetzen / JSON
JSON-Lokalisierungsdateien übersetzen
Füllen Sie fehlende Übersetzungen in i18next-, react-intl-, vue-i18n-, ngx-translate- und Transloco-JSON-Dateien auf, mit Platzhaltern, ICU-Nachrichten und jeder Pluralform, die jede Sprache benötigt.
Funktionsweise
localize-dev translate liest die JSON-Datei in Ihrer Quellsprache, findet die Schlüssel, die jede andere Sprache vermisst, und schreibt sie in der Schlüsselreihenfolge der Quelldatei hinein, sodass die Dateien sauber verglichen werden können. Bereits vorhandene Übersetzungen werden nicht berührt.
Es kennt die Konventionen jeder Bibliothek: i18next {{name}}, $t(key)-Verschachtelung und _one / _other-Plural-Suffixe, react-intl und next-intl ICU-Nachrichten, vue-i18n |-Plurale, @:key-Links und {'@'}-Literale und Laravel :name.
Vorher und nachher
Reale Ausgabe von localize-dev translate --locales pl in der ersten Datei. Englisch hat zwei Pluralformen. Polnisch hat vier, daher werden _few und _many hinzugefügt.
{
"inbox": {
"title": "Inbox",
"welcome": "Welcome back, {{name}}",
"unread_one": "{{count}} unread message",
"unread_other": "{{count}} unread messages",
"empty": "Nothing here yet. <1>Write a message</1>"
}
}{
"inbox": {
"title": "Skrzynka odbiorcza",
"welcome": "Witaj ponownie, {{name}}",
"unread_one": "{{count}} nieprzeczytana wiadomość",
"unread_few": "{{count}} nieprzeczytane wiadomości",
"unread_many": "{{count}} nieprzeczytanych wiadomości",
"unread_other": "{{count}} nieprzeczytanych wiadomości",
"empty": "Nic tu jeszcze nie ma. <1>Napisz wiadomość</1>"
}
}Was intakt bleibt
- Platzhalter, geprüft: Eine Übersetzung, die einen hinzufügt, löscht oder umbenennt, wird abgelehnt
- Markup wie
<1>…</1>für<Trans> - Jede Pluralform, die die Sprache verwendet:
_fewund_manyim Polnischen, sechs Formen im Arabischen - Schlüsselreihenfolge und Einrückung der Quelldatei
Häufige Fehler und wie sie vermieden werden
Nur _one und _other kopieren
Englisch benötigt zwei Pluralformen, daher sieht eine Datei mit _one und _other vollständig aus. Polnisch, Russisch und Arabisch benötigen mehr, und i18next greift leise auf _other zurück. Jede Form, die die Zielsprache verwendet, wird geschrieben, und ein Plural gilt erst dann als übersetzt, wenn alle vorhanden sind.
Platzhalter, die übersetzt werden
Wenn Sie aufgefordert werden, Welcome back, {{name}} zu übersetzen, übersetzt ein Modell manchmal auch name. Platzhalter werden vor der Übersetzung maskiert und danach überprüft. Eine Übersetzung, die sie ändert, wird erneut versucht, dann weggelassen und gemeldet, aber nie geschrieben.
Pluralformen in einem längeren Satz
Ein ICU-Plural oder -Select, der in anderen Text verschachtelt ist, kann nicht sicher aufgeteilt werden. Plural- und Select-Formen auf oberster Ebene werden Zweig für Zweig übersetzt; verschachtelte werden gemeldet, damit Sie sie von Hand übersetzen können.
Ausführen
In dem Ordner, der Ihre Lokalisierungsdateien enthält. Sprachen ohne eine Datei erhalten eine. --dry-run zeigt, was sich zuerst ändern würde.
npx localize-dev login
# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,deDann halten Sie es in der CI vollständig. Dies erfordert keinen API-Schlüssel und schlägt fehl, wenn eine Sprache Übersetzungen vermisst:
npx localize-dev check --only translationsKostenlos für 1.000 Strings pro Monat. Ein String zählt einmal, egal in wie viele Sprachen er übersetzt wird. Erstellen Sie ein kostenloses Konto
Anleitungen für Apps, die dieses Format verwenden
Wenn der Text noch fest in Ihrem Code codiert ist, verschiebt localize-dev run ihn zuerst in dieses Format.