Alex, On 23 October 2013 12:07, Andy Wenk <a...@nms.de> wrote:
> Alex, thanks! > > Yeah that sounds good. As written above it is a draft and I would be happy > if experienced guys like you will start to integrate this where ever it has > to be placed .... I would love to be a part of the process and give my > ideas! > > Let's rock ! > > Andy > > > On 23 October 2013 12:00, Alexander Shorin <kxe...@gmail.com> wrote: > >> Hi Andy! >> >> Guide looks good, but let's see how we could integrate with Pootle >> service at t.a.org . Currently, I wonder how to register there and how >> it handles repository files. Also, I think that it's better to hack >> into Makefile to let command `make html` build html docs for all >> available languages and so forth - this should simplify build process >> a lot. >> -- >> ,,,^..^,,, >> > did you have a chance to push some work into that? (Pootle integration). I would like to push the L10n integration a little bit. Maybe we can have a first step with 1.6.0 ... Cheers Andy > On Tue, Oct 22, 2013 at 1:49 AM, Andy Wenk <a...@nms.de> wrote: >> > On 21 October 2013 23:46, Andy Wenk <a...@nms.de> wrote: >> > >> >> Hi all, >> >> >> >> I have written together a suggestion for integrating i10n into the >> CouchDB >> >> source. Pleas take this as a draft. I have no deeper insights into the >> >> organization of the build process of CouchDB yet so I expect that some >> of >> >> my suggestions are not working. But I want to get things rollin' ;-) >> >> >> >> prerequisites: >> >> >> >> / install sphinx-intl >> >> >> >> 1.) add the following to share/doc/src/conf.py >> >> >> >> locale_dirs = ["../locale/"] >> >> gettext_compact = False >> >> >> >> 2.) create the folder share/doc/locale >> >> >> >> 3.) create .pot files in share/doc/locale/pot >> >> >> >> cd share/doc/src >> >> sphinx-build -b gettext . ../locale/pot >> >> >> >> 4.) create language target folders in share/doc/locale >> >> >> >> sphinx-intl update -p ../locale/pot -l de -l fr >> >> >> >> Now we have a lot of .po files. These files are needed for >> translation. As >> >> we want to use the pootle service we need to transfer the .po files to >> >> https://translate.apache.org/projects/CouchDB/. I am not sure how this >> >> has to be done as I don't know the service there. >> >> >> >> 5.) when the .po files are translated, we put them back into the folder >> >> locale and convert them into a binary format .mo >> >> >> >> sphinx-intl build >> >> >> >> 6.) the last step is to create the html files. I suggest to have them >> in a >> >> language folder under share/www >> >> >> >> share/www <- en >> >> share/www/de >> >> share/www/fr >> >> >> >> This is where share/doc/build/makefile.am has to be adjusted. It can >> be >> >> done with this (from share/doc/src): >> >> >> >> sphinx-build -b html -d src/doctrees . ../www/en >> >> sphinx-build -b html -D language='de' -d src/doctrees . ../www/de >> >> sphinx-build -b html -D language='fr' -d src/doctrees . ../www/fr >> >> >> >> Now we have made translated html files from one source. You can see a >> >> little translation in share/doc/www/de/contributing.html (just to prove >> >> that it works ;-) ). >> >> >> >> 7.) If we added new sources (.rst) to the documentation we create .pot >> >> files with >> >> >> >> sphinx-build -b gettext . ../locale/pot >> >> >> >> as seen in 1.). Then we have to update the .po files with this command: >> >> >> >> sphinx-intl update -p ../locale/pot >> >> >> >> If we add a new language, we invoke: >> >> >> >> sphinx-intl update -p ../locale/pot -l 'es' >> >> >> >> >> >> I have put the result into the branch l10n at g...@github.com: >> >> andywenk/couchdb.git >> >> >> >> I would love to get your feedback, thoughts, ideas and finally somebody >> >> who is doing the implementation or helping me to do it so that I can >> send a >> >> PR. >> >> >> >> >> > I forgot to mention that there is already >> > https://translate.apache.org/projects/CouchDB/ and that we should use >> this >> > service. So we need also a process to deliver the .po files there ... >> not >> > sure how this has to be done ... >> > -- Andy Wenk Hamburg - Germany RockIt! http://www.couchdb-buch.de http://www.pg-praxisbuch.de GPG fingerprint: 3B6D 07F8 8732 CD61 D078 EF7A 63BA 495D 0F15 F21F