search

ant-design / ant-design-mobile

Essential UI blocks for building mobile web apps.
https://mobile.ant.design
MIT License
11.66k stars 2.4k forks source link

Translation into english #329

Closed ghost closed 7 years ago

ghost commented 8 years ago

Could you help with translation:

Updated from maintainers:

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-mobile's documentation into English. Every translation task needs a translator and a reviewer. Both of them are expected that they had used the component(Menu Drawer 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 modal ....". And then, we will update this issue(e.g. button (translator: @benjycui, reviewer: @waywardmonkeys )), and ping you.

Contributing:

  1. Fork ant-design-mobile and git clone
  2. Create a branch starting at master and name it as translation-button
  3. npm install && npm start, see: Development
  4. Find Markdown files under components/xxx(xxx is the component which you need to translate), index.md and demo/*.md use different format, see: https://github.com/ant-design/ant-design/issues/1423
  5. Just translate it, and you had better read our advice first.
  6. Create a pull request to ant-design-mobile:master when your translation is done, and ping your reviewer.
  7. PR will be merged, if your reviewer think it is OK.

See:

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: @benjycui, reviewer: @waywardmonkeys )), and ping you.

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

Example: https://github.com/ant-design/ant-design/pull/1932

TODOs

/docs/react

/components

Update by @paranoidjk

Start to Translate :tada: :tada:

Since https://github.com/ant-design/ant-design-mobile/pull/907 had been merged to master. The next step is to translate.

We need help, please feel free to open a Pull Request 😄

How to ?

git clone git@github.com:ant-design/ant-design-mobile.git
cd antd-mobile
npm install
npm start

Then open http://127.0.0.1:8001 on your favorite browser, you will see that the default language of the site had been changed to English.

  • but the homepage will auto detect your system language
  • and still you can switch to Chinese by click the button on the upper right corner of page

Tasks

  1. [x] all files which extension name is .en-US.md should be translate to English.

    include components/{foo}/index.md, and /doc/react/{bar}.md , and wiki page
    right now the content of foo.en-US.md is just a copy of it's Chinese version foo.zh-CN.md

  2. [x] all components/{foo}/demo/{bar}.md should change it's title syntax.

    see Flex or CheckboxItem as a example

cc @ant-design/ant-design-team

belohlavek commented 8 years ago

English translation would be amazing!

warmhug commented 8 years ago

Perhaps in doing this after October 31. In addition, can you help us do it.

belohlavek commented 8 years ago

I would be glad to help with spelling mistakes (in English), but I don't speak Chinese! 😅

yiminghe commented 8 years ago

@benjycui will be responsible for this

benjycui commented 8 years ago

Will do this after 1.0 is published, for API is unstable now.

ecerroni commented 7 years ago

Any ETA for this translation?

paranoidjk commented 7 years ago

we will working on english documentation in the next few month. ref https://github.com/ant-design/ant-design-mobile/pull/901

Edited by @benjycui : task list had been move to the top of this issue.

benjycui commented 7 years ago

Updated task list to @MichaelSavin 's comment

@paranoidjk we should try to translate one or two components' documentation to make sure mobile.ant.design is ready.

paranoidjk commented 7 years ago

@benjycui ok, i will try it right now.

paranoidjk commented 7 years ago

Start to Translate :tada: :tada:

Since https://github.com/ant-design/ant-design-mobile/pull/907 had been merged to master. The next step is to translate.

We need help, please feel free to open a Pull Request 😄

How to ?

git clone git@github.com:ant-design/ant-design-mobile.git
cd antd-mobile
npm install
npm start

Then open http://127.0.0.1:8001 on your favorite browser, you will see that the default language of the site had been changed to English.

  • but the homepage will auto detect your system language
  • and still you can switch to Chinese by click the button on the upper right corner of page

Tasks

  1. [ ] all files which extension name is .en-US.md should be translate to English.

    include components/{foo}/index.md, and /doc/react/{bar}.md , and wiki page
    right now the content of foo.en-US.md is just a copy of it's Chinese version foo.zh-CN.md

  2. [ ] all components/{foo}/demo/{bar}.md should change it's title syntax.

    see Flex or CheckboxItem as a example

cc @ant-design/ant-design-team

afc163 commented 7 years ago

I call uploader and badge

yesmeck commented 7 years ago

I'll work on drawer and menu.

ddcat1115 commented 7 years ago

steps & tag ~

fr11dom commented 7 years ago

switch & toast

lixiaoyang1992 commented 7 years ago

I want to be the translator of modal.

yesmeck commented 7 years ago

有些公共的词是不是约定下，比如 prop 在 antd 文档里叫"属性"， 这里叫"成员"。

paranoidjk commented 7 years ago

@yesmeck props --> 属性， follow the antd convention

afc163 commented 7 years ago

I call progress and result.

benjycui commented 7 years ago

Could someone help us to translate intl-example? ant-design/intl-example#13

warmhug commented 7 years ago

@iyutao 这里翻译还要做吗？

paranoidjk commented 7 years ago

cc @zhang740

silentcloud commented 7 years ago

All works have been done.