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

• [x] Quick Start (@neighborhood999) #399

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

• [x] Installation (@neighborhood999) #385

  • [x] Start a New React Project (@neighborhood999) #379
  • [x] Add React to an Existing Project (@neighborhood999) #384
  • [x] Editor Setup (@neighborhood999) #269
  • [x] React Developer Tools (@neighborhood999) #287

• [x] Describing the UI (@yuaanlin) #312

  • [x] Your First Component (@JamieLoLo) #483
  • [x] Importing and Exporting Components (@JamieLoLo) #484
  • [ ] Writing Markup with JSX (@Owonie)
  • [x] JavaScript in JSX with Curly Braces (@kai2128) #364
  • [ ] Passing Props to a Component (@kai2128) #365
  • [x] Conditional Rendering (@brian3814) #383
  • [x] Rendering Lists (@rccj)
  • [x] Keeping Components Pure (@viboloveyou12) #414

• [ ] Adding Interactivity

  • [x] Responding to Events (@yishuolin) #407
  • [ ] State: A Component's Memory (@alpheustangs) #406
  • [x] Render and Commit (@Jim876633) #387
  • [x] State as a Snapshot (@Annie-Chien) #388
  • [ ] Queueing a Series of State Updates (@Jim876633) #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

• [x] Escape Hatches (@rayatn1011) #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 #364
• 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.

[brian3814]

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

[neighborhood999]

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

Thank you for helping. Updated the above list.

[rayatn1011]

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

[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!