[ckan-dev] doc translation

Tue Jun 26 11:34:29 UTC 2012

On 26 June 2012 10:44, Sean Hammond <sean.hammond at okfn.org> wrote:
>> Hi, Is it possible to translate [1]http://docs.ckan.org/ ?  The url
>> [2]http://docs.ckan.org/fr/latest/api.html seems to exist but displays
>> content in English :)
>
> The docs haven't (yet) been translated into any language other than
> English. I'd be worried about translating the docs without a good way of
> managing the translations, just because the docs are quite long and they
> change fairly frequently. We'd need a way of managing translations and
> knowing which lines of the docs have been translated, which haven't,
> which lines have changed since the last release and need to be
> translated again for the next release, etc. For the source code we use
> Babel and Transifex to handle this, but I haven't looked into ways of
> doing something similar for documentation.

We've use sphinx + transifex for documentation elsewhere and it works
well (though I don't know if Read the docs supports i18n yet). For
details of how we did it see the Open Data Handbook README:

<https://github.com/okfn/opendatahandbook>

Rufus