Document Translation #120

nikogu · 2017-11-06T10:18:27Z

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.

But we are short of staff :-( So, we want some volunteers to help us to translate antd's documentation into English. Every translation task needs a translator and a reviewer. Both of them are expected that they had used the component(AvatarLsit PageHeader etc...) in real world.

Translator

A translator should be familiar with both Chinese and English.

If you want to be a volunteer translator, just comment this issue. For example, "I want to be the translator of button and alert ....". And then, we will update this issue(e.g. button (translator: @afc163 , reviewer: @ddcat1115 )), and ping you.

Premise:

ant-design-pro-site is our site of Ant Design Pro and it is repository witch docs here.
ant-design-pro is ant-design-pro-site's submodule, it contains component's docs.

Contributing:

Fork
- docs: ant-design-pro-site and git clone
- components: ant-design-pro and git clone
Create a branch starting at master and name it as translation-[xxx]
npm install && npm start, see: Development
Find Markdown files and the index.md and demo/*.md use different format, see: Internationalization of Ant Design website ant-design#1423
- docs: under /docs
- components: under /scaffold/src/components/xxx(xxx is the component which you need to translate)
Just translate it, and you had better read our advice first.
Create a pull request when your translation is done, and ping your reviewer.
- docs: request to ant-design-pro-site:master
- components: request to ant-design-pro:master
PR will be merged, if your reviewer think it is OK.

See:

Reviewer

A reviewer should be a native English speaker.

If you want to be a volunteer reviewer, just comment this issue. For example, "I want to be the reviewer of button and alert...". And then, we will update this issue(e.g. button (translator: @afc163 , reviewer: @ddcat1115 )), and ping you.

After your corresponding translator finish his/her work, you should review and provide some advice.

Example

docs: 105
components: 123

TODOs

/docs

/components

The text was updated successfully, but these errors were encountered:

gardner · 2017-11-06T21:54:37Z

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.

afc163 · 2017-11-07T04:20:20Z

@tmattio @Kikobeats @viztor @acomito

viztor · 2017-11-07T05:20:14Z

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

viztor · 2017-11-09T09:49:37Z

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

gardner · 2017-11-10T12:44:11Z

@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. :)

gardner · 2017-11-10T12:48:09Z

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.

sundaisun · 2017-11-11T01:37:37Z

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 :)

viztor · 2017-11-11T07:28:17Z

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

priezz · 2017-11-26T22:15:45Z

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.

davidctj · 2017-12-05T09:12:33Z

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

B1anker · 2017-12-07T03:25:21Z

Can CET-6 have a try？

chenshuai2144 · 2017-12-07T03:36:29Z

@B1anker Of course.
you can translate and then pr

xueqingxiao · 2017-12-07T05:32:36Z

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

bunshar · 2017-12-11T11:09:51Z

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.

chenshuai2144 · 2017-12-11T12:03:06Z

@bunshar 当然需要了

priezz · 2017-12-11T12:36:26Z

@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 :)

lorecrafting · 2017-12-11T20:00:52Z

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.

lorecrafting · 2017-12-12T02:58:02Z

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!

bunshar · 2017-12-13T12:13:14Z

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;

priezz · 2017-12-13T12:31:09Z

@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.

bunshar · 2017-12-13T12:53:37Z

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.

ddcat1115 · 2017-12-26T02:28:08Z

@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 😃

ZoeVonFeng · 2018-01-04T08:19:08Z

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.

atav32 · 2018-03-28T20:17:21Z

Sign me up. I'll help translate.

meluo · 2018-05-16T14:51:59Z

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

sroze · 2018-05-25T14:37:31Z

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

zhuzisheng · 2018-07-10T11:42:42Z

I can help translate the login part into English.

maria-le · 2018-08-14T04:13:56Z

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

chloesun · 2019-02-05T21:16:43Z

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

robsonsilv4 · 2019-10-16T18:40:11Z

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

BoyoJustice · 2019-11-30T12:01:04Z

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

cyw1361546576 · 2019-12-14T10:26:17Z

ok ---原始邮件--- 发件人:"Garrett Beyer"<[email protected]> 发送时间:2019年11月30日星期六下午8:1 收件人:"ant-design/ant-design-pro"<[email protected]> 抄送:"cyw1361546576"<[email protected]>;"Comment"<[email protected]> 主题: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.

nelsonacalves · 2020-08-14T14:54:38Z

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?

Update src/components/users/modal.js

semezzato · 2022-03-13T07:55:24Z

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.

Yoann-Paquet · 2022-05-05T08:21:40Z

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

qq6690876 · 2022-05-31T15:25:01Z

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

nikogu added the 😸Documentation label Nov 6, 2017

nikogu mentioned this issue Nov 6, 2017

Any plans to support English docs? #54

Closed

nikogu mentioned this issue Nov 10, 2017

How to get my app translated (International: Built-in i18n solution) #151

Closed

afc163 mentioned this issue Dec 6, 2017

Ant Design Pro Users 👨🏻‍💻👩🏻‍💻👨🏻‍💻👩🏻‍💻 #99

Open

zwwill mentioned this issue Dec 12, 2017

【翻译】Ant Design 3.0 驾到 zwwill/blog#16

Open

chenshuai2144 mentioned this issue Dec 25, 2017

请问国际化英文版内置文案的开发计划？ #497

Closed

ddcat1115 mentioned this issue Dec 26, 2017

English #489

Closed

ant-design-bot added the Inactive label May 11, 2018

chenshuai2144 removed the need help label May 29, 2018

ant-design-bot added the Inactive label Jun 29, 2018

ant-design deleted a comment from cyw1361546576 Jul 9, 2018

kaoding mentioned this issue Aug 17, 2018

v2 documentation upgrade #2007

Closed

21 tasks

afc163 moved this from In progress to Done in Pro 二期 Sep 2, 2018

afc163 closed this as completed Sep 2, 2018

jljsj33 mentioned this issue Nov 2, 2018

Document Translation ant-design/ant-design-landing#1

Open

16 tasks

jljsj33 mentioned this issue Feb 20, 2019

Document Translation ant-design/ant-motion#204

Closed

21 tasks

dengli1216 pushed a commit to myForkProject/ant-design-pro that referenced this issue Mar 17, 2021

Merge pull request ant-design#120 from catest/patch-1

73abfd7

Update src/components/users/modal.js

chenshuai2144 mentioned this issue Dec 28, 2023

Pro components website is not fully internationalized ant-design/pro-components#7992

Closed

Document Translation #120

Document Translation #120

Comments

nikogu commented Nov 6, 2017 • edited by valleykid Loading

Volunteer Wanted

Translator

Reviewer

Example

TODOs

gardner commented Nov 6, 2017

afc163 commented Nov 7, 2017

viztor commented Nov 7, 2017 • edited Loading

viztor commented Nov 9, 2017

gardner commented Nov 10, 2017 • edited Loading

gardner commented Nov 10, 2017

sundaisun commented Nov 11, 2017

viztor commented Nov 11, 2017 • edited Loading

priezz commented Nov 26, 2017 • edited Loading

davidctj commented Dec 5, 2017

B1anker commented Dec 7, 2017 • edited Loading

chenshuai2144 commented Dec 7, 2017

xueqingxiao commented Dec 7, 2017

bunshar commented Dec 11, 2017

chenshuai2144 commented Dec 11, 2017

priezz commented Dec 11, 2017 • edited Loading

lorecrafting commented Dec 11, 2017 • edited Loading

lorecrafting commented Dec 12, 2017 • edited Loading

bunshar commented Dec 13, 2017

priezz commented Dec 13, 2017 • edited Loading

bunshar commented Dec 13, 2017

ddcat1115 commented Dec 26, 2017

ZoeVonFeng commented Jan 4, 2018 • edited Loading

atav32 commented Mar 28, 2018

meluo commented May 16, 2018

sroze commented May 25, 2018

zhuzisheng commented Jul 10, 2018

maria-le commented Aug 14, 2018

chloesun commented Feb 5, 2019

robsonsilv4 commented Oct 16, 2019

BoyoJustice commented Nov 30, 2019

cyw1361546576 commented Dec 14, 2019 via email

nelsonacalves commented Aug 14, 2020 • edited Loading

Volunteer Wanted

semezzato commented Mar 13, 2022

Yoann-Paquet commented May 5, 2022

qq6690876 commented May 31, 2022

nikogu commented Nov 6, 2017 •

edited by valleykid

Loading

viztor commented Nov 7, 2017 •

edited

Loading

gardner commented Nov 10, 2017 •

edited

Loading

viztor commented Nov 11, 2017 •

edited

Loading

priezz commented Nov 26, 2017 •

edited

Loading

B1anker commented Dec 7, 2017 •

edited

Loading

priezz commented Dec 11, 2017 •

edited

Loading

lorecrafting commented Dec 11, 2017 •

edited

Loading

lorecrafting commented Dec 12, 2017 •

edited

Loading

priezz commented Dec 13, 2017 •

edited

Loading

ZoeVonFeng commented Jan 4, 2018 •

edited

Loading

nelsonacalves commented Aug 14, 2020 •

edited

Loading