I am thinking out loud here: This is an interesting question. I can imagine for some types of text (i.e. instructions) it would be easier to keep consistent is the various language versions were in the same file, output by selector (so the .rst files themselves become self-contained translation files), and for other situations (where concepts are more important) that context be coherently developed in one language. I wonder if having the former structure (language conditional selector) could be the useful base - and larger context sections be included from files, e.g. something that looks like: -------------------------------- .. lang:: en Contents .. lang:: fr Contenu .. lang:: it Soddisfare
.. include:: chapter1.%lang%.rst or perhaps .. include:: %lang$/chapter1.rst ------------------------------------ The form I've written might be wrong - I mainly want to get the concept accross .... at the top of the file, or at build time, some language (or lang) setting would be made... I wonder if this wouldn't be useful and flexible idiom for authors? Reasonable to implement? Regards, Yarko On Mon, Nov 17, 2008 at 5:27 AM, Christophe de VIENNE <[EMAIL PROTECTED]>wrote: > > Hi, > > I will need to maintain my documentation in french and in english. I > would like to know if some of you do such a thing, and how to you > proceed ? > My idea is to have two different roots, en and fr which are totally > independent. I wonder if there is anything in sphinx to make this > easier. > > Especially for the autodoc extension : It would be great if I could > have both versions as docstrings with a directive to tell sphinx the > language of the text. > > Thanks for any hint on this issue, > > Christophe > > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
