Vietnamese Translation Progress
tesseralis opened this issue · 148 comments
For New Translators
To translate a page:
- Check that no one else has claimed your page in the checklist and comments below.
- Comment below with the name of the page you would like to translate. Take only one page at a time.
- Clone this repo, translate your page, and submit a pull request!
Before contributing, read the glossary and style guide to understand how to translate various technical and React-specific terms.
You can use the Crowdin as a base for your translation. Make sure to compare the content with the current React website to makes sure everything is up to date! (NOTE: delete this if the language doesn't have any Crowdin contributions)
Please be prompt with your translations! If you find that you can't commit anymore, let the maintainers know so they can assign the page to someone else.
For maintainers
When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:
- Home Page (@tesseralis) #1
When PRs are merged, make sure to mark that page as completed!
Core Pages
To do before releasing as an "official" translation. Please translate these pages first.
Basics
- Hello World (@ltmylinh ) #9
- Introducing JSX (@phonglk) #7
- Rendering Elements (@ltmylinh) #12
- Components and Props (@tuyengabi)
- State and Lifecycle (@vkhanh74 #69)
- Handling Events (@ntban15) #17
- Conditional Rendering (@pnminh1710) #21
- Lists and Keys (@NhanHoang8195) #19
- Forms (@pnminh1710)
- Lifting State Up (@cuongtran8) #28
- Composition vs Inheritance (@cuongtran8) #32
- Thinking in React (@cuongtran8) #25
API Reference
- React (@Quynh-Nguyen) #20
- React.Component (@pthanh1703)
- ReactDOM (@Quynh-Nguyen)
- ReactDOMServer (@mduclehcm)
- DOM Elements (@hweeTan) #39
- SyntheticEvent (@hweeTan) #39
- Test Recipes (@luubinhan) #78
- Shallow Renderer (@hweeTan) #53
- Test Renderer (@hweeTan) #53
- JS Environment Requirements (@Ryan-LT)
- Glossary (@DungGramer) #226
Navigation
These are the navigation links that appear in the sidebar. Possibly wait until
the corresponding sections are translated to do these.
- tutorial/nav.yml
- docs/nav.yml (@fozg) #199
- docs/footerNav.yml @fozg) #199
- docs/headerNav.yml @fozg) #199
Next Steps
These are the next most important translations, ordered by importance:
Installation
- Getting Started (@quyctd) #113
- Add React to a Website
- Create a New React App (@nguyenary) #162
- CDN Links (@hiimnhan ) #157
- Release Channels (@vovantamvn) #232
Hooks
Everyone is hooked on hooks! People are really excited about these and it would be great for them to be translated.
- Introducing Hooks (@hieuhani) #22
- Hooks at a Glance (@hieuhani) #23
- Using the State Hook(@phonglk)
- Using the Effect Hook (@luubinhan) #44
- Rules of Hooks (@luubinhan) #44
- Building Your Own Hooks (@lPaths) #195
- Hooks API Reference (@fozg) #210
- Hooks FAQ
Testing
- Testing Overview (@lequangnamsoraly2009) #159
- Testing Recipes
- Testing Environments (@danglequocbao001) #182
Warnings
These are the pages that you get when you click the links in the console (e.g. https://reactjs.org/warnings/dont-call-proptypes.html). People tend to search these, so please don't translate the error message itself.
- dont-call-proptypes (@kctrnn) #174
- invalid-aria-prop (@dinhtrung1308) #200
- invalid-hook-call-warning (@dinhtrung1308) #200
- legacy-factories (@dinhtrung1308) #183
- refs-must-have-owner (@lequangnamsoraly2009) #208
- special-props (@dinhtrung1308) #190
- unknown-prop (@lequangnamsoraly2009) #198
Advanced Guides
- Accessibility (@ThinhNu) #29
- Code-Splitting (@ThinhNu) #24
- Context (@hweeTan)
- Error Boundaries (@hweeTan)
- Forwarding Refs (@huykon) #191
- Fragments
- Higher-Order Components (@hiimnhan) #215
- Integrating with Other Libraries (@ncnthien) #222
- JSX In Depth (@pthanh1703) #203
- Optimizing Performance (@hoangvanhoa1701) #212
- Portals (@huykon) #176
- Profiler API (@fozg) #199
- React Without ES6 (@hoangvanhoa1701) #180
- React Without JSX (@hoangvanhoa1701) #184
- Reconciliation (@hoangvanhoa1701) #193
- Refs and the DOM (@nguyentran-se) #206
- Render Props (@hphuocthanh) #205
- Static Type Checking (@qhuu2742) #207
- Strict Mode (@nhannv) #224
- Typechecking With PropTypes (@hoangvanhoa1701) #219
- Uncontrolled Components (@ThaoLe366) #167
- Web Components (@nguyentran-se) #186
FAQ
- APIs and AJAX
- Babel, JSX, and Build Steps
- Passing Functions to Components
- Component State (@nguyenary) #168
- Styling and CSS
- File Structure (@tedle1997) #172
- Versioning Policy (@nguyenary) #204
- Virtual DOM and Internals (@qhuu2742) #181
Contributing
Priority: Low
- How to Contribute (@kvphan5)
- Codebase Overview (@beebapcay) #239
- Implementation Notes
- Design Principles (@beebapcay) #234
Components
Components in src/components
that have some text in them.
- CodeEditor
- CodeExample
- ErrorDecoder
- LayoutFooter
- LayoutHeader
- MarkdownPage
Additional Translations
These are not the primary translation targets.
- Blog
- Community
Seems like the link to the glossary is dead. I believe it's supposed to be #2
I'll do the tutorial page.
@anhphamduy D'oh, this issue is autogenerated and I forgot to actually make a glossary issue. Feel free to create one!
Hello @anhphamduy, when will you plan to start the Tutorial translation?
@nampdn By next week probably. Is it urgent?
I will translate * Hello World * this weekend.
I will do Introducing JSX
Nam (@nampdn) ơi em update bạn @phonglk và @anhphamduy vào danh sách đóng góp translate tiếng việt nhé. Cám ơn em.
I will continue to do Components and Props
by this weekend
@nampdn By next week probably. Is it urgent?
@anhphamduy It's the most high priority because we will need to complete home
and tutorial
first in order to make the first PR to official repo. Could you do it by the end of this week?
@nampdn Hmm, I wouldn't say you needed to do those two first. The entire "Core Pages" section, including "Basics" and "API Pages" should be done first, but in any order you feel okay with.
Should we have a discussion channel that we can discuss things actively, may be Slack
?
@phonglk I totally agree with you. It would be great if we have a Slack channel to discuss something about translation.
Just joined there. also created the channel and invited you guys.
I am a bit busy now so my progress will be slow. Thank you for your understanding.
Hi. I'll do Handling Events this weekend.
Hi all.
I'll help API Reference - React page at nights and weekend.
Hi all.
I will do Conditional Rendering page.
Hi all,
I will do Lists and Keys page.
I'm going to do React.Component.
Hi all,
I'm going to do Forms page
Hi all,
I'm going to do ReactDOM page.
Hi all, I can help with Accessibility.
Hi, I finished "Thinking in react", can maintainer please have a look on that? Thanks
I will translate 'Lifting State Up' page next
Thanks, @cuongtran8. I just finished the review in Your PR. Thank you so much.
I'm going to do FAQ
I will translate "Composition vs Inheritance" next. One small question does it make sense to create a PR with [WIP] in the title, so everyone knows that part is in progress/done rather than keeping communication on this page?
Hi @cuongtran8 : Yes, you can create a PR with [WIP] in the title, then you don't need to comment on this issue. Or you can pick up the available part, then edit this issue and add your name beside it.
Hi @cuongtran8 : Yes, you can create a PR with [WIP] in the title, then you don't need to comment on this issue. Or you can pick up the available part, then edit this issue and add your name beside it.
Unfortunately, I am not able to edit that. I guess that there is only a permission issue.
Hi @cuongtran8 I will add you as a maintainer for Vietnamese translation.
Hi @tesseralis: Currently, @nampdn is busy with his project, so may I add @cuongtran8 and @ThinhNu as maintainers for the Vietnamese team?
@ltmylinh sure! I'll add them.
Thank you @tesseralis
Hi @locronaldo, if you want to contribute for Vietnamese translation, please comment here. Thanks.
Thanks @mduclehcm (y)
Hi , i am Tuyen (junior developer in France) i would like to join of translating with you . I am translating the page Components ans Props . Bạn @phonglk có đánh dấu sẽ dịch trang này từ tháng Hai, mình xin phép dịch hoàn thành trang này. Thank you
Hi, I'm Huy and I want to help translating ReactJS. May I do the DOM Elements and SyntheticEvent pages, permalink docs/dom-elements.html and docs/events.html respectively? Thanks
Hi, I'm Huy and I want to help translating ReactJS. May I do the DOM Elements and SyntheticEvent pages, permalink docs/dom-elements.html and docs/events.html respectively? Thanks
Thanks a lot @hweeTan
Hi , i am Tuyen (junior developer in France) i would like to join of translating with you . I am translating the page Components ans Props . Bạn @phonglk có đánh dấu sẽ dịch trang này từ tháng Hai, mình xin phép dịch hoàn thành trang này. Thank you
Cảm ơn bạn @tuyengabi
Hi all, I will translate Test Utilities page
Thank you @pnminh1710 (y)
Hi , i am Tuyen (junior developer in France) i would like to join of translating with you . I am translating the page Components ans Props . Bạn @phonglk có đánh dấu sẽ dịch trang này từ tháng Hai, mình xin phép dịch hoàn thành trang này. Thank you
Cám ơn bạn, mình bận quá ko giúp được. Xin gỡ tên mình ra khỏi mục đó nhé ^^
I will take the 'Using the State Hook' Just got inspired by a talk in jsconf.asia ^^
I will take "Hooks FAQ"
Hi all, may I take the Shallow Renderer
and Test Renderer
pages?
p/s: DOM Elements and SyntheticEvents are done and merged already :D Thanks, @cuongtran8
Hi all, may I take the
Shallow Renderer
andTest Renderer
pages?
Sure, you can take any page you want. Thanks.
Hi all, may i take the page JS Environment Requirements
page ?
Hi team, may I take Context
and Error Boundaries
pages?
Hi all, is this repo still active? I would like to help translate ReactJS. If this repo still active then may I take Building Your Own Hooks
page and others in the future?
Hi all, is this repo still active? I would like to help translate ReactJS. If this repo still active then may I take
Building Your Own Hooks
page and others in the future?
Yes, of course. Thanks a lot.
Hi team, may I take
Context
andError Boundaries
pages?
@hweeTan , Yes, please :D
Hi all, is this repo still active? I would like to help translate ReactJS. If this repo still active then may I take
Building Your Own Hooks
page and others in the future?
Yes, sure. We still have a lot of parts need to be translated. Feel free to pick any page without a blue check for translation. Thank you so much.
Hi all, Can I take tutorial page?
I will translate Fragment
Hi everyone, now I want to contribute translations to the community. Where can I contact other authors or contributors. Slack for example? Are you using slack?
Hi everyone, now I want to contribute translations to the community. Where can I contact other authors or contributors. Slack for example? Are you using slack?
Hi @dunggnguyen , we do have slack but we haven't communicated much there. You can pick the page to translate by making a comment here or editing the description of this issue above.
Hi everyone, can I translate the Getting Started
page?
Hi everyone, can I translate the
Getting Started
page?
Thanks @quyctd , Sure, feel free to do it. Happy Lunar New Year!
Wow, ⌛ hope to see it complete in future 😄
Hi, I saw that File Structure Page is not translated (faq-structure.html). Can I translate that page?
Hi, I saw that File Structure Page is not translated (faq-structure.html). Can I translate that page?
Hi @tedle1997, Surely! We are edger for your help here!
Hi guys, can I translate Create a New React App
in Installation? It seems like nobody has translated it so far.
Hi guys, can I translate
Create a New React App
in Installation? It seems like nobody has translated it so far.
Sure! Please go ahead
Hi everyone, topic Component State (docs/faq-state) still hasn't been translated. May I contribute translation for this?
@Ryan-LT Could someone edit the original issue description to reflect the taken status when new volunteer takes a page? It is quite hard for new guy to keep track of which page is being translated in the comment section.
Thanks!
Hi everyone, topic Component State (docs/faq-state) still hasn't been translated. May I contribute translation for this?
Yes, thanks. Go for it :)
I'm translating docs/addons-two-way-binding-helpers.md, docs/addons.md and docs/cdn-links.md because when I see it, nobody has translated it yet.
Hi, I noticed that the testing overview section of the testing section has not been translated yet. Can I go for it?
Yes thanks. Please do so.
@Ryan-LT I'm done at #162 and #168, please come to review and give me feedback.
This is my first pull request for open source contributions. I am so happy to get more suggestions.
Thank you!Sure! It would take some time, The number of PR is increasing, but I will try to merge yours within today.
Thank you so much!
I will translate Create a New React App.
I will translate Create a New React App.
This page is being translated by another member, could you please pick another one?
I will translate Create a New React App.
This page is being translated by another member, could you please pick another one?
Can I translate "Add React to a Website"?
Sure! Please go ahead, I marked your name there
I'm going to translate cross-origin-errors.md
page.
Hi guys, can I translate
Create a New React App
in Installation? It seems like nobody has translated it so far.Sure! Please go ahead
Hi, I see that this section was translated by someone else. Do I need to translate it anymore? If so, may I do Render Props
in Advanced Guide instead?
Sure! That could be awesome! I will mark your name to Render Props
section
Hi, can i translate "JSX In Depth" part?
Hi, I'll be doing the navigation bar today. For those that the titles have been translated to Vietnamese I will make them identical to the translator's wordings. For those that have not been translated I will do them with my own wording then you guys can change them later.
Hi, can i translate "JSX In Depth" part?
Sure! Please, that'd be great!
I marked your name to the topic
Hi, I'm going translate testing-environments.md because nobody has translated it yet, help me a confirm please.
Hi, I'm going translate testing-environments.md because nobody has translated it yet, help me a confirm please.
Yes, there is none translation for it yet. I will mark your name to the topic
Hi @Ryan-LT,
Can I translate the "Typechecking With PropTypes / Optimizing Performance" part?
Can you mark my name on those the topic? I will translate those pages. Thanks!
@hoangvanhoa1701 Sure! Why not? 👏
I will translate FAQ Versioning Policy page! 🍕🍕
I can help translating the page "Static Type Checking", if nobody is working on it then please mark it with my name. Thanks!