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.
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] ""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,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.