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.
en:
orders:
title: "Your orders"
shipped: "Shipped to %{city} on %{date}"
items:
one: "%{count} item"
other: "%{count} items"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:undmany:, 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,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.