localize.dev

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.

locales/en.json
{
  "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>"
  }
}
locales/pl.json · Polnisch
{
  "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: _few und _many im 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,de

Dann 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 translations

Kostenlos 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.