[Bf-docboard] New Blender user manual translation (for Japanese)

[Tetsuo Mitsuda]

Hi.

Thanks for your reply.

> Keep in mind that the English manual still needs some attention,
> relevant changes in the content might happen.

it is OK for me, I know FIXME paragraph is  still there.
and I 'm going to further check for translation environmnt on my own
repository for a while.

> Which approach would you recommend?

My recommend is 'Use Sphinx I18n'.
Because it is new and simple for editing .po file.
the translators just care about reST inline markup.

But some case,  it have some limitation:

   (1) additional 'translators note'

         additional paragraph is (or need) only available for non-english page.
         no original paragraph, it can't add po file　for the
paragraph. (msgid is empty)

   (2) image

         .po file is message text, it contains only text.
         if you need to use different picture on every language,
another solution may be needed.

   (3) Mark up (for english author)

         (Need to test)
         some reST markup seems that it does not support for gettext.


Thanks,

2014-11-13 20:23 GMT+09:00 Francesco Siddi <francesco.siddi at gmail.com>:
> Hello Tetsuo,
> first of all, thank you for this great contribution, it’s amazing!
>
> I looked a bit into this, but I am not sure of which one would we the best
> approach. Keep in mind that the English manual still needs some attention,
> relevant changes in the content might happen.
>
> Which approach would you recommend?
>
> Regards,
> Francesco
>
>
> On 9 Nov 2014 at 16:15:17, Tetsuo Mitsuda (lab1092 at gmail.com) wrote:
>
> hi.
>
> I  did build the manual document successfully on my local environment.
> and presonally I'm trying to build it for Japanese document (some paragraphs
> are already translated).
> I add 'allja' target and built it , successfully done!
>
> To 'make' Japanese document,I follow the steps on
> Sphinx 'Internationalization' page.
>    * http://sphinx-doc.org/latest/intl.html
>
> you can find how I changed these files on my repository.
>    * repo: https://github.com/lab1092/blender-manual_i18n
>    * Ouput(HTML):  http://lab1092.site44.com/blender-manual/ja/contents.html
>
>
> btw,I think , to make localized document , there is two way.
>
>    1. Use Sphinx Internationalization.(edit .po file)
>    2. Separate documentation project for each language( edit .rst file)
>         It is Old style, like CakePHP cookbook did:
> https://github.com/cakephp/docs
>
> I don't know actually which is the good way for userr manual , the former
> one is a feasible plan,I think :)
>
> I hope this will help you.
>
> thanks!
>
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>