GNU gettext PO (Portable Object)¶

Format le plus largement utilisé pour la traduction des logiciels libres.

Les informations contextuelles stockées dans le fichier sont prises en charge en ajustant ses en-têtes ou en établissant des liens avec les fichiers sources correspondants.

Voir aussi

Affichage de la modification de la chaîne source¶

Weblate can extract previous source strings from the PO files if present and show the string difference for strings needing editing based on that. To include these, msgmerge has to be executed with --previous and the resulting PO file then contains lines such as:

#, fuzzy
#| msgid "previous-untranslated-string"
msgid "untranslated-string"
msgstr "translated-string"

entête de fichier PO¶

The header of the PO file is automatically maintained by Weblate. It can be configured to include the Language-Team, Last-Translator, X-Generator and Report-Msgid-Bugs-To headers using the Paramètres du format de fichier.

The header comments also can be updated to contain author names using Contributeurs dans le commentaire.

Line wrapping¶

The line wrapping mostly matches GNU gettext behavior. Both the wrapping algorithm in the GNU gettext and the Unicode data the wrapping is based on evolve which might cause differences in some corner cases.

The wrapping width can be configured using the po_line_wrap parameter, see Paramètres du format de fichier.

Generating matching MO files¶

In case MO files are kept in the repository together with PO files, Générer des fichiers MO can be used to keep them up-to-date with PO files.

Updating PO files from the POT file¶

Mettre à jour les fichiers PO afin qu’ils correspondent au POT (msgmerge) can be used to update PO files from the POT file, see Mise à jour des fichiers de langue cible.

Gettext monolingue¶

Certains projets décident d’utiliser gettext comme format monolingue — ils codifient uniquement les identifiants dans leur code source et la chaîne doit ensuite être traduite dans toutes les langues, y compris en anglais. Cela est pris en charge, mais il est nécessaire d’explicitement choisir ce format de fichier lors de l’importation du composant dans Weblate.

Fichiers d’exemples¶

Un fichier PO gettext bilingue ressemble généralement à ceci :

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "Monday"
msgstr "Pondělí"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "Tuesday"
msgstr "Úterý"

#: weblate/accounts/avatar.py:163
msgctxt "No known user"
msgid "None"
msgstr "Žádný"

Un fichier gettext PO monolingue ressemble généralement à ceci :

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-monday"
msgstr "Pondělí"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-tuesday"
msgstr "Úterý"

#: weblate/accounts/avatar.py:163
msgid "none-user"
msgstr "Žádný"

Tandis que le fichier de langue de base ressemblera à ceci :

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-monday"
msgstr "Monday"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-tuesday"
msgstr "Tuesday"

#: weblate/accounts/avatar.py:163
msgid "none-user"
msgstr "None"

Fonctionnalités prises en charge¶
File extensions	`.po`, `.pot`
Linguality ⓘ	Monolingual
Supports plural ⓘ	`Yes`
Supports descriptions ⓘ	`Yes`
Supports explanation ⓘ	`No`
Supports context ⓘ	`Yes`
Supports location ⓘ	`Yes`
Supports flags ⓘ	`Yes`
Additional states ⓘ	`Needs editing`
API identifier	`po-mono`
Supports read-only strings ⓘ	`No`

Fonctionnalités prises en charge¶
File extensions	`.po`, `.pot`
Linguality ⓘ	Bilingual
Supports plural ⓘ	`Yes`
Supports descriptions ⓘ	`Yes`
Supports explanation ⓘ	`No`
Supports context ⓘ	`Yes`
Supports location ⓘ	`Yes`
Supports flags ⓘ	`Yes`
Additional states ⓘ	`Needs editing`
API identifier	`po`
Supports read-only strings ⓘ	`No`

Configuration Weblate¶

Configuration des composants typique de Weblate pour les gettext bilingues
Masque de fichier	`po/*.po`
Fichier de langue de base mono-langue	Vide
Modèle pour les nouvelles traductions	`po/messages.pot`
Format de fichier	Fichier gettext PO

Configuration des composants typique de Weblate pour gettext monolingue
Masque de fichier	`po/*.po`
Fichier de langue de base mono-langue	`po/en.po`
Modèle pour les nouvelles traductions	`po/messages.pot`
Format de fichier	Fichier gettext PO (monolingue)

Paramètres du format de fichier¶

Paramètres du format de fichier with the pattern po_* can be used to configure the behavior of the gettext format.