New Translation Progress Checklist

[no-yan]

ページを翻訳したい方へ：

重複作業を防ぐため、まずはここでどのページを翻訳するか宣言してください。宣言なしで翻訳が行われて他の人の作業と被ってしまった場合、原則として（PRを先に作った人ではなく）ここで最初に宣言があった人を優先します。ただし宣言が行われて 1 週間以上 PR が作成されないなどの場合は適宜対応します。

スタイルガイドおよび単語リストをチェックして、翻訳が一貫した方法で書かれていることを確認してください。

New Articles

Progress : (🏃 進行中の作業; 👀 レビュー中）

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 (@smikitky Translate "Quick Start" (index) #559)

  • Tutorial: Tic Tac Toe (@smikitky Translate "Tutorial: Tic-tac-toe" #562)
  • Thinking in React (@smikitky Translate "Thinking in React" #560)

• Installation (@smikitky, Translate articles under 'install' section #555)

  • Start a New React Project (@smikitky, Translate articles under 'install' section #555)
  • Add React to an Existing Project (@smikitky, Translate articles under 'install' section #555)
  • Editor Setup (@smikitky, Translate articles under 'install' section #555)
  • Using TypeScript (@smikitky, Translate "Using TypeScript" #659)
  • React Developer Tools (@smikitky, Translate articles under 'install' section #555)

• Describing the UI (@smikitky Translate "Describing the UI" chapter #556)

  • Your First Component (@smikitky, Translate two pages and some MDX tags #451)
  • Importing and Exporting Components (@smikitky, Translate two pages and some MDX tags #451)
  • Writing Markup with JSX (@smikitky Translate two articles (JSX and curly braces) #459)
  • JavaScript in JSX with Curly Braces (@smikitky Translate two articles (JSX and curly braces) #459)
  • Passing Props to a Component (@smikitky Translate "Passing props to a component" #461)
  • Conditional Rendering (@smikitky Translate "Describing the UI" chapter #556)
  • Rendering Lists (@smikitky Translate "Describing the UI" chapter #556)
  • Keeping Components Pure (@smikitky Translate "Describing the UI" chapter #556)
  • Understanding Your UI as a Tree (@smikitky, Sync with react.dev @ a0cacd7d #706)

• Adding Interactivity (@pasteisdenata, adding-interactivity 翻訳済み #491)

  • Responding to Events (@smikitky, Translate first 3 articles under "Adding Interactivity" #567)
  • State: A Component's Memory (@smikitky, Translate first 3 articles under "Adding Interactivity" #567)
  • Render and Commit (@smikitky, Translate first 3 articles under "Adding Interactivity" #567)
  • State as a Snapshot (@smikitky, Translate two articles under "Adding Interactivity" #569)
  • Queueing a Series of State Updates (@smikitky, Translate two articles under "Adding Interactivity" #569)
  • Updating Objects in State (@smikitky, Translate last 2 articles under "Adding interactivity" #574)
  • Updating Arrays in State (@smikitky, Translate last 2 articles under "Adding interactivity" #574)

• Managing State (@smikitky, Translate "Managing State" and unify styles of chapter top pages #610)

  • Reacting to Input with State (@youliangdao, Reacting to input with state翻訳 #571)
  • Choosing the State Structure (@smikitky, Translate "Choosing the State Structure" #588)
  • Sharing State Between Components (@smikitky, Translate "Sharing State Between Components" #582)
  • Preserving and Resetting State (@smikitky, Translate "Preserving and Resetting State" #583)
  • Extracting State Logic into a Reducer (@smikitky, Translate "Extracting State Logic into a Reducer" #584)
  • Passing Data Deeply with Context (@smikitky, Translate "Passing Data Deeply with Context" #586)
  • Scaling Up with Reducer and Context (@smikitky, Translate "Scaling Up with Reducer and Context" #587)

• Escape Hatches (@smikitky, Translate "Escape Hatches" #620)

  • Referencing Values with Refs (@smikitky, Translate "Referencing Values with Refs" #590)
  • Manipulating the DOM with Refs (@smikitky, Translate "Manipulating the DOM with Refs" #589)
  • Synchronizing with Effects (@smikitky, Translate "Synchronizing with Effects" #594)
  • You Might Not Need an Effect (@smikitky, Translate "You might not need an effect" #604)
  • Lifecycle of Reactive Effects (@yuta-ike, Translate "Lifecycle of Reactive Effects" #601)
  • Separating Events from Effects (@kotaesaki, Translate "Separating Events from Effects" #609)
  • Removing Effect Dependencies (@smikitky, Translate "Removing Effect Dependencies" #611)
  • Reusing Logic with Custom Hooks (@smikitky, Translate "Reusing Logic with Custom Hooks" #605)

API Reference

• react: Hooks (@Hayao0819, Translate "Hooks" index page #618)

  • use (@smikitky, Translate "use" Hook reference #687)
  • useCallback (@seckie, Translate "useCallback" hook reference #591)
  • useContext (@jp-knj, Translate useContext reference #621)
  • useDebugValue (@seckie, Translate useDebugValue hook reference #573)
  • useDeferredValue (@smikitky, Translate "useDeferredValue" reference #622)
  • useEffect (@smikitky, Translate useEffect hook reference #568)
  • useId (@sbasken, Translate useId reference #608)
  • useImperativeHandle (@sbasken, Translate useImperativeHandle reference #614)
  • useInsertionEffect (@smikitky, Translate "useInsertionEffect" #625)
  • useLayoutEffect (@smikitky, Translate "useLayoutEffect" #624)
  • useMemo (@yuta-ike, Translate "useMemo" #643)
  • useOptimistic (@smikitky, Translate "useOptimistic" #717)
  • useReducer (@locol23, Translate "useReducer" #641)
  • useRef (@yuta-ike, Translate "useRef" reference #613)
  • useState (@yuta-ike, Translate "useState" #595)
  • useSyncExternalStore (@jp-knj, Translate useExternalStore reference #619)
  • useTransition (@smikitky, Translate "useTransition" & "startTransition" #623)

• react: Components (@smikitky, Translate React built-in components index #686)

  • <Fragment> (<>) (@jp-knj, Translate "<Fragment>" #626)
  • <Profiler> (@smikitky, Translate "<Profiler>" #629)
  • <StrictMode> (@smikitky, Translate "<StrictMode>" #630)
  • <Suspense> (@smikitky, Translate "<Suspense>" #628)

• react: APIs (@natsuokawai, Translate built-in React APIs #636)

  • cache (@locol23, Translate "cache" #696)
  • createContext (@natsuokawai, Translate createContext #638)
  • forwardRef (@smikitky, Translate "forwardRef" #631)
  • lazy (@smikitky, Translate "lazy" #633)
  • memo (@smikitky, Translate "memo" and unify expressions in Deep Dive #702)
  • startTransition (@smikitky, Translate "useTransition" & "startTransition" #623)

• react: Directives (@smikitky, Translate 3 articles on RSC directives #635)

  • 'use client' (@smikitky, Translate 3 articles on RSC directives #635)
  • 'use server' (@smikitky, Translate 3 articles on RSC directives #635)

• react-dom: Components (@smikitky, Translate "React DOM Components" index #682)

  • Common (e.g. <div>) (@smikitky, Translate "Common Components (e.g., <div>)" #637)
  • <input> (@sbasken, Translate "<input>" #646)
  • <form> (@smikitky, Translate "<form>" reference #715)
  • <option> (@smikitky, Translate "<option>" #678)
  • <progress> (@natsuokawai, Translate "<progress>" component #640)
  • <select> (@ainoshment, Translate "<select>" component #644)
  • <textarea> (@smikitky, Translate "<textarea>" reference #649)

• react-dom: Hooks (@smikitky, Translate "Built-in React DOM Hooks" #723)

  • useFormState (@smikitky, Translate "useFormState" #722)
  • useFormStatus (@smikitky, Translate "useFormStatus" #721)

• react-dom: APIs (@smikitky, Transalte "React DOM APIs" index #681)

  • createPortal (@smikitky, Translate "createPortal" #647)
  • flushSync (@smikitky, Translate "flushSync" reference #650)
  • findDOMNode (@jp-knj, Translate "findDOMNode" #670)
  • hydrate (@riku929hr, Translate "hydrate" #653)
  • render (@smikitky, Translate "render" #663)
  • unmountComponentAtNode (@smikitky, Translate "unmountComponentAtNode" #660)

• react-dom/client: Client APIs (@smikitky, Translate react-dom client API index #662)

  • createRoot (@smikitky, Translate createRoot #661)
  • hydrateRoot (@smikitky, Translate "hydrateRoot" #669)

• react-dom/server: Server APIs (@smikitky, Translate react-dom server API index #656)

  • renderToNodeStream (@smikitky, Translate four reactdom/server render methods #655)
  • renderToPipeableStream (@smikitky, Translate "renderTo{Readable|Pipable}Stream" #654)
  • renderToReadableStream (@smikitky, Translate "renderTo{Readable|Pipable}Stream" #654)
  • renderToStaticMarkup (@smikitky, Translate four reactdom/server render methods #655)
  • renderToStaticNodeStream (@smikitky, Translate four reactdom/server render methods #655)
  • renderToString (@smikitky, Translate four reactdom/server render methods #655)

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) (@smikitky, Translate HomeContent #570)
• Sidebars (currently in src/sidebar*.json) (@smikitky, Finish sidebar translations #658)
• 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 (@smikitky, Translate legacy API index #693)
  • Children (@smikitky, Translate "Children" methods #684)
  • cloneElement (@smikitky, Translate "cloneElement" #685)
  • Component (@smikitky, Translate (legacy, class) "Component" #677)
  • createElement (@smikitky, Translate "createElement" #688)
  • createFactory (@smikitky, Translate "createFactory" #690)
  • createRef (@smikitky, Translate "createRef" #689)
  • isValidElement (@smikitky, Translate "isValidElement" #691)
  • PureComponent (@smikitky, Translate "PureComponent" #692)

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 (@smikitky, Translate "Community" #668)
• Blog
• Warnings

[no-yan]

進捗管理用のissueが閉じられていたので、新規issueを開きました。気軽に閉じてください。

この形式でやる場合の懸念点として、Statusの更新が面倒になる可能性があります。どれが更新かわかるようにupstream側で配慮があればよいですが、そうでない場合は頑張って40近いリストから差分を見つける必要がありそうです。

[smikitky]

既にちょっと手を付けてはいるのですが、まだブランチプレビューがセットアップされておらず、textlint も動いておらず、本家の方でも認識していなかった細々とした問題が見つかったり…という状況ですので、ひとまずワークフローを確立するのが先決という状況です。

これで大丈夫そうというところで以前のように翻訳者を募集することになると思いますので、しばらくお待ちください。

[pasteisdenata]

こんにちは。技術翻訳をしている者です。オープンソースのプロジェクトに関わった経験はないのですが、是非お手伝いしたく、よろしくお願いします。既にフォークは作成済みです。どのセクションの翻訳から開始すればよいですか。

[no-yan]

（メンテナの方々からお返事がないようなので）
ありがとうございます！技術翻訳をされている方ということで心強いです。
"Escape Hatches" 以外のまだ訳されていないセクションを自由に訳していただければと思います。

用語が合っているか既存の訳と照らし合わせたいようなら "Installation" から、そうでなければ "Adding Interactivity", "Managing State", "Quick Start" のいずれかを選んで頂くと良いと思います！

上のチェックリストも更新しておきます。

[no-yan]

場合によっては、React 18用の大規模なドキュメント更新がこちらより優先されるかもしれません。
以下のドラフトがマージされて以降になりますが、そちらもご助力いただければ！
reactjs/react.dev#4499

[smikitky]

@pasteisdenata @no-yan すみません気付いていませんでした…。

React 18 用の大規模マージについては認識はしています。これはむしろ私（メンテナ）の方でやります（影響範囲大きそうすぎるので逆に自分で確認しながら進めたい）。

ベータドキュメントについても、現時点ではワークフローの準備が整っていないため大々的に進めていない状態です。ただ上記に書いてある技術的問題は概ね解決しそうですので、これから改めて進めていきたいと思っています。ひとまず上記でチェックのついていないものならどれからやっていただいても大丈夫ですが、重複作業を防ぐため、このページで着手するという宣言だけしてください。

なお、本家の方でも新ドキュメントの作業が結構遅れておりこんなことを言われている状況です。恐らく React 18 のリリースも終わったので進み始めるだろうとは思っているのですが、いろいろ流動的なところがある点についてはご了承ください。

[pasteisdenata]

@smikitky @no-yan レスポンスが遅れてしまい申し訳ありません。では、Adding Interactivity から開始しますね。取り急ぎ。

[pasteisdenata]

@smikitky Responding to Events の翻訳を始めます。

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

With legacy, there's some inconsistencies with how the red banners are displayed/translated. Sorry about that. We've added them manually where they were missing, but they might need a manual pass to make it nicer.