Gettext
PO-Zielwerte übersetzen, dabei Nachrichtenkontext und Quellidentität bewahren und die Grenzen der Pluralrekonstruktion beachten.
Gettext hält Quelltext und Übersetzung im selben Eintrag fest. Der po-Dateihandler liest msgid und schreibt die Übersetzung in msgstr. Der Quelltext bleibt dabei erhalten. Außerdem nutzt er msgctxt, um identische Wörter in unterschiedlichen Kontexten zu unterscheiden.
Der Kontext unterscheidet Nachrichten #
Diese Einträge können beispielsweise unterschiedliche Übersetzungen für „Back“ erhalten:
msgctxt "checkout navigation"
msgid "Back"
msgstr ""
msgctxt "product surface"
msgid "Back"
msgstr ""Trotz identischem msgid handelt es sich um separate Einheiten. Der Kontext wird zusätzlich als Übersetzungshinweis übergeben. Kommentar- und Markierungszeilen bleiben zusammen mit den Einträgen erhalten. Das bedeutet jedoch nicht, dass jeder Kommentar als Anweisung interpretiert wird oder Markierungen für die Prüfung aktualisiert werden.
Der spezialisierte Parser verarbeitet die unterstützten PO-Felder in Anführungszeichen sowie Fortsetzungszeilen. Verwende UTF-8-Eingaben; beliebige ältere Zeichenkodierungen werden nicht konvertiert. Die automatische Erkennung von .pot gehört nicht zum zugesicherten Funktionsumfang der .po-Ableitung durch die CLI.
Die Pluralrekonstruktion hat Grenzen #
Bei einem Pluraleintrag werden msgid und msgid_plural zu separaten Texteinheiten für Singular und Plural. Der Handler erzeugt mindestens zwei Zielpositionen. Enthält das vorhandene Ziel mehr Positionen, behalten unveränderte Einträge ihre akzeptierten Formen. Ändert sich eine der ersten beiden Zielformen, erhalten die zusätzlichen Positionen den neuen Pluralwert statt unabhängig generierter Formen.
Führe vor dem Kompilieren eine Prüfung der Pluralausgabe durch. Benötigt eine Sprache mehrere unterschiedliche Formen, müssen an jeder Position die passende Formulierung und ein dazu passender Plural-Forms-Header vorliegen. Vorhandene Zielheader haben Vorrang. Bei der ersten Ausgabe wird der Quellheader übernommen und Language auf die Zielsprache geändert. Der Handler passt Plural-Forms nicht an die Zielsprache an.
Aktualisierungen und Serialisierung #
Die vorherige Quelle dient dazu, Änderungen anhand von Kontext, Nachrichtenidentität und Singular-/Pluraleinheit zu erkennen. Aus vorhandenen Zieleinträgen werden die beizubehaltenden msgstr-Werte übernommen. Ändert sich die Quellidentität, kann eine Nachricht als neu gelten, selbst wenn ihre akzeptierte Zielformulierung weiterhin verwendbar wäre.
Bei der Rekonstruktion bleiben Quellfelder, Kommentarzeilen und das umgebende Eintragslayout erhalten. Ersetzt werden die msgstr-Werte und der relevante Header. Übersetzungswerte in Anführungszeichen können dabei neu formatiert werden. Validiere neben dem Parsen der Datei auch die Nachrichtenanzahl und die Pluralmetadaten.
Katalog konfigurieren und kompilieren #
Die CLI leitet po aus .po ab. Wähle die Quellkataloge über die CLI-Konfiguration oder GitHub aus.
Kompiliere oder importiere die Ausgabe mit den Gettext-Werkzeugen der Anwendung. Teste anschließend die Pluralformen für verschiedene Mengen und den kontextspezifischen Abruf. Sieh dir wiederholte Pluralwerte und Header auch dann an, wenn das Parsen erfolgreich ist: Sie bestimmen, was die Anwendung für die jeweilige Menge anzeigt.