Traduire les fichiers .po gettext
Remplissez les entrées vides et floues dans les fichiers .po de Django, WordPress, PHP et Python, avec des emplacements msgstr[n] de Plural-Forms de chaque langue et msgctxt et commentaires du traducteur comme contexte.
Comment ça marche
Dans gettext, chaque fichier .po d'une langue conserve sa propre copie du texte source, de sorte que localize-dev translate traite chaque fichier comme un catalogue : il remplit les entrées dont le msgstr est vide ou marqué comme flou et laisse les entrées traduites intactes. Les entrées obsolètes #~ sont ignorées.
Les commentaires du traducteur (#.) et msgctxt vont au modèle comme contexte, de sorte que « Archiver » sur un bouton est traduit par un verbe. Une nouvelle langue (--locales pl) obtient son propre fichier à côté d'un fichier existant, avec son en-tête Language et Plural-Forms. Compilez comme d'habitude ensuite : python manage.py compilemessages pour Django, msgfmt ailleurs.
Avant et après
Sortie réelle de localize-dev translate --locales de,pl sur le premier fichier. Le fichier allemand contenait deux entrées vides et une entrée floue. Avec --locales de,pl, elles ont été remplies, et le fichier polonais ci-dessous a été créé avec trois emplacements pour les pluriels.
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"Ce qui reste intact
- Espaces réservés
%(name)s,{name}et printf, vérifiés - Un
msgstr[n]par emplacement des Plural-Forms de la langue : 3 pour le polonais, 6 pour l'arabe - L'en-tête, les commentaires du traducteur et l'ordre des entrées
msgctxt, de sorte que le même msgid puisse être traduit différemment selon le contexte
Erreurs courantes et comment elles sont évitées
Entrées floues laissées derrière
gettext ignore les entrées floues lors de la compilation, de sorte qu'une traduction obsolète revient silencieusement au texte source. Les entrées floues sont retraduites et le drapeau est effacé.
Le mauvais nombre d'emplacements de pluriel
Un fichier copié de l'allemand a deux emplacements msgstr[n] ; le polonais en a besoin de trois. Le Plural-Forms du nouveau fichier est défini pour sa langue, et chaque emplacement reçoit la forme pour les nombres qui y tombent.
Espaces réservés réorganisés
Les espaces réservés sans nom %s signifient quelque chose par leur position. Une traduction qui les réorganise est rejetée. Ceux qui sont nommés comme %(email)s peuvent se déplacer partout où la phrase en a besoin.
Exécuter
Dans le dossier qui contient vos fichiers de langue. Les langues sans fichier en obtiennent un. --dry-run montre ce qui changerait en premier.
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,deEnsuite, gardez-le complet dans la CI. Cela ne nécessite pas de clé API et échoue lorsqu'une langue manque de traductions :
npx localize-dev check --only translationsGratuit pour 1 000 chaînes par mois. Une chaîne compte une fois, peu importe dans combien de langues elle va. Créez un compte gratuit
Guides pour les applications qui utilisent ce format
Lorsque le texte est encore codé en dur dans votre code, localize-dev run le déplace d'abord dans ce format.