[Live-demo] Motion: Changing translation system to use Sphinx internationalization instead of directory approach

[Thomas Gratier]

Hi,

It's possible at the mentioned time. Let's discuss on this topic next week.

Cheers

Thomas Gratier

2015-07-18 15:48 GMT+02:00 Angelos Tzotsos <gcpp.kalxas at gmail.com>:

>  Hi Thomas,
>
> Personally I think this is the best option for sphinx based documentation,
> so you have my +1.
> Would you be able to join our weekly IRC meeting on Wednesday at 20:30 UTC?
>
> Thanks,
> Angelos
>
> On 07/18/2015 04:14 PM, Thomas Gratier wrote:
>
> Hi,
>
> I had a discussion at FOSS4G Europe about using Sphinx internationalization<http://sphinx-doc.org/latest/intl.html> <http://sphinx-doc.org/latest/intl.html> (i18n) instead of the current
> directory approach.
>
> Why?
> It's already used in QGIS project, MapServer project, Python project,..
>
> The advantages:
>
> * Untied translators and contributors jobs by using Transifex
> * 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
> * 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)
>
> If you wonder about the simplicity of Transifex, you can see the MapServer
> documentation at http://mapserver.org/fr/development/translation.html
>
> The drawbacks:
>
> * It can't make documents differ per language (strict translation)
>
> 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.
>
> Do you have any opinions before I go further?
>
>
> Cheers
>
> Thomas Gratier
>
>
>
>
> _______________________________________________
> Live-demo mailing listLive-demo at lists.osgeo.orghttp://lists.osgeo.org/mailman/listinfo/live-demohttp://live.osgeo.orghttp://wiki.osgeo.org/wiki/Live_GIS_Disc
>
>
>
> --
> Angelos Tzotsos, PhD
> OSGeo Charter Memberhttp://users.ntua.gr/tzotsos
>
>
> _______________________________________________
> Live-demo mailing list
> Live-demo at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/live-demo
> http://live.osgeo.org
> http://wiki.osgeo.org/wiki/Live_GIS_Disc
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/live-demo/attachments/20150718/675c804a/attachment.html>