[Sphinx] Documentation multilingue sans Gettext

Bonjour,
Je recherche un tutoriel pour écrire une documentation technique anglais/français avec Sphinx sans utiliser Gettext. L'outil GNU Gettext est adapté aux grands projets avec de nombreux contributeurs où le texte est découpé en chaînes séparées (donc à traduire séparément) puis compilation incrémentale pour raison de performance sur les très grandes documentations. Je n'ai pas besoin de tout ça car mon projet est petit et je suis le seul contributeur. De plus il doit contenir des images différentes dans chaque langue car ce sont des copies d'écran, changer les images n'est pas le rôle de Gettext. Il serait plus simple pour moi de tout écrire en anglais et tout réécrire en français, vu que tout est différent d'une langue à l'autre, mais je ne sais pas comment m'y prendre avec Sphinx.
Merci de votre aide.

Salut,

Tu n'as pas d'autre solution que de faire deux documents distincts, donc en compilant une version par langue avec sphinx.

Merci pour ta réponse.
Si je compile chaque langue séparément, comment afficher le petit encart permettant de changer de langue ?

Citation:

---

Envoyé par e-miel

Si je compile chaque langue séparément, comment afficher le petit encart permettant de changer de langue ?

---

Çà c'est le boulot d'une application (à écrire) qui affichera les pages construites par Sphynx.

- W

Pièce jointe 440285
Je parle de cet encart là. Comment le faire apparaître dans ma documentation anglais/français ?

Citation:

---

Envoyé par e-miel

Je parle de cet encart là. Comment le faire apparaître dans ma documentation anglais/français ?

---

La documentation, c'est juste des tas de fichiers fabriqués par Sphynx à partir de RST sous différents formats: HTML, PDF,...
Le reste, c'est juste du code permettra à l'utilisateur de naviguer la dedans (et c'est pas le boulot de Sphynx).

- W

On voit cet encart sur quasiment toutes les documentations Read The Docs, c'est une fonctionnalité standard, pas un nouveau code à écrire. J'aimerais faire apparaître cet encart.

Si c'est pour readthedocs c'est indiqué ici: https://docs.readthedocs.io/en/latest/localization.html

Cette page utilise Gettext.

... le paragraphe suivant https://docs.readthedocs.io/en/lates...e-translations

J'ai bien lu et relu la page indiquée par ton lien depuis quelques mois, mais cette solution est toujours à base de Gettext.

Je viens de trouver cette page : github.com/rtfd/readthedocs.org/issues/4132 qui m'aidera peut-être, même si la question posée au départ est un peu différente.

J'ai tout recommencé en suivant la notice :

sphinx-quickstart

Ajout de ces lignes dans conf.py :

Citation:

---

html_theme = 'sphinx_rtd_theme'
locale_dirs = ['locale/']
gettext_compact = False

---

make gettext

Citation:

---

_build/gettext/index.pot est créé

---

sphinx-intl update -p _build/gettext -l fr

Citation:

---

locale/fr/LC_MESSAGES/index.po est créé
Je traduis index.po

---

sphinx-intl build -d locale -l fr

Citation:

---

locale/fr/LC_MESSAGES/index.mo est créé

---

sphinx-build -b html -D language=fr . _build/html/fr

Citation:

---

_build/html/fr/index.html est créé avec ma traduction de index.po mais ne contient pas le volet de choix de langue

---

sphinx-build -b html . _build/html

Citation:

---

_build/html/index.html est créé dans la langue originale (anglais) mais ne contient pas le volet de choix de langue

---

Comment faire apparaître le volet de choix de langue ? Ai-je oublié quelque chose ?