Comment utiliser Poedit : Le guide complet (2026)

Si vous avez déjà ouvert un fichier .po dans un éditeur de texte brut, vous connaissez déjà le sentiment. Des centaines de paires msgid et msgstr, des drapeaux fuzzy éparpillés partout, et une seule mauvaise frappe pouvant briser le catalogue entier. Il existe une meilleure solution, et depuis plus d'une décennie, la réponse standard a été la même application de bureau : Poedit.

Ce tutoriel Poedit vous guide à travers toutes les étapes, de l'installation de l'application à la compilation de votre premier fichier .mo. Que vous traduisiez un thème WordPress, une extension ou votre propre projet basé sur Gettext, Poedit vous offre un éditeur visuel épuré qui masque le format de fichier brut et vous permet de vous concentrer sur le travail de traduction réel.

À la fin de ce guide, vous comprendrez l'interface de Poedit, saurez comment démarrer une traduction à partir d'un modèle .pot, utiliserez la mémoire de traduction pour accélérer les choses, et reconnaîtrez exactement où l'outil de bureau gratuit cesse d'être efficace, afin de savoir quand opter plutôt pour un flux de travail basé sur le cloud.

Qu'est-ce que Poedit et comment l'installer ?

Poedit est un éditeur de bureau gratuit et multiplateforme pour les fichiers de traduction Gettext (.po, .pot et le fichier compilé .mo). Il fonctionne sur macOS, Windows et Linux, et c'est le point de départ le plus largement recommandé pour toute personne éditant manuellement des catalogues de traduction.

L'installation est simple. Rendez-vous sur le site officiel de Poedit et téléchargez l'installateur pour votre système d'exploitation, ou utilisez un gestionnaire de paquets.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

La version gratuite couvre entièrement l'expérience d'édition de base. Il existe une version payante Poedit Pro qui ajoute l'analyse du code source et la pré-traduction, que nous aborderons plus tard. Pour l'instant, le téléchargement gratuit est tout ce dont vous avez besoin pour ouvrir et éditer n'importe quel catalogue.

Si vous souhaitez avoir une vue d'ensemble plus large du paysage de l'édition avant de vous engager, notre récapitulatif des meilleurs outils gratuits pour éditer et traduire des fichiers PO sur Mac et Windows compare Poedit aux principales alternatives.

Comprendre l'interface de Poedit

Lorsque vous ouvrez un fichier .po (Fichier, puis Ouvrir, ou simplement en glissant le fichier sur la fenêtre), Poedit présente une disposition en trois zones qui correspond directement à la structure Gettext sous-jacente.

Les volets Source et Traduction

La zone principale est une liste à deux colonnes. La colonne de gauche affiche la chaîne source (msgid) exactement telle que le développeur l'a écrite dans le code. La colonne de droite affiche votre traduction (msgstr). Cliquer sur une ligne la charge dans le panneau d'édition en bas, où vous tapez le texte traduit.

Considérez cette entrée brute dans le fichier :

#: includes/checkout.php:142
msgid "Your order has been placed."
msgstr ""

Dans Poedit, cette même entrée apparaît comme une seule ligne : la source à gauche, une cellule de traduction vide à droite. Vous ne touchez jamais à la syntaxe brute. Il vous suffit de taper dans le panneau inférieur et Poedit écrit le msgstr pour vous.

Drapeaux Fuzzy et couleurs d'état

Poedit code les lignes par couleur afin que vous puissiez voir l'état du catalogue en un coup d'œil. Les chaînes non traduites se distinguent, et les chaînes fuzzy (floues), entrées marquées #, fuzzy dans le fichier parce que la source a changé ou que la traduction a été automatiquement appariée, apparaissent dans une couleur distincte (généralement orange ou jaune). Les chaînes fuzzy sont essentiellement des indicateurs « à revoir ». WordPress ne les affichera pas sur le site en direct, il est donc important de les effacer. Vous pouvez basculer l'état fuzzy sur n'importe quelle ligne avec un seul raccourci une fois que vous avez confirmé que la traduction est correcte.

Une barre d'état en bas affiche votre progression : le nombre total de chaînes, combien sont traduites, et combien restent fuzzy ou non traduites.

Le panneau d'édition inférieur affiche également un contexte utile. Il montre le commentaire de référence source, la ligne de code où la chaîne est utilisée (par exemple #: includes/checkout.php:142), et toutes les notes de développeur laissées dans le fichier. Ces commentaires sont inestimables lorsqu'une courte chaîne comme « Order » pourrait être un nom ou un verbe, la référence source vous indique à quel fichier et à quelle fonctionnalité elle appartient, afin que vous la traduisiez correctement du premier coup. Passer quelques secondes à lire ce contexte fait la différence entre un catalogue précis et un catalogue rempli de tournures maladroites et déplacées.

Comment démarrer une nouvelle traduction à partir d'un fichier POT ?

Un fichier .pot est un modèle contenant chaque chaîne source avec des traductions vides. Pour commencer une toute nouvelle langue, vous créez un fichier .po à partir de ce modèle plutôt que d'éditer directement le .pot.

Dans Poedit, choisissez Fichier puis Nouveau à partir d'un fichier POT/PO, sélectionnez le fichier .pot du thème ou de l'extension (généralement dans son dossier /languages), et choisissez votre langue cible. Poedit demande ensuite la langue et génère un nouveau catalogue avec la convention de nom de fichier correcte, par exemple de_DE.po pour l'allemand.

Configuration de l'en-tête du catalogue et des formes plurielles

Chaque fichier .po contient un bloc d'en-tête, et le champ le plus important pour la correction est Plural-Forms. Cette expression indique à Gettext combien de variantes plurielles une langue nécessite et laquelle choisir pour un nombre donné.

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

L'anglais utilise deux formes. Des langues comme le polonais et le russe en nécessitent trois ou plus, et une erreur dans cet en-tête produit des comptes grammaticalement incorrects. Poedit définit une valeur par défaut raisonnable lorsque vous choisissez la langue, mais vous pouvez la revoir et la modifier sous Catalogue, puis Propriétés. Si vous souhaitez comprendre plus en profondeur pourquoi cet en-tête est si facile à mal configurer, consultez notre guide sur les pluriels Gettext et la pluralisation complexe.

Les Propriétés du catalogue vous permettent également de définir le nom du projet, le nom et l'adresse e-mail du traducteur, l'équipe linguistique et l'encodage des caractères. L'encodage des caractères devrait presque toujours être UTF-8; tout autre encodage risque d'altérer les caractères accentués et les scripts non latins. Poedit utilise UTF-8 par défaut pour les nouveaux fichiers, mais si vous héritez d'un catalogue plus ancien, il est utile de le confirmer. Configurer correctement l'en-tête une seule fois au début vous évite de refaire le travail plus tard.

Une fois configuré, il vous suffit de parcourir la liste, en traduisant chaque ligne. Poedit enregistre automatiquement votre position, vous pouvez donc fermer l'application au milieu du catalogue et reprendre exactement là où vous vous étiez arrêté. Pour les longs catalogues, les raccourcis clavier pour passer à la chaîne non traduite suivante ou à la chaîne fuzzy suivante vous permettent de continuer sans faire défiler, ce qui est là où la majeure partie du temps est perdue lors de l'édition manuelle.

Mémoire de traduction et la distinction entre version gratuite et Pro

L'une des fonctionnalités les plus utiles de Poedit est la mémoire de traduction (MT). Au fur et à mesure que vous traduisez, Poedit mémorise chaque paire source-traduction. La prochaine fois qu'une chaîne source identique ou similaire apparaît, dans le même fichier ou un projet différent, Poedit suggère automatiquement votre traduction précédente. Au fil des mois de travail, cela se transforme en une base de données personnelle qui accélère considérablement la traduction des chaînes d'interface utilisateur répétitives comme « Enregistrer », « Annuler » et « Ajouter au panier ».

Les suggestions de MT apparaissent dans le panneau d'édition, et vous pouvez les accepter d'une simple touche. Notez que les entrées remplies par la MT sont souvent marquées comme fuzzy par défaut, vous devez donc les revoir avant de supprimer le drapeau.

Qu'apporte Poedit Pro ?

L'éditeur gratuit gère entièrement la traduction manuelle. Poedit Pro (une mise à niveau payante) ajoute deux fonctionnalités phares :

• Analyse du code source : Pro peut analyser votre code source PHP ou JavaScript, trouver chaque appel Gettext __() et _e(), et extraire un nouveau fichier .pot ou mettre à jour un catalogue existant, sans nécessiter de ligne de commande.
• Pré-traduction : Pro propose une pré-traduction automatique pour l'ensemble du catalogue, mais cela fonctionne sur un modèle payant, basé sur des crédits. Vous achetez des crédits, et les grands catalogues les consomment rapidement.

Pour une seule langue et un catalogue modeste, Pro est pratique. La limitation honnête est l'échelle. Les crédits de pré-traduction s'accumulent, et le flux de travail reste fondamentalement un fichier, une langue, une session de bureau à la fois.

Il est également important de clarifier ce que la mémoire de traduction fait et ne fait pas. La MT ne suggère que les traductions que vous (ou une base de données d'équipe partagée) avez déjà produites. Pour un tout nouveau projet sans historique, la mémoire est vide, elle n'offre donc rien tant que vous n'avez pas déjà traduit une partie significative à la main. La MT accélère les chaînes répétitives et récurrentes ; elle ne traduit pas de nouveau contenu net. Cette distinction est importante lorsque vous estimez le temps que prendra un nouveau catalogue, car la première langue est toujours la plus lente, et chaque langue suivante commence à partir de zéro, à moins que ses chaînes ne se chevauchent.

Enregistrer votre travail et compiler les fichiers MO

Pourquoi WordPress a-t-il besoin d'un fichier .mo alors que vous n'avez édité qu'un fichier .po ? Parce que WordPress lit le fichier binaire compilé .mo à l'exécution, et non le fichier .po lisible par l'homme. La bonne nouvelle est que Poedit gère cela automatiquement.

Lorsque vous appuyez sur Enregistrer, Poedit écrit le fichier .po et, par défaut, compile le fichier .mo correspondant dans le même dossier.

# After saving in Poedit you get both files:
wp-content/languages/themes/
  storefront-de_DE.po   # editable source
  storefront-de_DE.mo   # compiled binary WordPress loads

Si l'enregistrement ne produit pas de fichier .mo, vérifiez dans Préférences, puis Général et confirmez que l'option « Compiler automatiquement le fichier MO lors de l'enregistrement » est activée. Un fichier .mo manquant ou obsolète est l'une des raisons les plus courantes pour lesquelles une traduction terminée n'apparaît jamais sur le site en direct. Si vous rencontrez ce problème, notre guide de dépannage pour les traductions qui n'apparaissent pas dans WordPress couvre la liste complète des vérifications.

Quand Poedit ne suffit plus : passer au-delà de l'ordinateur de bureau

Poedit est excellent pour ce qu'il est : un éditeur précis, manuel, de fichier unique. La friction apparaît dès que vos besoins augmentent. Traduire une extension en douze langues signifie douze sessions distinctes. Un catalogue de 10 Mo avec des milliers de chaînes signifie des heures de saisie ou l'épuisement des crédits de pré-traduction. Et les modifications manuelles comportent toujours le risque de mal gérer un placeholder comme %s ou %1$s et de casser silencieusement la sortie.

C'est exactement là qu'un flux de travail basé sur le cloud prend le relais. SimplePoTranslate traite votre catalogue via une IA sensible au contexte avec le Verrouillage Syntaxique, qui fige chaque %s, %1$s, {name} et balise HTML afin que la structure ne puisse jamais être rompue pendant la traduction. Le Traitement par Lots Intelligent gère les fichiers de plus de 10 Mo sans division manuelle, et vous récupérez le résultat sous forme de fichier ZIP prêt à être déployé contenant les fichiers .po, .mo, .json, .php et .xliff en une seule fois, le tout dans le cloud, sans installation de bureau ni superflu.

Utilisez Poedit pour le réglage fin et la révision, le travail qu'il fait le mieux. Utilisez le cloud lorsque vous avez besoin d'une vitesse de traitement en masse pour de nombreuses langues sans sacrifier la sécurité des placeholders.

Prêt à traduire des catalogues entiers dans des dizaines de langues sans passer des heures dans l'éditeur de bureau ? Essayez SimplePoTranslate gratuitement — aucune carte de crédit requise. Le niveau gratuit vous permet de traduire votre premier fichier .po en quelques minutes, avec le Verrouillage Syntaxique sur chaque chaîne.