three.js documentation Chinese version

[nicholas-yangding]

Hi, We are a team from china who love open source.We want to translate the documentation into
Chinese. About now our plan is to translate pages and convert them into static pages.
So I want to know how we can put these pages into this repo , or merge them into the threejs.org documentation part?
Pleased to hear reply.

[mrdoob]

Previous discussion: #6840

The idea was to move all these files inside a en folder, copy the folder into a zh folder and start translating one by one.

[mrdoob]

Okay, I just did added basic support: #14750

[mrdoob]

If you copy the folder api/en/ to api/zh/ these links will work:

https://rawgit.com/mrdoob/three.js/dev/docs/#api/en/animation/AnimationAction
https://rawgit.com/mrdoob/three.js/dev/docs/#api/zh/animation/AnimationAction

[takahirox]

Curious to know how we sync non-English docs with English doc. For example, if someone updates English doc, who and how do we update non-English docs?

[mrdoob]

Things will definitely be out of sync for a while but I think we should start somewhere.

[takahirox]

OK

Things will definitely be out of sync for a while

Let's add this note somewhere. Maybe it's good start.

[mrdoob]

We still need to add a language selector in the left panel somehow.

In the meantime, @nicholas-yangding do you think you can start adding pages?

[WestLangley]

https://rawgit.com/mrdoob/three.js/dev/docs/#api/en/animation/AnimationAction

Won't that break existing links to the docs in help sites, for example?

[mrdoob]

https://rawgit.com/mrdoob/three.js/dev/docs/#api/en/animation/AnimationAction

Won't that break existing links to the docs in help sites, for example?

I have added a "redirection":
https://github.com/mrdoob/three.js/blob/dev/docs/index.html#L35-L43

[nicholas-yangding]

@mrdoob ok, thanks so much. We will start it next week because this week I need to gather some people.
Besides, Not only the api docs we will translate, other docs too. Then Other docs how to organize them?

[mrdoob]

We can do the same for manual. Do you want to start translating the manual pages first?

[nicholas-yangding]

@mrdoob yes thanks. We have about 20+ engineers, and we want to cover all of the documentation website with translating.

[mrdoob]

@nicholas-yangding

Okay, I've just added localisation support to manual pages too: #14755

https://rawgit.com/mrdoob/three.js/dev/docs/#manual/zh/introduction/Creating-a-scene

[HypnosNova]

@nicholas-yangding 我支持这个做法，虽然我不需要看中文，英文都看得懂。我建议搞个翻译组织吧。
I think maybe we should have a group to do this work. Since I'm chinese too, we can focus on how to do this work more efficiently.
What about make a list which contains professional vocabulary to chinese word first? In that way we have a standard rule also anyone could follow the rule to translate.

[chenxiaoleizi]

@nicholas-yangding 我能加入翻译吗？
good idea!

[nicholas-yangding]

@mrdoob so much thanks! Maybe a language filter should be added on the left in page? We will start soon after this week
@HypnosNova @chenxiaoleizi We will have a wechat group to communicate with each other in translation group. Please send me(nicholaswang101@gmail.com) an email with your wechat id. So pleased to see so many people participated!

[lafflan]

@nicholas-yangding count me in

[nicholas-yangding]

@mrdoob now the translation is in progress, soon we will pull first request to the repo with some translations.

[HypnosNova]

@nicholas-yangding Have you invited me to the wechat group?

[nicholas-yangding]

@mrdoob hi, please add /zh to this directory

files in it also need to be translated
so much thx!

[WestLangley]

please add /zh to this directory to examples

If you are going to do that, how about a separate repo, instead? Maybe a separate repo for both the zh docs and zh examples?

[mrdoob]

@WestLangley I don't think they mean to the examples folder. I think they mean to the examples section in the docs.

[Mugen87]

I think they mean to the examples section in the docs.

Done with #16680 🎉

[linbingquan]

related #19228

[krisine]

Hello, I am a Chinese native speaker, quite interested in Three.js development. And I want to join in the Chinese version of three.js documentation. How can I participate in?

[Mugen87]

@sooia There are some pages in the examples section which are not yet translated. E.g.:

https://threejs.org/docs/index.html#examples/zh/loaders/SVGLoader
https://threejs.org/docs/index.html#examples/zh/utils/BufferGeometryUtils
https://threejs.org/docs/index.html#examples/zh/utils/SceneUtils

Translating these pages would be a great contribution.

[krisine]

@sooia There are some pages in the examples section which are not yet translated. E.g.:

https://threejs.org/docs/index.html#examples/zh/loaders/SVGLoader https://threejs.org/docs/index.html#examples/zh/utils/BufferGeometryUtils https://threejs.org/docs/index.html#examples/zh/utils/SceneUtils

Translating these pages would be a great contribution.

Hi, @Mugen87 . I have translated the pages in the examples that you mentioned above, and I have created a PR #23262. Please have a check. Thanks. If there are other pages that haven't been translated, please @ me or email me( faaa@live.com ) to let me know.

[cswwww]

@Mugen87 Hello, I am a developer from China. I'm learning threeJS and noticed some differences between the Chinese and English manuals since PR #25468. I would like to know if this translation and synchronization task has already been picked up, and if not, I would like to participate in it.
I plan to update the Chinese manual by translating from the English manual.

[Mugen87]

I would like to know if this translation and synchronization task has already been picked up

Not that I am aware of.