Outils pour utilisateurs

Outils du site


dev:python:sphinx:internationalisation

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

dev:python:sphinx:internationalisation [2023/01/02 16:48] – créée yoanndev:python:sphinx:internationalisation [2023/01/02 17:30] (Version actuelle) yoann
Ligne 4: Ligne 4:
  
 ====== Sphinx : traduction de la documentation ====== ====== Sphinx : traduction de la documentation ======
 +
 +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
 +
 +<code bash>
 +pip3 install sphinx-intl
 +</code>
  
  
dev/python/sphinx/internationalisation.1672678138.txt.gz · Dernière modification : 2023/01/02 16:48 de yoann