three.js icon indicating copy to clipboard operation
three.js copied to clipboard

Published 20 hours ago • verified publisher icon mrdoob

Docs: Italian version

Open AngyDev opened this issue 3 years ago • 7 comments

Hello, I'm a software developer and a three.js user.

I'd like to contribute to the library and I think that the best way to start is by documentation. I'd like to translate the documentation into Italian.

What do you think? Is it possible?

AngyDev avatar Jul 27 '22 19:07 AngyDev

That would be a great contribution! We have an issue per language (see #24375 or #14748) so I suggest to use this one for Italian.

It's best to file PRs for specific sections (e.g. "Manual" ,"Animation" or "Core") and not for individual pages. It would be also good to only add translated pages to the it folder and not the English ones as placeholders.

Mugen87 avatar Jul 27 '22 21:07 Mugen87

Great!! I can start with the Manual section. I create it folder for the translation. Is it correct to start from the dev branch?

AngyDev avatar Jul 28 '22 07:07 AngyDev

Is it correct to start from the dev branch?

Yes.

Mugen87 avatar Jul 28 '22 08:07 Mugen87

Thanks! @Mugen87 I have a question, I saw that in the manual pages the title <h1>[name]</h1> is generated at the load of the documentation. Is it right to maintain the English name also for the Italian translation or can I translate it?

AngyDev avatar Jul 28 '22 12:07 AngyDev

I would handle this use case similar to other translations. Meaning translating the titles but keep [name] in parentheses.

Mugen87 avatar Jul 28 '22 14:07 Mugen87

Hi @Mugen87! Which is the next step? Is better to continue the translation with the reference section or with the fundamentals one?

AngyDev avatar Aug 06 '22 15:08 AngyDev

I would continue with the API reference 👍.

Mugen87 avatar Aug 06 '22 17:08 Mugen87

Is there any way I can help with this? I'm an italian sw developer and I'm getting started with three.js, it would be a great way to read the documentation and help out at the same time

davedema avatar Dec 09 '22 21:12 davedema

Hi @davedema, if you want you can translate from the Addons section, for now, I stopped there. Every time you complete a subsection you do a PR, for example, if you translate Animations you do a PR, then Controls, and so on. That way we keep each other aligned on developments. What do you think?

AngyDev avatar Dec 12 '22 08:12 AngyDev

looks good! I will work on animations then

davedema avatar Dec 13 '22 12:12 davedema

We currently have a problem with documentation translations: https://github.com/mrdoob/three.js/issues/24984

mrdoob avatar Mar 15 '23 10:03 mrdoob

Hi @davedema!!! How is the translation of the animation section going? Are you still interested in doing it?

AngyDev avatar Apr 11 '23 09:04 AngyDev