Gettext

Traduisez les valeurs cibles des fichiers PO en préservant le contexte des messages et l’identité de la source, tout en tenant compte des limites de la reconstruction des pluriels.

Gettext conserve le texte source et sa traduction dans une même entrée. Le gestionnaire de fichiers po lit msgid et écrit la traduction dans msgstr, en laissant la source intacte. Il utilise aussi msgctxt pour distinguer des mots identiques employés dans des contextes différents.

Le contexte distingue les messages #

Par exemple, ces entrées peuvent recevoir des traductions différentes du mot « Back » :

text
msgctxt "checkout navigation"
msgid "Back"
msgstr ""

msgctxt "product surface"
msgid "Back"
msgstr ""

Ces unités sont distinctes malgré leur msgid identique. Le contexte sert également d’indication pour la traduction. Les lignes de commentaires et d’indicateurs sont conservées avec les entrées, mais cela ne signifie pas que chaque commentaire est interprété comme une instruction ni que les indicateurs de relecture sont mis à jour.

L’analyseur spécialisé prend en charge les champs PO entre guillemets et les lignes de continuation compatibles. Utilisez des fichiers d’entrée en UTF-8 ; il ne convertit pas les anciens encodages quelconques. La détection automatique de .pot ne relève pas des garanties d’inférence de .po offertes par la CLI.

La reconstruction des pluriels a ses limites #

Pour une entrée au pluriel, msgid et msgid_plural deviennent deux unités de texte distinctes : l’une au singulier, l’autre au pluriel. Le gestionnaire produit au moins deux emplacements cibles. Si la cible existante en comporte davantage, les entrées inchangées conservent leurs formes acceptées. Lorsque l’une des deux premières formes cibles change, les emplacements supplémentaires reçoivent la nouvelle valeur au pluriel, et non des formes générées indépendamment.

Relisez les formes plurielles produites avant de les compiler. Pour une langue qui nécessite plusieurs formes distinctes, chaque emplacement doit contenir le texte approprié et l’en-tête Plural-Forms doit correspondre à ces formes. Les en-têtes cibles existants sont privilégiés ; lors de la première sortie, l’en-tête source est repris et Language est modifié pour indiquer la langue cible. Le gestionnaire ne réécrit pas Plural-Forms pour la langue cible.

Mises à jour et sérialisation #

La source précédente permet d’identifier les changements selon le contexte, l’identité du message et l’unité au singulier ou au pluriel. Les entrées cibles existantes fournissent les valeurs msgstr à conserver. Un changement d’identité de la source peut faire considérer un message comme nouveau, même si sa traduction acceptée reste utile.

La reconstruction conserve les champs sources, les lignes de commentaires et la disposition autour des entrées, tout en remplaçant les valeurs msgstr et l’en-tête concerné. Les valeurs de traduction entre guillemets peuvent être remises en forme. Vérifiez que le fichier peut être analysé, mais validez aussi le nombre de messages et les métadonnées des pluriels.

Configurer et compiler le catalogue #

La CLI déduit po à partir de .po. Sélectionnez les catalogues sources dans la configuration de la CLI ou via GitHub.

Compilez ou importez le résultat à l’aide des outils Gettext de l’application, puis testez les différentes quantités au pluriel et la recherche de messages selon le contexte. Examinez les valeurs plurielles répétées et les en-têtes même si l’analyse réussit : ils déterminent ce que l’application affiche pour chaque quantité.