Skip to content

New Traditional Chinese Translation Progress #260

Open
Open
New Traditional Chinese Translation Progress#260

Description

@neighborhood999
neighborhood999
opened on Dec 1, 2021

Maintainers

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:

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

API Reference

  • react: Hooks

    • useCallback (@trevlee0212)
    • useContext
    • useDebugValue
    • useDeferredValue
    • useEffect (@ukea)
    • useId
    • useImperativeHandle
    • useInsertionEffect
    • useLayoutEffect
    • useMemo
    • useReducer
    • useRef
    • useState (@clhuang224)
    • 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

Activity

  1. yuu2lee4 commented on Apr 8, 2022

    @yuu2lee4
    yuu2lee4
    on Apr 8, 2022

    the translated docs not published?

  2. bugtender commented on Jun 13, 2022

    @bugtender
    bugtender
    on Jun 13, 2022
    Contributor

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

  3. K4Lok commented on Feb 14, 2023

    @K4Lok
    K4Lok
    on Feb 14, 2023

    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?

  4. neighborhood999 commented on Feb 16, 2023

    @neighborhood999
    neighborhood999
    on Feb 16, 2023
    MemberAuthor

    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.

  5. Kate-Chu commented on Mar 7, 2023

    @Kate-Chu
    Kate-Chu
    on Mar 7, 2023

    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

  6. neighborhood999 commented on Mar 7, 2023

    @neighborhood999
    neighborhood999
    on Mar 7, 2023
    MemberAuthor

    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.

  7. JamieLoLo commented on Mar 8, 2023

    @JamieLoLo
    JamieLoLo
    on Mar 8, 2023
    Contributor

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

  8. neighborhood999 commented on Mar 9, 2023

    @neighborhood999
    neighborhood999
    on Mar 9, 2023
    MemberAuthor

    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.

  9. max80713 commented on Mar 20, 2023

    @max80713
    max80713
    on Mar 20, 2023

    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 😋

  10. neighborhood999 commented on Mar 22, 2023

    @neighborhood999
    neighborhood999
    on Mar 22, 2023
    MemberAuthor

    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.

  11. kai2128 commented on Mar 22, 2023

    @kai2128
    kai2128
    on Mar 22, 2023
    Contributor

    Hi @neighborhood999 I would like to contribute on:

  12. neighborhood999 commented on Mar 29, 2023

    @neighborhood999
    neighborhood999
    on Mar 29, 2023
    MemberAuthor

    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.

  13. JamieLoLo commented on Apr 4, 2023

    @JamieLoLo
    JamieLoLo
    on Apr 4, 2023
    Contributor

    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

  14. neighborhood999 commented on Apr 10, 2023

    @neighborhood999
    neighborhood999
    on Apr 10, 2023
    MemberAuthor

    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.

  15. gaearon commented on Apr 24, 2023

    @gaearon
    gaearon
    on Apr 24, 2023
    Member

    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!

  16. 38 remaining items

  17. nathanlao commented on Oct 19, 2024

    @nathanlao
    nathanlao
    on Oct 19, 2024
    Contributor

    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!

  18. neighborhood999 commented on Oct 19, 2024

    @neighborhood999
    neighborhood999
    on Oct 19, 2024
    MemberAuthor

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

  19. JamieLoLo commented on Oct 30, 2024

    @JamieLoLo
    JamieLoLo
    on Oct 30, 2024
    Contributor

    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!

  20. Oleksandr0305
    added 2 commits that reference this issue on Feb 1, 2025

    Update zh-hant.json to match the current list

    8b63fb1

    Add Bengali language for react docs (#266)

    7448d60

  21. clhuang224 commented on Dec 4, 2025

    @clhuang224
    clhuang224
    on Dec 4, 2025

    Hi @neighborhood999 , I’d like to contribute by translating useState in react: Hooks. Thank you :)

    #540

  22. neighborhood999 commented on Dec 12, 2025

    @neighborhood999
    neighborhood999
    on Dec 12, 2025
    MemberAuthor

    Hi @neighborhood999 , I’d like to contribute by translating useState in react: Hooks. Thank you :)

    #540

    Thank you for your contribution.❤️

  23. clhuang224 commented on Dec 15, 2025

    @clhuang224
    clhuang224
    on Dec 15, 2025

    Hi @neighborhood999 , I'd like to contribute by translating Extracting State Logic into a Reducer this time as well. Thanks!

    #544

  24. clhuang224 commented on Jan 13, 2026

    @clhuang224
    clhuang224
    on Jan 13, 2026

    Hi @neighborhood999, me again 😆
    I'd like to translate Scaling Up with Reducer and Context this time.
    Thank you 😊

    #548

  25. clhuang224 commented on Jan 26, 2026

    @clhuang224
    clhuang224
    on Jan 26, 2026

    Hi @neighborhood999, I'd like to continue translating Lifecycle of Reactive Effects this time, thank you 😌

    #552

  26. clhuang224 commented on Feb 16, 2026

    @clhuang224
    clhuang224
    on Feb 16, 2026

    Hi @neighborhood999, I'd like to continue translating Removing Effect Dependencies, thank you!

    #554

  27. clhuang224 commented on Feb 17, 2026

    @clhuang224
    clhuang224
    on Feb 17, 2026

    Hi @neighborhood999 , I’d like to continue translating useContext in react: Hooks. Thank you :)

    #555

  28. clhuang224 commented on Feb 17, 2026

    @clhuang224
    clhuang224
    on Feb 17, 2026

    Hi @neighborhood999 , I’d like to continue translating useDebugValue in react: Hooks. Thank you!

    #556

  29. clhuang224 commented on Feb 17, 2026

    @clhuang224
    clhuang224
    on Feb 17, 2026

    Hi @neighborhood999, I'd like to translate useDeferredValue in react: Hooks.
    Please let me know if I missed anything.
    Thanks!

  30. JamieLoLo commented on Aug 3, 2026

    @JamieLoLo
    JamieLoLo
    on Aug 3, 2026
    Contributor

    Hi @neighborhood999 I want to make contributions to translate API Reference "useContext", "useDebugValue" and "useDeferredValue" . Thank you :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions