Document Translation

Question

Document Translation

nikogu opened this issue 7 years ago · 45 comments

Answer 1 · 2017-11-06T21:54:37.000Z

Thanks for taking the time to translate the documentation!

This is really great. Our UX team brought Ant Design to us and asked if we could use this on a new project. The design and engineering decisions I have learned about across all of the ant design projects are amazing and I would love to use and participate but by ability to read or write Chinese is non-existent.

Answer 2 · 2017-11-07T04:20:20.000Z

@tmattio @Kikobeats @viztor @acomito

Answer 3 · 2017-11-07T05:20:14.000Z

@afc163 thanks for mentioning me
I might want to take getting started.
ant-design/ant-design-pro-site#107

Answer 4 · 2017-11-09T09:49:37.000Z

review needed for getting-started.md:
@gardner In case you might want to lend a helping hand.

Answer 5 · 2017-11-10T12:44:11.000Z

@viztor all of the language was technically correct. I don't know how to describe it other than English with Chinese characteristics. There were a few things that were understandable but sounded non-native. I took a pass at updating it and submitted a PR here: ant-design/ant-design-pro-site#112

I don't understand Chinese but as a native Californian I am happy to help with translation however I can. :)

Answer 6 · 2017-11-10T12:48:09.000Z

The current way the docs are organized leaves a little to be desired. I am new to bisheng so I will read up on it and see if there is a way to modularize translations a bit better. I know some folks that may be able to help out with other languages.

Answer 7 · 2017-11-11T01:37:37.000Z

Hi, just came across ant design pro, great work! I am a product designer on the Design System team at Eventbrite, based in San Francisco, and would like to help translating layout.md. Let me know :)

Answer 8 · 2017-11-11T07:28:17.000Z

@sundaisun Hi, already working on Layout.md, forgot to mention it here.
@nikogu also i18n.md and cli.md are ready for review.

Answer 9 · 2017-11-26T22:15:45.000Z

Hello! First of all, thanks for the great template!

This issue is about documentation translation, but I don't want to open the separate one for the template translation. I have written a short script to automatically translate the cloned template into English with Google. Here it is:

REGEXP='\p{Han}[\p{Han}|\s|,|。|，|\.|“|”|0-9|a-z|A-Z|-|-|:|：]*'; 
rg --color never "$REGEXP" -o --vimgrep src | sed -r "s|([^:]+):([^:]+):([^:]+):(.+)|STR='\4'; sed -i \"\2s/\$STR/\$\(trans --brief zh:en \\\"\$STR\\\"\)/\" $(pwd)/\1;|g" > /tmp/translate.sh;
rg --color never "$REGEXP" -o --vimgrep mock | sed -r "s|([^:]+):([^:]+):([^:]+):(.+)|STR='\4'; sed -i \"\2s/\$STR/\$\(trans --brief zh:en \\\"\$STR\\\"\)/\" $(pwd)/\1;|g" >> /tmp/translate.sh;
sh /tmp/translate.sh;

Dependencies: Translate Shell, ripgrep

macOS users should update to the GNU sed firtst:

brew install --with-default-names gnu-sed

The result is rather acceptable - translation is not ideal, of course, but at lease it enables Chinese non-speaker to start with.

Hope it helps to someone :)

Edit: translate within the commands changed to the more common trans.
Edit2: macOS instruction added.

Answer 10 · 2017-12-05T09:12:33.000Z

Hi, thanks for providing such amazing ant design pro!
I'm a frontend developer who has been using ant design a lot, love it!
I'd like to translate on faq.md && theme.md

Answer 11 · 2017-12-07T03:25:21.000Z

Can CET-6 have a try？

Answer 12 · 2017-12-07T03:36:29.000Z

@B1anker Of course.
you can translate and then pr

Answer 13 · 2017-12-07T05:32:36.000Z

I can take biz-icon.md, deploy.md, error.md, faq.md.

Answer 14 · 2017-12-11T11:09:51.000Z

I can help in making demos in english. In ant-design the demos have data in english and I can convert that within week if it's required.

Answer 15 · 2017-12-11T12:03:06.000Z

@bunshar 当然需要了

Answer 16 · 2017-12-11T12:36:26.000Z

@bunshar, my script above translates demo data. For me it seems that it could be too early for the fine tuned manual translation as the product is still in active development stage. However, I could be wrong :)

Answer 17 · 2017-12-11T20:00:52.000Z

Hello, I would like to help with translation. Are you folks trying to get all the documentation translation done by the time Ant Pro 1.0 is released?

Also i'm currently translating the Ant Pro component data, and also mock data so that the Dashboard can be displayed in English. Should I put the translation of mock data and ant pro sample components in a new 'english' branch?
@nikogu

Thanks!

Edit: Oops didn't see the awesome work that @priezz did with the script. Don't want to do double duty with the demo translations since @bunshar said he could do it, so i'll wait for further coordination.

Answer 18 · 2017-12-12T02:58:02.000Z

I will start translating components in the ant-design-pro repo, going to start with Charts!

Edit: Just created a PR for translated Charts components. Would like a review, thanks!

Edit: I was also wondering, does the release of Ant Design Pro 1.0 have a hard dependency on translating docs to English? Or would it be possible that Ant Pro 1.0 gets released first, and Pull Requests for translations can come in later? Thanks!

Answer 19 · 2017-12-13T12:13:14.000Z

Nice script @priezz !
Needed some changes to get it to run in Mac so sharing that

Translate script for mac users as sed in mac is not same as sed in gnu

install with - brew install --with-default-names gnu-sed
and then use that. Also the translate doesn't work but trans does

REGEXP='\p{Han}[\p{Han}|\s|,|。|，|\.|“|”|0-9|a-z|A-Z|-|-|:|：]*'; 
rg --color never "$REGEXP" -o --vimgrep src | gsed -r "s|([^:]+):([^:]+):([^:]+):(.+)|STR='\4'; gsed -i \"\2s/\$STR/\$\(trans --brief zh:en \\\"\$STR\\\"\)/\" $(pwd)/\1;|g" > /tmp/translate.sh;
rg --color never "$REGEXP" -o --vimgrep mock | gsed -r "s|([^:]+):([^:]+):([^:]+):(.+)|STR='\4'; gsed -i \"\2s/\$STR/\$\(trans --brief zh:en \\\"\$STR\\\"\)/\" $(pwd)/\1;|g" >> /tmp/translate.sh;
sh /tmp/translate.sh;

Answer 20 · 2017-12-13T12:31:09.000Z

@bunshar, thank you for your addition! You are right, unfortunately mac's sed is not gnu-compatible.
However, with --with-default-names option, you have provided, brew installs sed without g in the front. So the script stays unchanged. I also update translate to trans in the initial script as it is their recommended command name.

Answer 21 · 2017-12-13T12:53:37.000Z

The issue is that this breaks my ability to keep the repo in sync as there are so many changes.

I think this is the right time to start translation. The script is a good starting point and will save quite a lot of effort.

Answer 22 · 2017-12-26T02:28:08.000Z

@lorecrafting The Ant Design Pro 1.0 do not rely on the translation work, and only some of the guide docs may be changed after the 1.0 release. As for components, you can start your translation at anytime 😃

Answer 23 · 2018-01-04T08:19:08.000Z

I can help on " use-components-alone.md" translation if it is not taken yet. And thank you for the great framework!
Update: I already finished and created a pull request since it was a short page. It is open for review.

Answer 24 · 2018-01-10T08:44:15.000Z

@afc163 I'd Like to join the translation team!☺☺☺

Answer 25 · 2018-01-19T10:01:31.000Z

@afc163, me too! English native with some basic Chinese(lacking mandarin grammar, something I guess the reviewers can handle). Wishing to jump on the translation team.

Answer 26 · 2018-01-22T14:45:12.000Z

I would love to be a translator for this project, really enjoy antd and antdpro, want to contribute more.

Answer 27 · 2018-01-24T04:00:31.000Z

Some docs have been updated(since v1.0) and we can restart our translation 💦

Answer 28 · 2018-01-28T17:02:41.000Z

Can we start a Trello board to keep track of the translation effort between multiple versions and projects? Having to track down PRs and issues just to find the latest work progress is simply not efficient, and here is case study of how Trello used Trello to manage the translation process: http://www.oneskyapp.com/blog/trello-localization-global-marketing/

The issues in ant-design repo seem to reference this issue for tracking the translation of specs as well? I'm just lost in the translation works for ant-design spec, ant-design components, and ant-design pro. Having a globally accessible Trello should help a lot with this process.

Thanks!

Answer 29 · 2018-02-01T18:39:45.000Z

I am also a big fan and and native English speaker and happy to help where I can. I should have already forked this repo before starting my latest project, but will do so now. Thank you for your great effort!

Answer 30 · 2018-02-17T23:17:28.000Z

Hi, just translated the Login component and sent PR, will pick up more later :-)

Answer 31 · 2018-03-05T11:53:46.000Z

I'd love to help with both review and translation. I am a technical writer, English native and Chinese bilingual writing and reading proficiency. I can start with reviewing /docs/layout.md and components/AvartarList.md. I also spotted a few small grammar errors in getting-started.md, if you'd like me to correct that too.

我可以帮忙中英翻译和修改英文的版本。上面列了几个md是我可以先修改的。（我英文中文双语，繁体中文和简体中文都能专业读写）

Answer 32 · 2018-03-09T07:46:43.000Z

@tchern You are very welcome! But the /docs/layout and components/AvatarList.md is translated and reviewed already(you can check the TODOs progress in above), you can help us to translate the other parts, just mark your name after the item you have chosen. Or you can join the review work -> to be reviewed

Answer 33 · 2018-03-28T20:17:21.000Z

Sign me up. I'll help translate.

Answer 34 · 2018-05-16T14:51:59.000Z

Module build failed: Error: Cannot use decorators and decorators2 plugin together

Answer 35 · 2018-05-25T14:37:31.000Z

Thank you all for your translation efforts. This seems to be a very nice set of UI elements ❤️

Answer 36 · 2018-07-10T11:42:42.000Z

I can help translate the login part into English.

Answer 37 · 2018-08-14T04:13:56.000Z

Google Translate does a pretty good job doesn't it? Why not just use that?

Answer 38 · 2019-02-05T21:16:43.000Z

I can help with some translation as well, feel free to reach out and let me know what pieces I can work on!

Answer 39 · 2019-10-16T18:40:11.000Z

I added README in portuguese (pt-BR), see #5438.
And i will also help to translate documentation to portuguese.

Answer 40 · 2019-11-30T12:01:04.000Z

I would be happy to be a reviewer of "router-and-nav.md" if still available.

Answer 41 · 2019-12-14T10:26:17.000Z

ok ---原始邮件--- 发件人:"Garrett Beyer"<notifications@github.com> 发送时间:2019年11月30日星期六下午8:1 收件人:"ant-design/ant-design-pro"<ant-design-pro@noreply.github.com> 抄送:"cyw1361546576"<1361546576@qq.com>;"Comment"<comment@noreply.github.com> 主题:Re: [ant-design/ant-design-pro] Document Translation (#120) I would be happy to be a reviewer of "router-and-nav.md" if still available. — You are receiving this because you commented. Reply to this email directly,view it on GitHub, orunsubscribe.

Answer 42 · 2020-08-14T14:54:38.000Z

We just finished most of translate jobs and published at pro.ant.design, welcome to visit it and review the translation. Give us PR if you find any typos. 🎅

Volunteer Wanted

Hey, guys! We are going to provide English documentation.

So,
How can i help translate?
what work is available?

Answer 43 · 2022-03-13T07:55:24.000Z

I'm a brazilian developer and I want to join this.
I want to help translate it, but in portuguese, we have a large dev market in ascension here.
By the way, it will be a nice contribution for all.

Answer 44 · 2022-05-05T08:21:40.000Z

Hello when are you going to translate Ant Design into French?

Answer 45 · 2022-05-31T15:25:01.000Z

I’m a product manager and I want to help translate it.
I'd like to translate on Result

Document Translation

Volunteer Wanted

Translator

Reviewer

Example

TODOs

Volunteer Wanted