Sphinx s'appuie sur gettext pour l'internationalisation de l'ensemble des documents produits. De façon générale gettext fait correspondre à un message du programme une chaîne de caractères traduite.

Dans un premier temps il faut collecter l'ensemble des chaînes de caractères pouvant être traduites (que l'on désigne messages). Sphinx extrait les messages via la commande sphinx-build -b gettext.

Ce processus d'extraction des messages produit un ensemble de fichiers d'extension *.pot. Ce sont des fichiers catalogues ne contenant que les messages en langue originale.

Ces fichiers peuvent être fournis aux traducteurs qui les transforment en fichiers *.po

Ajouter le module

pip3 install sphinx-intl

• https://www.sphinx-doc.org/en/master/usage/advanced/intl.html