localize.dev

Dokumentation / Übersetzen / Rails YAML

Rails YAML-Locale-Dateien übersetzen

Füllen Sie config/locales/<lang>.yml für Rails und andere YAML-Wörterbücher aus, wobei die %{name}-Interpolation beibehalten und die Pluralzuordnungen one/other auf die Formen jeder Sprache erweitert werden.

Funktionsweise

localize-dev translate liest config/locales/en.yml und Dateien wie devise.en.yml daneben, schreibt dann die fehlenden Schlüssel in die Datei jeder Sprache unter ihrem eigenen Locale-Schlüssel. Eine Sprache ohne Datei erhält eine: devise.en.yml erhält devise.pl.yml.

Rails %{name} und %<name>s, i18n-js {{name}} und printf-Platzhalter bleiben erhalten. Eine Zuordnung von Plural-Kategorien (one:, other:) wird als eine Nachricht behandelt und mit den Kategorien geschrieben, die die Zielsprache verwendet.

Vorher und nachher

Reale Ausgabe von localize-dev translate --locales pl in der ersten Datei. Die Pluralzuordnung items erhält Polnischs few und many, und Werte, die mit % beginnen, bleiben in Anführungszeichen.

config/locales/en.yml
en:
  orders:
    title: "Your orders"
    shipped: "Shipped to %{city} on %{date}"
    items:
      one: "%{count} item"
      other: "%{count} items"
config/locales/pl.yml · Polnisch
pl:
  orders:
    title: Twoje zamówienia
    shipped: Wysłano do %{city} dnia %{date}
    items:
      one: "%{count} przedmiot"
      few: "%{count} przedmioty"
      many: "%{count} przedmiotów"
      other: "%{count} przedmiotów"

Was intakt bleibt

  • %{name}-Interpolation, nach der Übersetzung geprüft
  • Pluralzuordnungen, mit few: und many:, wo die Sprache sie benötigt
  • Die Verschachtelung der Quelldatei unter dem Locale-Schlüssel des Ziels
  • Gültiges YAML: Werte werden zitiert, wo YAML sie benötigt

Häufige Fehler und wie sie vermieden werden

Pluralzuordnungen nur mit one und other

Rails wählt den Plural-Schlüssel nach den Regeln der Sprache. Wenn pl.yml nur one und other hat, haben Zählungen wie 3 oder 25 keine eigene Form. Jede Kategorie, die die Sprache verwendet, wird geschrieben.

Übersetzte Interpolationsnamen

%{city} muss %{city} bleiben, sonst löst Rails zur Laufzeit einen Fehler wegen fehlender Interpolation aus. Platzhalter werden vor der Übersetzung maskiert und danach überprüft.

Fehlerhafte Anführungszeichen

Ein Wert, der mit % beginnt oder : enthält, benötigt Anführungszeichen, und eine manuell bearbeitete Übersetzung verliert diese leicht. Die Datei wird von einer YAML-Bibliothek geschrieben, daher folgt die Anführungszeichensetzung den Regeln von YAML.

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.