[Bf-docboard] Bf-docboard Digest, Vol 130, Issue 4

Sat Dec 12 18:47:52 CET 2015

On Sun, Dec 13, 2015 at 4:02 AM, Tanya Semenko
<tanya.t.semenko at gmail.com> wrote:
> Hello,
>
>
>
> Thank you for the instructions. I have trying to follow it multiple times
> but my translations doesn't applied.
>
> I have following files structure:
>
>
> [build]
>
> [exts]
>
> [locale]
>
> [manual]
>
> [theme]
>
> [tools]
>
> .arcconfig
>
> Makefile
>
> readme.rst
>
> requirements.txt
>
>
>
> The "locale" folder has subfolder "ru" with *.po files, uploaded from the
> SVN:
>
> [locale]
>
> --- [ru]
>
> ------ [LC_MESSAGES]
>
> --------- ...

This is correct directory layout.

>
> This is the output of the sphinx-build.exe:
>
>
> c:\Work\Blender\New_Docs\Manual>c:\Python35\Scripts\sphinx-build -b html -D
> language='ru' ./manual ./build/html
>
> Running Sphinx v1.3.1
>
> Using Index: contents
>
> loading translations ['ru']... not available for built-in messages
>
> loading pickled environment... done
>
> building [mo]: targets for 0 po files that are out of date
>
> building [html]: targets for 0 source files that are out of date
>
> updating environment: 0 added, 0 changed, 0 removed
>
> looking for now-outdated files... none found
>
> no targets are out of date.
>
> build succeeded.
>
>
> As I understood the line "loading translations ['ru']... not available for
> built-in messages" means that the translations did not applied.
>
>
>
> The same output I have if I specify locale_dirs variable:
>
> c:\Python35\Scripts\sphinx-build -b html -D language='ru' ./manual
> ./build/html -D locale_dirs="c:/Work/Blender/New_Docs/Manual/locale"
>
>
>
> I had spent all day reading documentations but without success.

If you run into problems, try log into #blenderwiki on freenode, its
not expected you should have to be spending a long time
troubleshooting this stuff.

> What should I do?

>From what you've written, it seems like you may have missed the step:

  sphinx-intl build

This creates ".mo" files for every ".po" file, these are needed for building.

See: https://www.blender.org/manual/about/translations.html#building-with-translations

> Sincerely,
>
> Tanya.
>
>
> 2015-12-12 13:00 GMT+02:00 <bf-docboard-request at blender.org>:
>>
>> Send Bf-docboard mailing list submissions to
>>         bf-docboard at blender.org
>>
>> To subscribe or unsubscribe via the World Wide Web, visit
>>         http://lists.blender.org/mailman/listinfo/bf-docboard
>> or, via email, send a message with subject or body 'help' to
>>         bf-docboard-request at blender.org
>>
>> You can reach the person managing the list at
>>         bf-docboard-owner at blender.org
>>
>> When replying, please edit your Subject line so it is more specific
>> than "Re: Contents of Bf-docboard digest..."
>>
>>
>> Today's Topics:
>>
>>    1. I wish to translate the manual (Tanya Semenko)
>>    2. Manual Translation, first steps! (Campbell Barton)
>>    3. Re: Manual Translation, first steps! (Campbell Barton)
>>    4. Re: I wish to translate the manual (Campbell Barton)
>>
>>
>> ----------------------------------------------------------------------
>>
>> Message: 1
>> Date: Fri, 11 Dec 2015 16:56:47 +0200
>> From: Tanya Semenko <tanya.t.semenko at gmail.com>
>> Subject: [Bf-docboard] I wish to translate the manual
>> To: bf-docboard at blender.org
>> Message-ID:
>>
>> <CAAb-r9dPtjTyFAJ5ibK0W4JHo72QyoQtG9dRoV-+xUzMfREbGw at mail.gmail.com>
>> Content-Type: text/plain; charset="utf-8"
>>
>> Hello,
>>
>>
>>
>> I wish to make my contribution in Blender?s documentation translation to
>> Russian and Ukrainian languages (both are my native languages).
>>
>>
>> I have downloaded the documentation from the SVN, but it is in English
>> only. Also I?ve found http://wiki.blender.org/index.php/Doc:RU/2.6/Manual,
>> but it?s inaccessible from the main site and has a lot of empty articles.
>>
>>
>> I need your help and guidance how to start it.
>>
>>
>>
>> Sincerely,
>>
>> Tanya Semenko,
>>
>> https://developer.blender.org/p/Tanya/
>> -------------- next part --------------
>> An HTML attachment was scrubbed...
>> URL:
>> http://lists.blender.org/pipermail/bf-docboard/attachments/20151211/f7cc05f4/attachment.html
>>
>> ------------------------------
>>
>> Message: 2
>> Date: Sat, 12 Dec 2015 02:30:09 +1100
>> From: Campbell Barton <ideasman42 at gmail.com>
>> Subject: [Bf-docboard] Manual Translation, first steps!
>> To: Blender Documentation Project <bf-docboard at blender.org>
>> Message-ID:
>>
>> <CAEcf3Nxp3R8B+UsV+niN5VW911jeePauO85n8+tt-pSaUUQrWA at mail.gmail.com>
>> Content-Type: text/plain; charset=UTF-8
>>
>> We've just setup the SVN repository for translations,
>> Currently this means editing PO files and committing them to SVN
>>
>> I've committed initial template files for the French language,
>> In a few days when we can varify this works with translators - other
>> languages can be added too.
>>
>> For an idea what the PO files look like:
>>
>> https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/interface/introduction.po
>>
>> Other info:
>>
>> Task:
>>  https://developer.blender.org/T43083
>> Translations repo:
>>  https://developer.blender.org/diffusion/BMT
>>
>> If your interested on details of how this works (though translators
>> don't need to use this directly):
>>  http://sphinx-doc.org/latest/intl.html
>>
>> --
>> - Campbell
>>
>>
>> ------------------------------
>>
>> Message: 3
>> Date: Sat, 12 Dec 2015 20:17:33 +1100
>> From: Campbell Barton <ideasman42 at gmail.com>
>> Subject: Re: [Bf-docboard] Manual Translation, first steps!
>> To: Blender Documentation Project <bf-docboard at blender.org>
>> Message-ID:
>>
>> <CAEcf3Nx4B3y_hR4pyggEtdAPCscD3esWi92T1Gjko0Zy=qiBDg at mail.gmail.com>
>> Content-Type: text/plain; charset=UTF-8
>>
>> Hi all, quick update.
>>
>> Committed initial docs on how to build with translations enabled.
>> See: https://www.blender.org/manual/about/translations.html
>>
>> Also added Russian templates since this was requested.
>> I rather not add all languages right now, unless someone is interested
>> to start translating them.
>>
>> Tested and building with translations is working, though we still need
>> to setup the server to build with translations.
>>
>> On Sat, Dec 12, 2015 at 2:30 AM, Campbell Barton <ideasman42 at gmail.com>
>> wrote:
>> > We've just setup the SVN repository for translations,
>> > Currently this means editing PO files and committing them to SVN
>> >
>> > I've committed initial template files for the French language,
>> > In a few days when we can varify this works with translators - other
>> > languages can be added too.
>> >
>> > For an idea what the PO files look like:
>> >
>> > https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/interface/introduction.po
>> >
>> > Other info:
>> >
>> > Task:
>> >  https://developer.blender.org/T43083
>> > Translations repo:
>> >  https://developer.blender.org/diffusion/BMT
>> >
>> > If your interested on details of how this works (though translators
>> > don't need to use this directly):
>> >  http://sphinx-doc.org/latest/intl.html
>> >
>> > --
>> > - Campbell
>>
>>
>>
>> --
>> - Campbell
>>
>>
>> ------------------------------
>>
>> Message: 4
>> Date: Sat, 12 Dec 2015 20:29:05 +1100
>> From: Campbell Barton <ideasman42 at gmail.com>
>> Subject: Re: [Bf-docboard] I wish to translate the manual
>> To: Blender Documentation Project <bf-docboard at blender.org>
>> Message-ID:
>>
>> <CAEcf3NxcrqCPsqQM5+nNdNYc0XyWgQYUM1NS3mYE_ELuJ9=vnQ at mail.gmail.com>
>> Content-Type: text/plain; charset=UTF-8
>>
>> Hi Tanya, we are only setting this up just now.
>>
>> I've added you to the documentation project, so you have subversion
>> commit access to both the manual and translations repositories.
>>
>> See: https://www.blender.org/manual/about/translations.html
>> (substitute `fr` with `ru`).
>>
>>
>> On Sat, Dec 12, 2015 at 1:56 AM, Tanya Semenko
>> <tanya.t.semenko at gmail.com> wrote:
>> > Hello,
>> >
>> >
>> >
>> > I wish to make my contribution in Blender?s documentation translation to
>> > Russian and Ukrainian languages (both are my native languages).
>> >
>> >
>> > I have downloaded the documentation from the SVN, but it is in English
>> > only.
>> > Also I?ve found http://wiki.blender.org/index.php/Doc:RU/2.6/Manual, but
>> > it?s inaccessible from the main site and has a lot of empty articles.
>> >
>> >
>> > I need your help and guidance how to start it.
>> >
>> >
>> >
>> > Sincerely,
>> >
>> > Tanya Semenko,
>> >
>> > https://developer.blender.org/p/Tanya/
>> >
>> >
>> > _______________________________________________
>> > Bf-docboard mailing list
>> > Bf-docboard at blender.org
>> > http://lists.blender.org/mailman/listinfo/bf-docboard
>> >
>>
>>
>>
>> --
>> - Campbell
>>
>>
>> ------------------------------
>>
>> _______________________________________________
>> Bf-docboard mailing list
>> Bf-docboard at blender.org
>> http://lists.blender.org/mailman/listinfo/bf-docboard
>>
>>
>> End of Bf-docboard Digest, Vol 130, Issue 4
>> *******************************************
>
>
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>

-- 
- Campbell