Discussion :

[e-miel]

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.

[VinsS]

Salut,

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

[e-miel]

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

[wiztricks]

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

[e-miel]

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

[wiztricks]

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

[e-miel]

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.

[VinsS]

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

[e-miel]

Cette page utilise Gettext.

[VinsS]

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

[e-miel]

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.

[e-miel]

J'ai tout recommencé en suivant la notice :

sphinx-quickstart

Ajout de ces lignes dans conf.py :

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

make gettext

_build/gettext/index.pot est créé

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

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

sphinx-intl build -d locale -l fr

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

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

_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

_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 ?