YAML mit Sprachwurzel
Übersetze die Werte unter einer Sprachwurzel und benenne die Wurzel passend zur Zielsprache um.
Rails liest die Sprache aus der Wurzel einer YAML-Datei. Eine Datei namens checkout.es.yml definiert weiterhin englische Ressourcen, wenn ihre Wurzel en: lautet. Der Handler yaml-root-key übersetzt die Nachrichten unter dieser Wurzel und stellt die Wurzel auf die Zielsprache um. So bleiben die Zugriffspfade über alle Sprachen hinweg konsistent.
Sprachwurzel und Nachrichtenpfade #
Ein Quellkatalog kann sowohl Interpolationen als auch Pluralzweige enthalten:
en:
checkout:
greeting: Hello, %{name}
items:
one: One item
other: "%{count} items"Die Nachrichtenpfade lauten checkout.greeting, checkout.items.one und checkout.items.other. Sie enthalten en nicht, sodass die englische Quelle und das spanische Ziel dieselben Nachrichtenkennungen verwenden können. Die Sprachwurzel im Ziel wird zu es; checkout, one und other bleiben als Schlüssel erhalten.
Die Interpolationssyntax und die Namen der Pluralkategorien gehören zu den verbindlichen Vorgaben der Anwendung. Das Übersetzen der Wörter konfiguriert weder die Pluralregeln von Rails noch ergänzt es alle für die Zielsprache erforderlichen Kategorien. Lass die relevanten Mengenangaben und Variablen in der Anwendung darstellen, bevor du die Ressourcen akzeptierst.
Der Parser benötigt genau ein Schlüssel-Wert-Paar auf Wurzelebene mit einem skalaren Schlüssel und einer darunterliegenden Zuordnung. Eine leere Sprache ist zulässig. Eine skalare Nachricht oder eine Liste direkt unter der Wurzel wird dagegen abgelehnt. Teile eine YAML-Datei mit mehreren Sprachen in separate Dateien pro Sprache auf oder verwende generisches YAML, wenn du alle Wurzeln unverändert beibehalten möchtest. Wähle diesen Handler nicht für eine OpenAPI-Spezifikation.
Aktualisierungen und eingeschränkter Umfang #
Verschachtelte Zeichenfolgenwerte werden anhand ihrer Pfade unterhalb der Sprachwurzel verglichen. Die aktuelle Quelle gibt die Struktur vor; die vorherige Quelle und das vorhandene Ziel ermöglichen die Übernahme unveränderter Werte. Kommentare und Anker durchlaufen die Serialisierung des YAML-Baums. Dabei kann die Formatierung vereinheitlicht werden.
Auch bei einer Einschränkung auf bestimmte Schlüssel oder Begriffe lassen sich unveränderte Übersetzungen wiederverwenden, wenn eine vorherige Quelle vorliegt. --key der CLI verwendet den gespeicherten Referenzstand. Das Hinzufügen von --force hebt diese Wiederverwendung nicht auf. Bearbeite das Ziel direkt, wenn du eine Formulierung gezielt korrigieren möchtest. Um die Datei nach einer Änderung der Vorgaben neu zu generieren, speichere die akzeptierten Zielübersetzungen und verwende einen auf den gewünschten Umfang beschränkten --force für die gesamte Datei ohne --key. Sieh dir anschließend jede geänderte Nachricht an.
Bei einer Einschränkung auf bestimmte Schlüssel können nicht aufgelöste Zeichenfolgen in Zuordnungen außerhalb des gewählten Umfangs entfallen. Sequenzelemente behalten die Quellwerte bei, statt ihre Position zu verschieben. Kontrolliere die Vollständigkeit unabhängig davon, ob das Parsen erfolgreich war – besonders dann, wenn du eine neue Sprache auf Basis eines eng begrenzten Umfangs erstellst.
Sprache und Ziel konfigurieren #
Lege format: "yaml-root-key" für Quellen vom Typ .yml oder .yaml ausdrücklich fest. An der Dateiendung lässt sich die Sprachwurzel nicht erkennen. Unter CLI-Konfiguration und GitHub findest du Informationen zu Dateimustern und Zielstrukturen.
Die Rekonstruktion benötigt eine Zielsprache und schlägt fehl, wenn keine angegeben ist. localeFormat der CLI ändert die Schreibweise des Pfads, nicht die in der YAML-Datei eingetragene Sprache. Sieh dir sowohl das Ziel als auch dessen Wurzel an und lade anschließend eine Begrüßung und eine Pluralnachricht über Rails. Eine Rails-App lokalisieren erläutert, wie diese Dateien mit der Sprachauswahl für Anfragen, Hilfsfunktionen und dem Fallback-Verhalten zusammenhängen.