Comment gérer plusieurs traductions d'un ensemble de documentation écrit avec Sphinx?

Question

Je commence un projet personnel et j'aimerais fournir de la documentation à mes boursiers francophones ainsi qu'aux autres anglophones.

Alors, comment dois-je organiser mes répertoires? Qu'est-ce à séparer (je suppose que les sources, certains éléments conf comme la langue pour les liens de navigation générés ...)? Que ne pas séparer (un maximum d'éléments de configuration pour éviter la duplication)?

Answer 1

Nous avons créé un script Python pour gérer les efforts de traduction de notre documentation. Il crée une structure de répertoire qui ressemble à ceci:

 
    |-- source 
    |-- build 
    | `-- html 
    | `-- latex 
    |-- i18n 
    | `-- fr 
    |  |-- source 
    |  |-- build 
    |  | `-- html 
    |  | `-- latex 

En fait, le sous-répertoire sous i18n/<lang>/ est Reflétant la structure de répertoire Sphinx classique. La page How to translate the Open Object Documentation in your language de notre documentation explique le processus. La documentation est hébergée sur le Launchpad: https://launchpad.net/openobject-doc