<div dir="ltr"><div><div><div><div><div><div><div>Hi,<br><br></div>I had a discussion at FOSS4G Europe about using <a href="http://sphinx-doc.org/latest/intl.html">Sphinx internationalization</a> (i18n) instead of the current directory approach.<br><br></div>Why?<br></div>It's already used in QGIS project, MapServer project, Python project,..<br><br></div>The advantages:<br><br></div>* Untied translators and contributors jobs by using Transifex<br></div>* Keeping the translation updated. For instance, if I do a translation in French, then the English doc evolves slightly, it's difficult to track the differences and I need to read nearly everything again or browse the original file history then apply the change in French. It's not friendly IMO<br></div><div>* Do not use symbolic links when missing files: fallback to english directly with i18n and not issue with Git (try to build the doc and do a "git status" to understand)<br></div><div><br></div>If you wonder about the simplicity of Transifex, you can see the MapServer documentation at <a href="http://mapserver.org/fr/development/translation.html">http://mapserver.org/fr/development/translation.html</a><br><div><br></div><div>The drawbacks:<br><br></div><div>* It can't make documents differ per language (strict translation)<br><br></div><div>I've already worked a bit to make things happen about this at the code sprint but I would like to reorganize the documentation to improve the experience.<br><br></div><div>Do you have any opinions before I go further?<br></div><div><br><br></div><div>Cheers<br><br></div><div>Thomas Gratier<br></div></div>