YAML
Übersetze Zeichenfolgen in verschachtelten YAML-Strukturen, ohne Katalogschlüssel zu ändern. Wähle einen anderen Handler, wenn die Wurzelebene oder das Schema eine besondere Bedeutung hat.
Der Dateihandler yaml übersetzt Zeichenfolgen in verschachtelten Zuordnungen und Sequenzen. Dabei bleiben die Schlüssel, über die der Anwendungscode Werte nachschlägt, sowie Zahlen und boolesche Werte erhalten. Verwende ihn für Kataloge, deren Struktur in allen Sprachen gleich bleibt.
Passt generisches YAML zu deinem Katalog? #
Dieser Katalog gruppiert beispielsweise Meldungen zum Bestellabschluss ohne umschließenden Sprachschlüssel:
checkout:
title: Complete your order
steps:
- Review your items
- Confirm delivery
retries: 3Der Handler wählt checkout.title und beide Zeichenfolgen in der Sequenz aus. retries bleibt ein numerischer Wert. Eine Kennung in Anführungszeichen würde ebenfalls ausgewählt, da sie eine Zeichenfolge ist. Beachte diesen Unterschied, wenn du entscheidest, welche Daten in den Katalog gehören.
Verwende YAML mit Sprachwurzel für einen umschließenden en:-Schlüssel im Rails-Stil, der durch die Zielsprache ersetzt werden muss. Generisches YAML behält en: bei, selbst wenn sich der Dateiname in es.yml ändert. Rails kann den Inhalt dann ignorieren, weil der Wurzelschlüssel weiterhin Englisch angibt.
Verwende OpenAPI für eine API-Spezifikation. Generisches YAML würde auch Operationskennungen, Referenzen und Beispiele auswählen, die als Zeichenfolgen vorliegen. An der Dateiendung .yml lassen sich diese unterschiedlichen Verwendungszwecke nicht erkennen.
Wiederverwendung und Rekonstruktion #
Die aktuelle Quelle bestimmt die Baumstruktur der Ausgabe. Anhand einer früheren Quelle lässt sich feststellen, ob sich eine Zeichenfolge am jeweiligen Pfad geändert hat. Die vorhandene Zieldatei liefert die Werte für übereinstimmende Pfade. Neue Übersetzungen ersetzen geänderte Zeichenfolgen. Unveränderte Zeichenfolgen können ihre bisherigen Übersetzungen behalten, auch wenn sie über einen Schlüssel- oder Begriffsfilter ausgewählt werden.
Die CLI stellt für --key ihre gespeicherte Ausgangsversion bereit. Deshalb werden unveränderte YAML-Texte mit dieser Auswahl nicht zuverlässig neu erzeugt. Auch das Hinzufügen von --force zum selben Befehl ändert daran nichts. Bearbeite die Zieldatei direkt, wenn du eine gezielte Korrektur vornehmen möchtest. Alternativ kannst du akzeptierte Zieldateien sichern und zur Neugenerierung einen auf ganze Dateien eingegrenzten --force-Lauf ohne --key verwenden. Führe nach dem Ersetzen eine Prüfung der gesamten Datei durch.
Bei der Rekonstruktion sorgt ein YAML-Syntaxbaum dafür, dass Kommentare und die Ankerstruktur beim Ersetzen der Werte erhalten bleiben. Die Serialisierung kann die Formatierung vereinheitlichen. Kommentare bleiben Bestandteil des Dokuments und dienen nicht als Übersetzungsanweisungen. Kontrolliere Aliase mit der Software, die dein YAML verarbeitet – insbesondere dann, wenn ein Wert über mehrere Referenzen eingebunden ist.
Ein auf bestimmte Schlüssel begrenzter Lauf kann eine nicht aufgelöste Zeichenfolge in einer Zuordnung außerhalb des ausgewählten Bereichs verwerfen, wenn kein Zielwert vorhanden ist. Zeichenfolgen in Sequenzen behalten dagegen ihren Quellwert, damit sich die Positionen nicht verschieben. Ein Lauf mit begrenztem Umfang garantiert daher nicht, dass jede Zeichenfolge in der Datei übersetzt ist.
Katalog konfigurieren und laden #
Lege in der CLI-Konfiguration format: "yaml" für .yaml- oder .yml-Quellen ausdrücklich fest. Die Dateierkennung beim Push schließt YAML-Dateien ohne explizite Formatangabe aus. Die GitHub App verwendet eine eigene Repository-Auswahl.
Stimme den Zielpfad auf die Ladefunktion der Anwendung ab. Für eine Quelle wie config/locales/checkout.en.yml muss der Pfad anders abgeleitet werden als für eine Quelle unter locales/en/checkout.yml. Auch die Positionen innerhalb einer Sequenz identifizieren Meldungen: Verschiebst du ein Sequenzelement, kann sich ändern, welche vorhandene Übersetzung ihm zugeordnet wird. Sieh dir den geladenen Katalog nach strukturellen Änderungen an. Nutze für das Nachschlagen in Rails, die Sprachauswahl und das Fallback Eine Rails-App lokalisieren mit dem Handler für YAML mit Sprachwurzel.