New Traditional Chinese Translation Progress

[neighborhood999]

Maintainers

• @chloewlin
• @chentsulin
• @neighborhood999
• @bugtender

For New Translators

To translate a page:

1. Check that no one else has claimed your page in the checklist and comments below.
2. Comment below with the name of the page you would like to translate. Please take only one page at a time.
3. Clone this repo, translate your page, and submit a pull request!

Before contributing, read the glossary and style guide (once they exist) to understand how to translate various technical and React-specific terms.

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:

• Quick Start (@tesseralis) #12345

When PRs are merged, make sure to mark that page as completed!

Main Content

To do before releasing as an "official" translation. Please translate these pages first.

Note that each section has an index page, which needs to be translated too.

Learn React

• Quick Start (@neighborhood999) feat: translation quick-start #399

  • Tutorial: Tic Tac Toe (@neighborhood999)
  • Thinking in React (@neighborhood999)

• Installation (@neighborhood999) feat: translation installation #385

  • Start a New React Project (@neighborhood999) feat(docs): translate start a new react project #379
  • Add React to an Existing Project (@neighborhood999) feat: translate add react to an existing project #384
  • Editor Setup (@neighborhood999) feat: translate editor setup #269
  • React Developer Tools (@neighborhood999) feat: translate react dev tools  #287

• Describing the UI (@yuaanlin) feat: translate describing the ui #312

  • Your First Component (@JamieLoLo) update translation "your first component" & " importing and exporting components" #398
  • Importing and Exporting Components (@JamieLoLo) update translation "your first component" & " importing and exporting components" #398
  • Writing Markup with JSX (@owonie)
  • JavaScript in JSX with Curly Braces (@kai2128) docs: translation JavaScript in JSX #364
  • Passing Props to a Component (@kai2128) docs: translation Passing Props to a Component #365
  • Conditional Rendering (@brian3814) docs: Translate Conditional Rendering #383
  • Rendering Lists (@rccj)
  • Keeping Components Pure (@viboloveyou12) docs: translate keeping-components-pure #414

• Adding Interactivity

  • Responding to Events (@yishuolin) docs: translate responding-to-events #407
  • State: A Component's Memory (@alpheustangs) docs: translation State: A Component's Memory #406
  • Render and Commit (@Jim876633) docs: translation Render and Commit #387
  • State as a Snapshot (@Annie-Chien) doc: translate State as a Snapshot #388
  • Queueing a Series of State Updates (@Jim876633) docs: translate Queueing a Series of State Updates #417
  • Updating Objects in State (@ginger-lemon)
  • Updating Arrays in State (@ginger-lemon)

• Managing State

  • Reacting to Input with State (@max80713)
  • Choosing the State Structure (@max80713)
  • Sharing State Between Components (@max80713)
  • Preserving and Resetting State (@nathanlao)
  • Extracting State Logic into a Reducer
  • Passing Data Deeply with Context (@ShenHdian)
  • Scaling Up with Reducer and Context

• Escape Hatches (@rayatn1011) feat(docs): translate escape hatches #381

  • Referencing Values with Refs (@rayatn1011)
  • Manipulating the DOM with Refs (@Kate-Chu)
  • Synchronizing with Effects (@Kate-Chu)
  • You Might Not Need an Effect (@dracarys55)
  • Lifecycle of Reactive Effects
  • Separating Events from Effects (@dracarys55)
  • Removing Effect Dependencies
  • Reusing Logic with Custom Hooks (@ginger-lemon)

API Reference

• react: Hooks

  • useCallback (@trevlee0212)
  • useContext
  • useDebugValue
  • useDeferredValue
  • useEffect (@ukea)
  • useId
  • useImperativeHandle
  • useInsertionEffect
  • useLayoutEffect
  • useMemo
  • useReducer
  • useRef
  • useState
  • useSyncExternalStore
  • useTransition

• react: Components

  • <Fragment> (<>)
  • <Profiler>
  • <StrictMode>
  • <Suspense>

• react: APIs

  • createContext
  • forwardRef
  • lazy
  • memo
  • startTransition

• react-dom: Components

  • Common (e.g. <div>)
  • <input>
  • <option>
  • <progress>
  • <select>
  • <textarea>

• react-dom: APIs

  • createPortal
  • flushSync
  • findDOMNode
  • hydrate
  • render
  • unmountComponentAtNode

• react-dom/client: Client APIs

  • createRoot
  • hydrateRoot

• react-dom/server: Server APIs

  • renderToNodeStream
  • renderToPipeableStream
  • renderToReadableStream
  • renderToStaticMarkup
  • renderToStaticNodeStream
  • renderToString

Navigation and UI

We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.

• Homepage (currently in HomeContent.js)
• Sidebars (currently in src/sidebar*.json)
• Top-level navigation (currently in TopNav.tsx)

When You're Ready...

After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.

Secondary Content

These API pages should ideally be translated too, but they're less urgent and can be done after the others:

• Legacy React APIs
  • Children
  • cloneElement
  • Component
  • createElement (@c0dedance)
  • createFactory
  • createRef
  • isValidElement
  • PureComponent

Optional Content

These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:

• Community
• Blog
• Warnings

[yuu2lee4]

the translated docs not published?

[bugtender]

For people who don't know where to find the translated BETA doc.
Here's the link https://beta.zh-hant.reactjs.org. 😀

[K4Lok]

Hi @neighborhood999 , I want to make contributions to the translation of the Beta Docs. However, the code base seems to be not syncing correctly with https://github.com/reactjs/reactjs.org for a while. https://beta.zh-hant.reactjs.org/ is outdated!

Is there anything I can help with?

[neighborhood999]

Hi @neighborhood999 , I want to make contributions to the translation of the Beta Docs. However, the code base seems to be not syncing correctly with reactjs/reactjs.org for a while. beta.zh-hant.reactjs.org is outdated!

Is there anything I can help with?

Hi @K4Lok , thanks for your question.
Yes, the current docs are out of date from the latest docs, in the PR list has many sync PRs and I will resolve conflicts and then you can make docs contribution.

[Kate-Chu]

Hi @neighborhood999 I want to make contributions to translate "Referencing Values with Refs", "Manipulating the DOM with Refs", and "Synchronizing with Effects" (which is not shown on the list yet? Can I translate it also?) Thank you! :D

[neighborhood999]

Hi @neighborhood999 I want to make contributions to translate "Referencing Values with Refs", "Manipulating the DOM with Refs", and "Synchronizing with Effects" (which is not shown on the list yet? Can I translate it also?) Thank you! :D

Hi @Kate-Chu, thank you for helping, I added your name to the corresponding documents.

[JamieLoLo]

Hi @neighborhood999 I want to make contributions to translate "Your First Component", "Importing and Exporting Components" and "Writing Markup with JSX" . Thank you :)

[neighborhood999]

Hi @neighborhood999 I want to make contributions to translate "Your First Component", "Importing and Exporting Components" and "Writing Markup with JSX" . Thank you :)

Hi @JamieLoLo thank you for helping translation, I added you to the above list. For the term, if you are not sure how to translate you can check Glossary.

[max80713]

Hi @neighborhood999 I want to make contributions to translate "Reacting to Input with State", "Choosing the State Structure", and "Sharing State Between Components". Thank you 😋

[neighborhood999]

Hi @neighborhood999 I want to make contributions to translate "Reacting to Input with State", "Choosing the State Structure", and "Sharing State Between Components". Thank you 😋

Hi @max80713 thank you for helping, updated the above list.

[kai2128]

Hi @neighborhood999 I would like to contribute on:

• JavaScript in JSX with Curly Braces docs: translation JavaScript in JSX #364
• Passing Props to a Component docs: translation Passing Props to a Component #365

[neighborhood999]

Hi @neighborhood999 I would like to contribute on:

* JavaScript in JSX with Curly Braces [docs: translation JavaScript in JSX #364](https://github.com/reactjs/zh-hant.reactjs.org/pull/364)

* Passing Props to a Component [docs: translation Passing Props to a Component #365](https://github.com/reactjs/zh-hant.reactjs.org/pull/365)

Thanks for your contribution, I updated the above list and I will review them.

[JamieLoLo]

HI @neighborhood999

I have submitted the following three documents as a pull request to the repository. As this is my first time participating in a translation project, I would like to ask if the submission process has been completed correctly. Thank you.

docs: translation Your First Component #368
docs: translation Importing and Exporting Components #369
docs: translation Writing Markup with JSX #370

[neighborhood999]

HI @neighborhood999

I have submitted the following three documents as a pull request to the repository. As this is my first time participating in a translation project, I would like to ask if the submission process has been completed correctly. Thank you.

docs: translation Your First Component #368 docs: translation Importing and Exporting Components #369 docs: translation Writing Markup with JSX #370

@JamieLoLo Yes, no worries :). I will review these PRs and thanks for your contribution.

[gaearon]

Hi folks,

Just a heads-up that we've done our best to bring main and legacy branches up-to-date with upstream. This brings you to the latest visual design and sets up all the redirects. We don't anticipate more changes necessary on legacy. For main, there's a few things you need to be aware of:

• Keep in mind translating UI is best done closer to the end. We plan to make non-trivial code changes to the repo over the next few months. So it's best to focus on the content rather than on UI components.
• The homepage is untranslated so ideally it would be good if you could do a pass at that. For now, unfortunately it requires messing with the code file.
• A few rewritten pages (from Installation) are currently untranslated.
• This was a massive PR to merge, so we might have regressed somewhere or missed some changes that needed to be translated. Ideally, it would be great if you could go over the already-translated pages at your own pace and verify nothing important got lost.

Thank you so much for your cooperation!

[gaearon]

I've updated the checklist.

[gaearon]

@chloewlin @chentsulin @neighborhood999 @bugtender @haimengzhang

Hi folks, can you please confirm which of you will be able to steer and maintain this translation? We'd like to get the maintainer list in https://github.com/reactjs/translations.react.dev/blob/main/langs/zh-hant.json accurate and up-to-date. Thank you!

[neighborhood999]

@chloewlin @chentsulin @neighborhood999 @bugtender @haimengzhang

Hi folks, can you please confirm which of you will be able to steer and maintain this translation? We'd like to get the maintainer list in reactjs/translations.react.dev@main/langs/zh-hant.json accurate and up-to-date. Thank you!

Hi @gaearon, thank you for helping. The current maintainer has:

• @chloewlin
• @chentsulin
• @neighborhood999
• @bugtender

[Jim876633]

Hi @neighborhood999 I want to make contributions to translate "Render and Commit" Thank you !

[neighborhood999]

Hi @neighborhood999 I want to make contributions to translate "Render and Commit" Thank you !

Hi @Jim876633 , thank you for helping. I updated the list.

[Annie-Chien]

Hi @neighborhood999, I'd like to make contributions to translate "State as a Snapshot". Thank you!

[neighborhood999]

Thanks @rayatn1011 and @Annie-Chien for contribution.

[rayatn1011]

Hi @neighborhood999, I would like to contribute by translating "Referencing Values with Refs". Thank you!

BTW, I think "Describing the UI" has been translated.

[rccj]

Hi @neighborhood999, I would like to contribute by translating "Quick Start". Thank you!

[neighborhood999]

Hi @neighborhood999, I would like to contribute by translating "Quick Start". Thank you!

Hi @rccj Sorry, I forgot to update the list, I already started translation "Quick Start", can you choose another one? Thanks

[rccj]

Hi @neighborhood999, I would like to contribute by translating "Rendering Lists " and "Keeping Components Pure". Thank you!

[neighborhood999]

Hi @neighborhood999, I would like to contribute by translating "Rendering Lists " and "Keeping Components Pure". Thank you!

@rccj updated it!

[alpheustangs]

Hi @neighborhood999, I would like to contribute by translating "State: A Component's Memory". Thank you!

[neighborhood999]

Hi @neighborhood999, I would like to contribute by translating "State: A Component's Memory". Thank you!

Hi @alpheustangs , thanks contribution.

[Krystino]

Hi @neighborhood999, I would like to contribute by translating "API Reference/React: Hooks/useEffect" when I'm free. Thank you!

[yishuolin]

Hi @neighborhood999, I'd like to translate "Responding to Events". Thank you!

[neighborhood999]

@AwesomeFrontEnd @yishuolin Thank you for helping, I added you guys on the above.

[dracarys55]

Hi @neighborhood999 I would like to translate " You Might Not Need an Effect" from Escape Hatches section. Thanks you !

[dracarys55]

Hi @neighborhood999 I would like to translate "Separating Events from Effects" from Escape Hatches section too. Thanks you !

[neighborhood999]

Hi @dracarys55, I updated the above list, thank you for your contribution.

[ginger-lemon]

Hi @neighborhood999 , I would like to translate:
Adding Interactivity - Updating Arrays in State
Adding Interactivity - Updating Objects in State
Escape Hatches - Reusing Logic with Custom Hooks

Thank you!

[Jim876633]

Hi @neighborhood999 , I would like to translate "Queueing a Series of State Updates" from "Adding Interactivity " Thank you !

[neighborhood999]

Hi @ginger-lemon @Jim876633, thank you for helping, I updated the above list.
You can check Glossary for any terms you are unsure how to translate.

[c0dedance]

Hi @neighborhood999 , I would like to contribute by translating "legacy/createElementI". Thank you!

[neighborhood999]

Hi @neighborhood999 , I would like to contribute by translating "legacy/createElementI". Thank you!

Hi @c0dedance, I added, thank you.

[owonie]

Hi @neighborhood999 , I would like to contribute by translating "Writing Markup with JSX" from "Describing the UI" . Thank you!

[neighborhood999]

Hi @neighborhood999 , I would like to contribute by translating "Writing Markup with JSX" from "Describing the UI" . Thank you!

Hi @owonie, Thanks for your contribution, I added you to the above list.

[trevlee0212]

Hi @neighborhood999 , I would like to contribute by translating useCallback in react: Hooks

[neighborhood999]

Hi @neighborhood999 , I would like to contribute by translating useCallback in react: Hooks

Hi @trevlee0212, thank you for your contribution.

[ShenHdian]

Hi @neighborhood999 , I would like to contribute by translating 'src/content/learn/passing-data-deeply-with-contet'. I have already read the guideline about how to contribute.

[nathanlao]

Hi @neighborhood999 , I'd like to contribute by translating the Preserving and Resetting State section in Managing State. I'm fluent in traditional chinese, and have read the contribution guide. Thank you!

[neighborhood999]

Hi @ShenHdian and @nathanlao, Thank you guys for the translation. I updated the above translation list and assigned a chapter with your names.

[JamieLoLo]

Hi @neighborhood999, I'm Jamie.
Due to an issue with branch setup in my previous PR, I have resubmitted two PRs as follows:

translation: Your First Component #483
translation: Importing And Exporting Components #484
The content of these PRs has been revised according to the previous review. I also noticed that the official documentation has been updated, and I have made the necessary adjustments accordingly.
I would really appreciate it if you could review them. Thank you so much, and have a great day!