Translations (how to handle, design task) #43083

New Issue

Francesco Siddi · 2014-12-31T17:51:05+01:00

Francesco Siddi commented

2014-12-31 17:51:05 +01:00

Current Status

We have a translation repository setup with [German, French and Russian] language templates committed: https://developer.blender.org/diffusion/BMT
Initial documentation on how to build with translations: https://www.blender.org/manual/about/translations/index.html

We need to formalize how to handle translations. Follow up on http://lists.blender.org/pipermail/bf-docboard/2014-November/004600.html.

Translation Workflow

The sphinx-intl project is well supported and has been tested to work with a snapshot of the Blender-Manual.

Rather than having multiple separate manuals, we would instead maintain translated strings (common for translating applications).

See: sphinx-intl https://pypi.python.org/pypi/sphinx-intl

basic workflow is:

Generate POT files
Generate language specific PO files.
PO files are committed to source control (we might have a separate repo for these)
Translators edit PO files (tools like https:poedit.net are apparently good).
Docs can be built with a translation applied.

Web Based Translation Software (currently not in use)

Eventually, we may want to look into using web-based translation software.

Some existing software exists:

Current Status ---- - We have a translation repository setup with [German, French and Russian] language templates committed: https://developer.blender.org/diffusion/BMT - Initial documentation on how to build with translations: https://www.blender.org/manual/about/translations/index.html ---- We need to formalize how to handle translations. Follow up on http://lists.blender.org/pipermail/bf-docboard/2014-November/004600.html. ---- Translation Workflow ---- The sphinx-intl project is well supported and has been tested to work with a snapshot of the Blender-Manual. Rather than having multiple separate manuals, we would instead maintain translated strings (common for translating applications). See: `sphinx-intl` https://pypi.python.org/pypi/sphinx-intl basic workflow is: - Generate POT files - Generate language specific PO files. - PO files are committed to source control (we might have a separate repo for these) - Translators edit PO files (tools like https:*poedit.net* are apparently good). - Docs can be built with a translation applied. Web Based Translation Software (currently not in use) **** Eventually, we may want to look into using web-based translation software. Some existing software exists: - http://pootle.translatehouse.org - http://weblate.org - http://zanata.org

Francesco Siddi commented

2014-12-31 17:51:05 +01:00

Changed status to: 'Open'

Francesco Siddi self-assigned this 2014-12-31 17:51:05 +01:00

blender-admin commented

2014-12-31 17:51:05 +01:00

#43103 was marked as duplicate of this issue

Sergey Sharybin commented

2015-01-01 11:07:46 +01:00

Added subscriber: @Sergey

Campbell Barton commented

2015-01-03 09:58:38 +01:00

Added subscribers: @GabrielGazzan, @fsiddi, @ideasman42

Gabriel Gazzán commented

2015-01-03 15:15:14 +01:00

ok, thanks for redirecting this one. :)
I'll start here again:

v2.73: "Help --> Manual" goes to a new manual with no translations

I understand this is a new (under development) version of the Blender manual and that in the long run it will be better.
But right now the fact is that we (non-English users) are losing an old translated manual in favor of a new English-only manual.

I (as a Blender instructor) am not happy with it.
There's no way now for unexperienced non-English users to easily access localized help.

Perhaps, in the mean time, a solution woud be to have a home page in that new Manual, with a clear route back to the previous translated versions of the manual?

Thanks!

ok, thanks for redirecting this one. :) I'll start here again: v2.73: "Help --> Manual" goes to a new manual with no translations I understand this is a new (under development) version of the Blender manual and that in the long run it will be better. But right now the fact is that we (non-English users) are losing an old translated manual in favor of a new English-only manual. I (as a Blender instructor) am not happy with it. There's no way now for unexperienced non-English users to easily access localized help. Perhaps, in the mean time, a solution woud be to have a home page in that new Manual, with a clear route back to the previous translated versions of the manual? Thanks!

Campbell Barton commented

2015-01-06 01:29:23 +01:00

This comment was removed by @ideasman42

*This comment was removed by @ideasman42*

Campbell Barton changed title from ~~How to handle translations~~ to Translations (how to handle, design task)

2015-01-20 02:00:44 +01:00

bruno sanchiz commented

2015-09-05 17:35:13 +02:00

Added subscriber: @dindoun

bruno sanchiz commented

2015-09-05 17:35:13 +02:00

hi,
Really a bad old news.
I can't always be in english manuals.
Sometimes I need to translate a text before understanding it.

We have waited for months, now change your politics.
Thanks.

hi, Really a bad **old** news. I can't always be in english manuals. Sometimes I need to translate a text before understanding it. We have waited for months, now change your politics. Thanks.

Vyacheslav commented

2015-10-22 03:13:04 +02:00

Added subscriber: @slone

Vyacheslav commented

2015-10-22 03:13:04 +02:00

Hello,

Have some thoughts about documentation handle:

Each module, unit or addon must have some basic code in English for general wiki and autodoc system.
Create system of hierarchy for all blender units and parts.
That hierarchy must be autoactualizing on base English.
Abstract module must be attached to all ui elements - animation module for visual explanation of function or feature.
Create general documentation database for all created docs and pages. It must always autocompleting and self-actuating via autoscan or manual adding in string-based html fields. Later it is possible to create all html files from database fields via special forms basically in English.
For each old doc must be one record in that database. All html files must be archived in general repository for request for database-creation time.
Then, for translator accounts will be created task for translation on own language from that database. Each task must be connected to basic record, so each string-field have corresponding local string-field.

Hope this will be helpful.

Hello, Have some thoughts about documentation handle: 1. Each module, unit or addon must have some basic code in English for general wiki and autodoc system. 2. Create system of hierarchy for all blender units and parts. 3. That hierarchy must be autoactualizing on base English. 4. Abstract module must be attached to all ui elements - animation module for visual explanation of function or feature. 5. Create general documentation database for all created docs and pages. It must always autocompleting and self-actuating via autoscan or manual adding in string-based html fields. Later it is possible to create all html files from database fields via special forms basically in English. 6. For each old doc must be one record in that database. All html files must be archived in general repository for request for database-creation time. 7. Then, for translator accounts will be created task for translation on own language from that database. Each task must be connected to basic record, so each string-field have corresponding local string-field. Hope this will be helpful.

Campbell Barton commented

2015-10-22 10:00:01 +02:00

@slone. Sphinx provides a translation system already - I've tested it and it works well as far as I could tell,
I think we just need to start using, with someone who's prepared to be the first person to hit any issues we might run into.

@slone. Sphinx provides a translation system already - I've tested it and it works well as far as I could tell, I think we just need to start using, with someone who's prepared to be the first person to hit any issues we might run into.

Campbell Barton commented

2015-10-22 10:20:39 +02:00

In #43083#332773, @dindoun wrote:
hi,
Really a bad old news.
I can't always be in english manuals.
Sometimes I need to translate a text before understanding it.

We have waited for months, now change your politics.
Thanks.

This isn't about politics, the English manual was being heavily edited, pages removed/moved/split/merged, so having translations keep up with this would have been problematic.

I think we're slowing down on this - so we could trial translating some chapters now.

> In #43083#332773, @dindoun wrote: > hi, > Really a bad **old** news. > I can't always be in english manuals. > Sometimes I need to translate a text before understanding it. > > We have waited for months, now change your politics. > Thanks. This isn't about politics, the English manual was being heavily edited, pages removed/moved/split/merged, so having translations keep up with this would have been problematic. I think we're slowing down on this - so we could trial translating some chapters now.

Vyacheslav commented

2015-10-22 11:36:00 +02:00

Ok, I see. If I can help to this somehow I will be glad.

Vyacheslav commented

2015-10-22 14:22:43 +02:00

One more thought about translation proccess:

Maybe it will be convient for translators to use only one portal user-friendly simple web-form connected to all translation database.
It is very difficult to understand something when we have to do many actions and searches to translate something. It is difficult to find what to translate at all. So for newbie it is hard to envolve in this proccess in double measure.
It can be organized as a list of today's tasks. Something like a simple guide can be very helpful to start. And of course web-form must be translated on native translator's language to help him to start. For many people it is very hard to comprehend a lot of English-text data.
All programming and coding must be hidden to not to confuse a translator. He sees only that what he can do as a translator, no more. But he always can go further to get more specific programming data but only if he can understand it by own request.
All translator's history can be stored as in github or something like that to check and moderate.
All translation system must be centralized and connected to coding system for adminstrating. Internal implementation must be hidden and be accessible only by special request.

I'm not expirienced in Sphinx but probably it is a tool that can help. These thoughts I have from my php-programming experience and usability considerations.

One more thought about translation proccess: 1. Maybe it will be convient for translators to use only one portal user-friendly simple web-form connected to all translation database. It is very difficult to understand something when we have to do many actions and searches to translate something. It is difficult to find what to translate at all. So for newbie it is hard to envolve in this proccess in double measure. 2. It can be organized as a list of today's tasks. Something like a simple guide can be very helpful to start. And of course web-form must be translated on native translator's language to help him to start. For many people it is very hard to comprehend a lot of English-text data. 3. All programming and coding must be hidden to not to confuse a translator. He sees only that what he can do as a translator, no more. But he always can go further to get more specific programming data but only if he can understand it by own request. 4. All translator's history can be stored as in github or something like that to check and moderate. 5. All translation system must be centralized and connected to coding system for adminstrating. Internal implementation must be hidden and be accessible only by special request. I'm not expirienced in Sphinx but probably it is a tool that can help. These thoughts I have from my php-programming experience and usability considerations.

Campbell Barton commented

2015-10-22 15:39:57 +02:00

@slone:
Some web based translation is possible, projects exist, noted in original post.

But setting these up takes some investigation, we can do it, but this needs to be configured to our own needs.
Probably to begin with we will just use SVN directly, and after that works on a basic level, investigate online options.

@slone: Some web based translation is possible, projects exist, noted in original post. ---- But setting these up takes some investigation, we can do it, but this needs to be configured to our own needs. Probably to begin with we will just use SVN directly, and after that works on a basic level, investigate online options.

Matthew Bowker commented

2015-12-09 05:06:26 +01:00

Added subscriber: @matthewrbowker

Libellule commented

2015-12-10 19:44:25 +01:00

Added subscriber: @Libellul

Libellule commented

2015-12-10 21:03:11 +01:00

Hi,
I am willing to translate the manual in french. So I updated the makefile to make things easier. See :
377e8fb329

for translating in french you have to do

MANUAL_LANG=fr make update_locale
translate
MANUAL_LANG=fr make
That's it you have you manual translated and builded.

Since I want to do my translation, I'll do it on my github. It won't be hard to port it to the subversion repository.

Anyway I will keep you in touch from any problem I'll encounter

Hi, I am willing to translate the manual in french. So I updated the makefile to make things easier. See : https://github.com/libellul/blender-manual-fr/commit/377e8fb329e1a65d1fcb265ed4c3d34f304f1780 for translating in french you have to do 1. MANUAL_LANG=fr make update_locale 2. translate 3. MANUAL_LANG=fr make That's it you have you manual translated and builded. Since I want to do my translation, I'll do it on my github. It won't be hard to port it to the subversion repository. Anyway I will keep you in touch from any problem I'll encounter

Campbell Barton commented

2015-12-11 13:35:14 +01:00

Hi, @Libellul, We'll be looking to add the translation repository soon (next few days... end of next week latest).

Campbell Barton commented

2015-12-11 16:11:55 +01:00

Update, committed initial French translations to: https://developer.blender.org/diffusion/BMT

@Libellul, I've added you to the documentation project so you can commit changes to this repo.

Update, committed initial French translations to: https://developer.blender.org/diffusion/BMT @Libellul, I've added you to the documentation project so you can commit changes to this repo.

Francesco Siddi commented

2015-12-11 16:15:56 +01:00

Hey there Cambo, there seems to be someone willing to translate to Russian and Ukrainian. How do we proceed in this case? Simply add a ru directory in the repo?

Hey there Cambo, there seems to be someone willing to translate to Russian and Ukrainian. How do we proceed in this case? Simply add a `ru` directory in the repo?

Libellule commented

2015-12-12 16:46:58 +01:00

Hi Campbell I can't commit my changes to the documentation repo

Campbell Barton commented

2015-12-13 03:27:05 +01:00

@Libellul, to handle issues with commit access, best do this via IRC (#blenderwiki on freenode) or the bf-docboard mailing list.

Post there what errors your seeing and we can try to resolve.

(Rather keep this task for feedback on translation process, troubleshooting individual users commit access here is off topic).

@Libellul, to handle issues with commit access, best do this via IRC (#blenderwiki on freenode) or the bf-docboard mailing list. Post there what errors your seeing and we can try to resolve. *(Rather keep this task for feedback on translation process, troubleshooting individual users commit access here is off topic).*

Aaron Carlisle commented

2015-12-14 20:51:51 +01:00

Added subscriber: @anfelor

Sergey Klimkin commented

2015-12-20 20:38:09 +01:00

Added subscriber: @sklimkin

Sergey Klimkin commented

2015-12-20 21:39:04 +01:00

Hello, Campbell!
I want to take part in the translation of documentation into Russian.
But I can't commit changes documentation repo.

Hello, Campbell! I want to take part in the translation of documentation into Russian. But I can't commit changes documentation repo.

Libellule commented

2015-12-22 08:37:05 +01:00

Hi,
I wanted to know if we can regenerate the po files for our language. I stumbled upon a page where strings have changed and it's a bit frustrating.

I have also a suggestion
It would be nice to have tool using git/svn blame to keep track of outdated translations.
I think it's better to have a partial but updated documentation than the opposite.

I don't know anything about python but if there's really nobody who want to do this job I'll take a look

But maybe I'm wrong and there's a simplier way to track outdated translations

Hi, I wanted to know if we can regenerate the po files for our language. I stumbled upon a page where strings have changed and it's a bit frustrating. I have also a suggestion It would be nice to have tool using git/svn blame to keep track of outdated translations. I think it's better to have a partial but updated documentation than the opposite. I don't know anything about python but if there's really nobody who want to do this job I'll take a look But maybe I'm wrong and there's a simplier way to track outdated translations

Aaron Carlisle commented

2015-12-22 15:52:21 +01:00

Added subscriber: @Blendify

Aaron Carlisle commented

2015-12-22 15:52:21 +01:00

Who should be responsible for doing these normal? Documentors or Translators?

Campbell Barton commented

2015-12-22 20:07:08 +01:00

Hey @sklimkin, I've added you to the documentation project, so you can now commit PO files (and edits to the manual too) using subversion.

@Libellul, I run an update on the PO files around ~weekly, the manual isn't changing so fast that this is normally a problem. (committed update),

To do this yourself, see:
https://www.blender.org/manual/about/translations.html#updating-po-files

@Blendify, Anyone can do this, however it may be a hassle to setup, so I don't mind to do it weekly.

Hey @sklimkin, I've added you to the documentation project, so you can now commit PO files (and edits to the manual too) using subversion. @Libellul, I run an update on the PO files around ~weekly, the manual isn't changing so fast that this is normally a problem. (committed update), To do this yourself, see: https://www.blender.org/manual/about/translations.html#updating-po-files ---- @Blendify, Anyone can do this, however it may be a hassle to setup, so I don't mind to do it weekly.

Libellule commented

2015-12-23 08:24:18 +01:00

Hi,
I thought I had outdated po file but I was wrong.

The file concerned is getting_started/installing_blender/installing.po
https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/getting_started/installing_blender/installing.po;69$67

At this line msgid tell us we sould find the string "Daily Build" at line ~32 in the documentation file.

And here is the line in the documentation (which hasn't bee updated since 09/15/2015)
https://developer.blender.org/diffusion/BM/browse/trunk/blender_docs/manual/getting_started/installing_blender/installing.rst;1018$31

"Latest Stable Release <http://www.blender.org/download/>__"

If I update the pos files following exacty the instructions of blender documentation I get the string
msgid "Latest Stable Release <http://www.blender.org/download/>__"

Good !

But what about the next time you update the po files won't the "wrongs msgid" be merged, replacing the good one ?

Hi, I thought I had outdated po file but I was wrong. The file concerned is getting_started/installing_blender/installing.po https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/getting_started/installing_blender/installing.po;69$67 At this line msgid tell us we sould find the string "Daily Build" at line ~32 in the documentation file. And here is the line in the documentation (which hasn't bee updated since 09/15/2015) https://developer.blender.org/diffusion/BM/browse/trunk/blender_docs/manual/getting_started/installing_blender/installing.rst;1018$31 "`Latest Stable Release <http://www.blender.org/download/>`__" If I update the pos files following exacty the instructions of blender documentation I get the string msgid "`Latest Stable Release <http://www.blender.org/download/>`__" Good ! But what about the next time you update the po files won't the "wrongs msgid" be merged, replacing the good one ?

Campbell Barton commented

2015-12-24 04:34:50 +01:00

@Libellul, not sure what you mean - merging changed can be problematic - but in general updating the PO files shouldn't be causing continual errors, or this would be an unusable system.

I've updated the PO files since your post,
if you see an update that causes problems - let us know.

@Libellul, not sure what you mean - merging changed can be problematic - but in general updating the PO files shouldn't be causing continual errors, or this would be an unusable system. I've updated the PO files since your post, if you see an update that causes problems - let us know.

Libellule commented

2015-12-25 15:48:45 +01:00

@ideasman42, Don't mind the merge problems it's a misunderstanding.
You have updated the PO File but it did not updated the mentioned string

Here is what I understand :

In the install.po I have this line :https:*developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/ru/LC_MESSAGES/getting_started/installing_blender/installing.po;89$89 it does not match the string in https:*developer.blender.org/diffusion/BM/browse/trunk/blender_docs/manual/getting_started/installing_blender/installing.rst;1018$31
If I Translate this string and build the manual the string stay in English which is predictable.
If I update po files I get the good string : https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/getting_started/installing_blender/installing.po;89$155
If I translate the string and build the manual again the string is translated.

What I do not understand :

@ideasman42 you keep updating locales with the wrong msgid
I committed my local change that worked on my computer. But build on the online manual the string is kept untranslated.
The German team Choose to ignore this problem (was there even one for them ?) And Translated it : https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/de/LC_MESSAGES/getting_started/installing_blender/installing.po;89$90

Guess what ? It worked

I think I'll wait for your next repositories update and do as the German team. But I think there is definitely a bug and it's not on my computer

Sorry for the annoyance

@ideasman42, Don't mind the merge problems it's a misunderstanding. You have updated the PO File but it did not updated the mentioned string Here is what I understand : 1. In the install.po I have this line :https:*developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/ru/LC_MESSAGES/getting_started/installing_blender/installing.po;89$89 it does not match the string in https:*developer.blender.org/diffusion/BM/browse/trunk/blender_docs/manual/getting_started/installing_blender/installing.rst;1018$31 2. If I Translate this string and build the manual the string stay in English which is predictable. 3. If I update po files I get the good string : https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/getting_started/installing_blender/installing.po;89$155 4. If I translate the string and build the manual again the string is translated. What I do not understand : 1. @ideasman42 you keep updating locales with the wrong msgid 2. I committed my local change that worked on my computer. But build on the online manual the string is kept untranslated. 3. The German team Choose to ignore this problem (was there even one for them ?) And Translated it : https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/de/LC_MESSAGES/getting_started/installing_blender/installing.po;89$90 Guess what ? It worked I think I'll wait for your next repositories update and do as the German team. But I think there is definitely a bug and it's not on my computer Sorry for the annoyance

Anton Lorenzen commented

2015-12-25 16:40:59 +01:00

@Libellul, I ('the german team') didn't realize it, when I translated it;
but you're definitely right (and it isn't just you):
The msgid should contain hyperlink, but doesn't.

Direct (visual) comparison:
https://www.blender.org/manual/getting_started/installing_blender/installing.html#download-blender
https://www.blender.org/manual/de/getting_started/installing_blender/installing.html#download-blender

The English version has three hyperlinks, the German only one.

Merry Christmas everyone,
Anton Felix Lorenzen

@Libellul, I ('the german team') didn't realize it, when I translated it; but you're definitely right (and it isn't just you): The msgid should contain hyperlink, but doesn't. Direct (visual) comparison: https://www.blender.org/manual/getting_started/installing_blender/installing.html#download-blender https://www.blender.org/manual/de/getting_started/installing_blender/installing.html#download-blender The English version has three hyperlinks, the German only one. Merry Christmas everyone, Anton Felix Lorenzen

xueke pei commented

2015-12-26 04:44:34 +01:00

Added subscriber: @xuekepei

xueke pei commented

2015-12-26 05:00:57 +01:00

Hi, I've started the chinese translate process for four or five months.
The work flow is : sphinx-build -b gettext produce pot then sphinx-intl update produce po file, then distrubute po file for someone translate then collection them to build html . I'v enconter so many problem and solved,especially the old sphinx-intl can't distinguish changed url item give me a new item in po, but the new one change the exist item and mark then as fuzzy item. this can reduce my work load.
Question is could I upload po files to repository and how. then can automatic build htmls.
I use sphinx-build -b html -D language="zh_CN" to build html.
thanks.

Hi, I've started the chinese translate process for four or five months. The work flow is : sphinx-build -b gettext produce pot then sphinx-intl update produce po file, then distrubute po file for someone translate then collection them to build html . I'v enconter so many problem and solved,especially the old sphinx-intl can't distinguish changed url item give me a new item in po, but the new one change the exist item and mark then as fuzzy item. this can reduce my work load. Question is could I upload po files to repository and how. then can automatic build htmls. I use sphinx-build -b html -D language="zh_CN" to build html. thanks.

Campbell Barton commented

2015-12-26 09:24:14 +01:00

@anfelor, @xuekepei - if theres problems, please report bugs to: https:github.com/sphinx-doc/sphinx-intl(noting them here is fine too, but best make reports to have them fixed).//

@anfelor, @xuekepei - if theres problems, please report bugs to: https:*github.com/sphinx-doc/sphinx-intl*(noting them here is fine too, but best make reports to have them fixed).//

Libellule commented

2016-01-09 09:13:50 +01:00

I reported the bug I mentioned to sphinx-intl and it has been fix.

Also what software do you use for translating ?
And Have you any feedback to do about it ?

I reported the bug I mentioned to sphinx-intl and it has been fix. Also what software do you use for translating ? And Have you any feedback to do about it ?

Francesco Siddi was unassigned by Aaron Carlisle

2016-01-17 18:46:39 +01:00

Aaron Carlisle commented

2016-01-17 18:47:25 +01:00

@Libellul could you give a link to that report you made thanks

Libellule commented

2016-01-17 18:51:03 +01:00

sure :
https://github.com/sphinx-doc/sphinx/issues/2198

sure : https://github.com/sphinx-doc/sphinx/issues/2198

Aaron Carlisle commented

2016-01-17 19:02:04 +01:00

Thanks

@ideasman42 did the issue with zh_CN get fixed?

Thanks @ideasman42 did the issue with zh_CN get fixed?

Aaron Carlisle commented

2016-01-17 19:16:01 +01:00

@Libellul we updated to Spinx 1.3.4 you can update yours by running pip install -r requirements.txt Then run pip install -r requirements.txt --upgrade Does every thing work currently now?

Make sure you update SVN also

@Libellul we updated to Spinx 1.3.4 you can update yours by running `pip install -r requirements.txt` Then run `pip install -r requirements.txt --upgrade` Does every thing work currently now? ----------- Make sure you update SVN also

Libellule commented

2016-01-18 13:33:00 +01:00

@Blendify : short answer yes
long answer :

I updated sphinx-intl with pip install -U sphinx-intl (not sure if it's mandatory).
I updated the po files
I removed the old lines commented out at the end of the file with a text editor because poedit was complaining about errors.

It's ready for translation !

@Blendify : short answer yes long answer : - I updated sphinx-intl with *pip install -U sphinx-intl* (not sure if it's mandatory). - I updated the po files - I removed the old lines commented out at the end of the file with a text editor because poedit was complaining about errors. It's ready for translation !

bruno sanchiz commented

2016-04-28 05:18:46 +02:00

Hello
I need help
I'd like to translate but each time I try I fail

I'm on linux, I use poedit
I translated manual/advanced/index.rst
I have an index.po ( http://dindoun.free.fr/DIVERS/index.po )

To install i did that:
svn checkout https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs
cd blender_docs
pip install -r requirements.txt
pip install -r requirements.txt --upgrade
make

svn update
svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale/fr locale/fr
svn update

change the .po
make gettext
sphinx-intl update -p build/locale -l fr
sphinx-intl build
make -e SPHINXOPTS="-D language='fr'"

I probably made 1 or 2 more make

please mp to dindoun at free.fr

Hello I need help I'd like to translate but each time I try I fail I'm on linux, I use poedit I translated manual/advanced/index.rst I have an index.po ( http://dindoun.free.fr/DIVERS/index.po ) **To install i did that**: svn checkout https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs cd blender_docs pip install -r requirements.txt pip install -r requirements.txt --upgrade make svn update svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale/fr locale/fr svn update **change the .po** make gettext sphinx-intl update -p build/locale -l fr sphinx-intl build make -e SPHINXOPTS="-D language='fr'" I probably made 1 or 2 more make please mp to *dindoun at free.fr*

bruno sanchiz commented

2016-04-28 16:50:29 +02:00

I try this :

svn commit locale/fr/LC_MESSAGES/advanced/index.po -m "advanced" --username "dindoun"

it seems to work :) . Do I have to wait for something or commit the .mo too?

Another thing : I'd like to help for the python scripting help

I try this : svn commit locale/fr/LC_MESSAGES/advanced/index.po -m "advanced" --username "dindoun" it seems to work :) . Do I have to wait for something or commit the .mo too? Another thing : I'd like to help for the python scripting help

Aaron Carlisle commented

2016-04-28 18:21:18 +02:00

Your commit made it through see https://developer.blender.org/rBMT255

Do I have to wait for something or commit the .mo too?

No these are made from the server side and your page is translated https://www.blender.org/manual/fr/advanced/index.html

Your commit made it through see https://developer.blender.org/rBMT255 > Do I have to wait for something or commit the .mo too? No these are made from the server side and your page is translated https://www.blender.org/manual/fr/advanced/index.html

bruno sanchiz commented

2016-04-29 05:39:52 +02:00

Ok , thanks.
Now I'm ready for the translation.

It worked, but

It seems to have now errors I don't understand :

this : https://www.blender.org/manual/fr/physics/force_fields/introduction.html exists
but on this https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/physics/ I can't see force_fields

PS
when I read, if I see errors in English : what must I do?

Ok , thanks. Now I'm ready for the translation. It worked, but It seems to have now errors I don't understand : this : https://www.blender.org/manual/fr/physics/force_fields/introduction.html exists but on this https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale/fr/LC_MESSAGES/physics/ I can't see force_fields PS when I read, if I see errors in English : what must I do?

Aaron Carlisle commented

2016-04-30 03:11:05 +02:00

You also have commit rights to the English versions. As for the other issue I do not see anything wrong. Maybe @ideasman42 can help

Campbell Barton commented

2016-04-30 18:30:19 +02:00

There was an error in the translation updating script, new directories weren't being added to svn. Fixed rBM1682. rBMT262.

bruno sanchiz commented

2016-05-01 17:22:38 +02:00

Thanks
it seems to work :)

few things :

I have a probleme with this ligne :
"A detailed guide that covers every setting with images and examples <https://www.miikahweb.com/en/articles/dynamic-paint-guide>__ (Currently not up-to-date)"
in
locale/fr/LC_MESSAGES/physics/dynamic_paint/brush.po

poedit always say "double définition de message" ( ~ duplicate message definition ) but all work .

On the blender interface in french , the translation is not finished.
To be useful, I use in my traduction, the terms I see in the interface ( the same title even if it is approximatif )
Is there a way to automatically put the terms of the interface in the traduction ( so if they change in the interface they will be changed in the manual )?

What must I do to put a reference to the french images ( with the french traduction in the images ? )
I tried a directory blender_docs/locale/fr/LC_MESSAGES/images/ with
blender_docs/locale/fr/LC_MESSAGES/images/physics_dynamic-paint_brush.jpg for
blender_docs/manual/images/physics_dynamic-paint_brush.jpg
but I see english images in the french traduction

Thanks it seems to work :) few things : **I have a probleme with this ligne :** "`A detailed guide that covers every setting with images and examples <https://www.miikahweb.com/en/articles/dynamic-paint-guide>`__ (Currently not up-to-date)" in locale/fr/LC_MESSAGES/physics/dynamic_paint/brush.po poedit always say "double définition de message" ( ~ duplicate message definition ) but all work . **On the blender interface in french , the translation is not finished.** To be useful, I use in my traduction, the terms I see in the interface ( the same title even if it is approximatif ) Is there a way to automatically put the terms of the interface in the traduction ( so if they change in the interface they will be changed in the manual )? **What must I do to put a reference to the french images ( with the french traduction in the images ? )** I tried a directory blender_docs/locale/fr/LC_MESSAGES/images/ with blender_docs/locale/fr/LC_MESSAGES/images/physics_dynamic-paint_brush.jpg for blender_docs/manual/images/physics_dynamic-paint_brush.jpg but I see english images in the french traduction

bruno sanchiz commented

2016-05-02 00:27:18 +02:00

Following the force_fields :
I can't commit the files : it says

svn commit locale/fr/LC_MESSAGES/physics/force_fields/ -m "forcefields2" --username "dindoun"
svn: E200009: Échec de la propagation (commit), détails : 
svn: E200009: '.../blender_docs/locale/fr/LC_MESSAGES/physics/force_fields' n'est pas versionné

I tried a

svd add locale/fr/LC_MESSAGES/physics/force_fields

and the commit says :

svn commit locale/fr/LC_MESSAGES/physics/force_fields/ -m "forcefields2" --username "dindoun"
Ajout          locale/fr/LC_MESSAGES/physics/force_fields
svn: E155011: Échec de la propagation (commit), détails : 
svn: E155011: Répertoire '...blender_docs/locale/fr/LC_MESSAGES/physics/force_fields' obsolète
svn: E160020: Path already exists, path '/trunk/blender_docs/locale/fr/LC_MESSAGES/physics/force_fields'

Following the force_fields : I can't commit the files : it says ``` svn commit locale/fr/LC_MESSAGES/physics/force_fields/ -m "forcefields2" --username "dindoun" svn: E200009: Échec de la propagation (commit), détails : svn: E200009: '.../blender_docs/locale/fr/LC_MESSAGES/physics/force_fields' n'est pas versionné ``` I tried a ``` svd add locale/fr/LC_MESSAGES/physics/force_fields ``` and the commit says : ``` svn commit locale/fr/LC_MESSAGES/physics/force_fields/ -m "forcefields2" --username "dindoun" Ajout locale/fr/LC_MESSAGES/physics/force_fields svn: E155011: Échec de la propagation (commit), détails : svn: E155011: Répertoire '...blender_docs/locale/fr/LC_MESSAGES/physics/force_fields' obsolète svn: E160020: Path already exists, path '/trunk/blender_docs/locale/fr/LC_MESSAGES/physics/force_fields' ```

Aaron Carlisle commented

2016-05-02 00:38:09 +02:00

Not sure what is wrong. I would try:

svn cleanup
then update your branch and try again

Not sure what is wrong. I would try: ``` ``` - `svn cleanup` - then update your branch and try again

bruno sanchiz commented

2016-05-02 05:21:18 +02:00

hi ,
still doesn t work
but I'm not sure of update your branch : I just update with svn update

hi , still doesn t work but I'm not sure of *update your branch* : I just update with svn update

bruno sanchiz commented

2016-05-02 05:37:23 +02:00

I'm not sure I did

python3 tools/report_translation_progress.py locale/fr/LC_MESSAGES/

as proposed in https://www.blender.org/manual/about/translations/contribute.html#translations-fuzzy-strings

I'm not sure I did ``` python3 tools/report_translation_progress.py locale/fr/LC_MESSAGES/ ``` as proposed in https://www.blender.org/manual/about/translations/contribute.html#translations-fuzzy-strings

bruno sanchiz commented

2016-05-02 23:02:42 +02:00

It works but I had to destroy my directory avec make another one

bruno sanchiz commented

2016-05-05 08:38:47 +02:00

Maybe useful : my command line in linux ( after I've translated a po with poedit ) to see french traduction in local network

cd ~/Bureau/TraductionDeBlender/blender_docs && make gettext && sphinx-intl update -p build/locale -l fr && sphinx-intl build && make -e SPHINXOPTS="-D language='fr'"

then to see french traduction on blender.org

svn commit locale/fr/LC_MESSAGES/physics/fluid/ -m "fr-fluid-more" --username "dindoun"

As soon as I translate alone it's simple, but if someone come to translate, what will I have to do to download his .po in the french directory?
When a .rst is changed after a svn update, is the french .po changed also?

Maybe useful : my command line in linux ( after I've translated a po with poedit ) to see french traduction in local network ``` cd ~/Bureau/TraductionDeBlender/blender_docs && make gettext && sphinx-intl update -p build/locale -l fr && sphinx-intl build && make -e SPHINXOPTS="-D language='fr'" ``` then to see french traduction on blender.org ``` svn commit locale/fr/LC_MESSAGES/physics/fluid/ -m "fr-fluid-more" --username "dindoun" ``` 1. As soon as I translate alone it's simple, but if someone come to translate, what will I have to do to download his .po in the french directory? 2. When a .rst is changed after a svn update, is the french .po changed also?

bruno sanchiz commented

2016-05-28 18:29:27 +02:00

Hi
what must I do when Isee errors in the translate in frence interface?
For example in "Baking Physics Simulations" (baking.po) we can find the traduction of light as lumière(not dark)
but in french we have to say léger (not heavy) .

Hi what must I do when Isee errors in the translate in frence interface? For example in "Baking Physics Simulations" (baking.po) we can find the traduction of *light* as *lumière*(not dark) but in french we have to say *léger* (not heavy) .

bruno sanchiz commented

2016-05-28 18:30:51 +02:00

And badder the traduction of Heavy is Compact !

And badder the traduction of *Heavy* is *Compact* !

Aaron Carlisle commented

2016-05-28 19:02:32 +02:00

As soon as I translate alone it's simple, but if someone come to translate, what will I have to do to download his .po in the french directory?

You will have to update your local SVN

When a .rst is changed after a svn update, is the french .po changed also?

These are updated with the a script. You can either do them yourself or wait for @ideasman42 to update them.

see also: https://www.blender.org/manual/about/translations/contribute.html#updating-po-files

what must I do when Isee errors in the translate in frence interface?

I do not know if this is exactly what you are asking. If there is an error you can fix it and commit the change.

> As soon as I translate alone it's simple, but if someone come to translate, what will I have to do to download his .po in the french directory? You will have to update your local SVN > When a .rst is changed after a svn update, is the french .po changed also? These are updated with the a script. You can either do them yourself or wait for @ideasman42 to update them. see also: https://www.blender.org/manual/about/translations/contribute.html#updating-po-files > what must I do when Isee errors in the translate in frence interface? I do not know if this is exactly what you are asking. If there is an error you can fix it and commit the change.

bruno sanchiz commented

2016-05-28 22:21:36 +02:00

I'm a newbie in svn
I have always errors on my local base and I must sometimes delete all the directory and then I must download all the files to be sure. But after that it works.

Sometimes I read and translate things which should not be there. For exemple on https://www.blender.org/manual/fr/physics/introduction.html they were something about mars to delete in the english .rst and so on my french .po. ( someone has seen it )
May/must I change it on the original .rst ? I thought it was for another project or "team".
Maybe I could say it to someone each time.
Sometimes I translate words from the interface which are not the good translated words ( or simply I don't agree ) but if I use the good one ( my good one ) it will be different from the interface.
Maybe I could say it to someone each time.
when someone changes a .rst ( like the one on mars ) nothing say it to me. Is there a way to know it automatically ( with svn I suppose?)

I'm a newbie in svn I have always errors on my local base and I must sometimes delete all the directory and then I must download all the files to be sure. But after that it works. 1. Sometimes I read and translate things which should not be there. For exemple on https://www.blender.org/manual/fr/physics/introduction.html they were something about mars to delete in the english .rst and so on my french .po. ( someone has seen it ) May/must I change it on the original .rst ? I thought it was for another project or "team". Maybe I could say it to someone each time. 2. Sometimes I translate words from the interface which are not the good translated words ( or simply I don't agree ) but if I use the good one ( my good one ) it will be different from the interface. Maybe I could say it to someone each time. 3. when someone changes a .rst ( like the one on mars ) nothing say it to me. Is there a way to know it automatically ( with svn I suppose?)

Aaron Carlisle commented

2016-05-29 00:18:37 +02:00

I have always errors on my local base and I must sometimes delete all the directory and then I must download all the files to be sure. But after that it works.

This sounds like you are looking to use svn revert. If you are new to SVN and not good at using a command line version, I recommend using a SVN client with a graphical interface. For example, I am on windows and have two clients installed. One is a basic command line tool and the other is Smart SVN

Sometimes I read and translate things which should not be there. For example on https://www.blender.org/manual/fr/physics/introduction.html they were something about mars to delete in the english .rst and so on my french .po. ( someone has seen it )

May/must I change it on the original .rst ? I thought it was for another project or "team".
Maybe I could say it to someone each time.

If you have the original RST files you also have commit rights to that repository. Simply follow the contributing to the manual guide:
https://www.blender.org/manual/about/contribute.html

Sometimes I translate words from the interface which are not the good translated words ( or simply I don't agree ) but if I use the good one ( my good one ) it will be different from the interface.

I would use whatever the translated interface says.

when someone changes a .rst ( like the one on mars ) nothing say it to me. Is there a way to know it automatically ( with svn I suppose?)

I just pay attention to https://developer.blender.org/audit/query/ji9F0ABm_HOP/#R

> I have always errors on my local base and I must sometimes delete all the directory and then I must download all the files to be sure. But after that it works. This sounds like you are looking to use `svn revert`. If you are new to SVN and not good at using a command line version, I recommend using a SVN client with a graphical interface. For example, I am on windows and have two clients installed. One is a basic command line tool and the other is [Smart SVN](http://www.smartsvn.com/) > Sometimes I read and translate things which should not be there. For example on https://www.blender.org/manual/fr/physics/introduction.html they were something about mars to delete in the english .rst and so on my french .po. ( someone has seen it ) > > May/must I change it on the original .rst ? I thought it was for another project or "team". > Maybe I could say it to someone each time. If you have the original RST files you also have commit rights to that repository. Simply follow the contributing to the manual guide: https://www.blender.org/manual/about/contribute.html > Sometimes I translate words from the interface which are not the good translated words ( or simply I don't agree ) but if I use the good one ( my good one ) it will be different from the interface. I would use whatever the translated interface says. > when someone changes a .rst ( like the one on mars ) nothing say it to me. Is there a way to know it automatically ( with svn I suppose?) I just pay attention to https://developer.blender.org/audit/query/ji9F0ABm_HOP/#R

Alexandr commented

2016-08-09 15:45:14 +02:00

Added subscriber: @alvlapo

Alexandr commented

2017-03-12 16:22:13 +01:00

I want to take part in the translation of documentation into Russian. But I can't commit changes documentation repo. Please add me to the documentation project.

Aaron Carlisle commented

2017-03-12 16:24:18 +01:00

I added you. Username and password are the same has what you used on this website.

Aaron Carlisle commented

2017-04-14 21:22:09 +02:00

Changed status from 'Open' to: 'Resolved'

Aaron Carlisle closed this issue

2017-04-14 21:22:09 +02:00

Aaron Carlisle self-assigned this 2017-04-14 21:22:09 +02:00

Aaron Carlisle commented

2017-04-14 21:22:09 +02:00

Marking as resolved, for the most part, we have the workflow together. If people are interested in joining the project please follow the steps on #documentation and email the mailing list.

Sign in to join this conversation.

No Label

Download

What's New

Blender Studio

Manual

Developers Blog

Documentation

Benchmark

Blender Conference

Development Fund

One-time Donations

Translations (how to handle, design task) #43083

Current Status

Translation Workflow