localize.dev

Dokumentation / Übersetzen / gettext .po

gettext .po-Dateien übersetzen

Füllen Sie leere und unscharfe Einträge in .po-Dateien von Django, WordPress, PHP und Python, mit msgstr[n]-Slots aus Plural-Forms jeder Sprache sowie msgctxt und Übersetzerkommentaren als Kontext.

Funktionsweise

In gettext enthält jede .po-Datei einer Sprache ihre eigene Kopie des Quelltextes, sodass localize-dev translate jede Datei als Katalog behandelt: Es füllt Einträge, deren msgstr leer oder als fuzzy markiert ist, und lässt übersetzte Einträge unberührt. Veraltete #~-Einträge werden übersprungen.

Übersetzerkommentare (#.) und msgctxt gehen als Kontext in das Modell ein, sodass „Archiv“ auf einem Button als Verb übersetzt wird. Eine neue Sprache (--locales pl) erhält ihre eigene Datei neben einer vorhandenen, mit ihrem Language- und Plural-Forms-Header. Kompilieren Sie danach wie gewohnt: python manage.py compilemessages für Django, msgfmt anderswo.

Vorher und nachher

Reale Ausgabe von localize-dev translate --locales de,pl in der ersten Datei. Die deutsche Datei hatte zwei leere und eine unscharfe Eintragung. Mit --locales de,pl wurden sie gefüllt, und die unten stehende polnische Datei wurde mit drei Plural-Slots erstellt.

locale/de/LC_MESSAGES/django.po
msgid ""
msgstr ""
"Language: de\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"

#. Heading on the account page
msgid "Your account"
msgstr ""

#, fuzzy
msgid "Signed in as %(email)s"
msgstr "Angemeldet als"

msgctxt "verb, on a button"
msgid "Archive"
msgstr ""

msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] ""
msgstr[1] ""
locale/pl/LC_MESSAGES/django.po · Polnisch
msgid ""
msgstr ""
"Language: pl\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"

#. Heading on the account page
msgid "Your account"
msgstr "Twoje konto"

msgid "Signed in as %(email)s"
msgstr "Zalogowano jako %(email)s"

msgctxt "verb, on a button"
msgid "Archive"
msgstr "Archiwizuj"

msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] "%(count)s plik przesłany"
msgstr[1] "%(count)s pliki przesłane"
msgstr[2] "%(count)s plików przesłanych"

Was intakt bleibt

  • %(name)s, {name} und printf-Platzhalter, überprüft
  • Ein msgstr[n] pro Slot der Plural-Forms der Sprache: 3 für Polnisch, 6 für Arabisch
  • Der Header, Übersetzerkommentare und die Reihenfolge der Einträge
  • msgctxt, sodass derselbe msgid je nach Kontext unterschiedlich übersetzt werden kann

Häufige Fehler und wie sie vermieden werden

Zurückgelassene unscharfe Einträge

gettext überspringt unscharfe Einträge beim Kompilieren, sodass eine veraltete Übersetzung stillschweigend auf den Quelltext zurückfällt. Unscharfe Einträge werden erneut übersetzt und das Flag wird gelöscht.

Die falsche Anzahl von Plural-Slots

Eine aus dem Deutschen kopierte Datei hat zwei msgstr[n]-Slots; Polnisch benötigt drei. Die Plural-Forms der neuen Datei sind für ihre Sprache eingestellt, und jeder Slot erhält die Form für die Zahlen, die darin landen.

Neu angeordnete Platzhalter

Unbenannte %s-Platzhalter bedeuten etwas durch ihre Position. Eine Übersetzung, die sie neu anordnet, wird abgelehnt. Benannte wie %(email)s können sich bewegen, wo immer der Satz sie benötigt.

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.