Translate react-dom #45

gotchane · 2019-02-02T08:39:30Z

This PR is a part of #4.

Translation: https://reactjs.org/docs/react-dom.html

Please review 🙏

sasurau4

ありがとうございます 👍
ほとんど、スタイルに関する指摘です。修正よろしくお願いします。

content/docs/reference-react-dom.md

gotchane · 2019-02-03T00:11:11Z

@sasurau4 @smikitky

ご確認ありがとうございます！
レビューいただいた点修正しました！

sasurau4 · 2019-02-03T09:26:23Z

LGTM 🚀
お疲れ様です！ 👍
@smikitky さんのレビューも入ると思うのでお待ちを 🙏

gotchane · 2019-02-05T05:15:03Z

見返して気づいた修正点を少し修正しました。
引き続きレビューお待ちしております 🙇

koba04

@gotchane レビューしましたので確認お願いします 🙇
hydrateについては、「クライアントと合わせる」という訳から「クライアントで再利用する」に変えましたが、これについては他の方の意見も聞きたいです。

content/docs/reference-react-dom.md

Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

gotchane · 2019-02-06T00:39:02Z

@koba04
Suggestion ありがとうございます！反映しました。
「クライアントで再利用する」という表現、僕は良いと思いました！

smikitky

確認をお願いします。

hydrate は直訳すると「水分を与える」(水素 hydrogen と同じ語源)ですが、要するに「入れ物（コンテナdiv）に中身を注ぐ」、もっと端的に言うとSSRにおいては単にコンテナに（HTMLに変換される）コンテンツを書き込むことだと思います。hydrate 自体に「再利用する」という意味はありません。しかも SSR 特有の単語かと思いきや、クライアント側のコードの render に対してまで hydrate を使っている文が2か所あり（これは原文が不親切）、その場合は「（初回）レンダー」と換言しても問題ないと思います。

content/docs/reference-react-dom.md

smikitky · 2019-02-06T01:36:48Z

content/docs/reference-react-dom.md

 >
-> Using `ReactDOM.render()` to hydrate a server-rendered container is deprecated and will be removed in React 17. Use [`hydrate()`](#hydrate) instead.
+> サーバで描画されたコンテナをクライアントで再利用するために `ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。


Suggested change

> サーバで描画されたコンテナをクライアントで再利用するために `ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。

> サーバで描画されたコンテナにコンテンツを書き込むために `ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。

原文に近づけたつもりですが、これはどちらでもいいです

挙動をイメージしやすいように実際の挙動からこの訳を出しましたが、指摘の通り原文の単語にこの意味はないので、どちらを取るかですね。

こちらは挙動のイメージのしやすさを踏まえ、「再利用する」のままにしますね。

smikitky · 2019-02-06T01:38:58Z

content/docs/reference-react-dom.md

@@ -62,15 +62,15 @@ If the optional callback is provided, it will be executed after the component is
 ReactDOM.hydrate(element, container[, callback])
 ```

-Same as [`render()`](#render), but is used to hydrate a container whose HTML contents were rendered by [`ReactDOMServer`](/docs/react-dom-server.html). React will attempt to attach event listeners to the existing markup.
+[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html) により HTML コンテンツが描画されたコンテナをクライアントで再利用するために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。


Suggested change

[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html) により HTML コンテンツが描画されたコンテナをクライアントで再利用するために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。

[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html) によって HTML コンテンツが描画されるコンテナに書き込むために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。

「書き込む」だと、ReactDOM.hydrate()のタイミングで何かDOM更新するように受け取られるのではと感じたのですが如何でしょう？
原文かつ挙動にあった言葉が思い浮かばないですが...。

すみません SSR は殆ど素人なので実際の挙動に合っているようでしたら元の文で大丈夫です

「注入する」「賦活する」あたりの言葉も浮かびましたがどうせ意味不明になりそう…

こちらも同様、「再利用する」のままにします！

content/docs/reference-react-dom.md

koba04 · 2019-02-06T02:47:48Z

hydrateについては、SSRで構築されたDOMに「動きを与える」（React Elementを構築してイベントリストを設定するなど）と理解しています。
確かにこの文章だと、その行為そのもの（再利用と表現した部分）と、hydrateを含んだrenderを指しているものがありますね。

smikitky · 2019-02-06T03:24:55Z

なるほど、hydrate とは render の一部なんですね…とりあえずクライアントの render を指している部分についての修正ができていれば、SSR側については分かりやすく訳せていれば大丈夫だと思います。

Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

gotchane · 2019-02-06T10:35:04Z

@smikitky @koba04
レビュー・コメントありがとうございました！
単語の意味の確認通して、React の挙動についてとても勉強になりました。

議論を踏まえ、SSR の部分のみ「再利用する」のままにし、残りのご指摘を反映しました。
再度ご確認いただけるとありがたいです 🙏

koba04 · 2019-02-06T15:34:49Z

@gotchane mergeしました 🚀 ありがとうございます 👏👏👏

gotchane · 2019-02-07T00:11:30Z

ありがとうございました 🚀 🚀 🚀

translate reference-react-dom

b8f5861

smikitky self-requested a review February 2, 2019 09:04

sasurau4 suggested changes Feb 2, 2019

View reviewed changes

tesseralis mentioned this pull request Feb 2, 2019

Japanese Translation Progress #4

Closed

90 tasks

gotchane added 3 commits February 3, 2019 08:16

trim half-width space after punctuation

facce61

fix translation of note

c52edf0

fix translations pointed out

67b9614

sasurau4 approved these changes Feb 3, 2019

View reviewed changes

koba04 requested review from koba04 and removed request for koba04 February 4, 2019 01:15

fix a bit

e69d6c2

koba04 requested changes Feb 5, 2019

View reviewed changes

Apply suggestions from code review

53eecd2

Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

smikitky requested changes Feb 6, 2019

View reviewed changes

Apply suggestions from code review

313e88d

Co-Authored-By: gotchane <20318418+gotchane@users.noreply.github.com>

smikitky approved these changes Feb 6, 2019

View reviewed changes

koba04 approved these changes Feb 6, 2019

View reviewed changes

koba04 merged commit 0caf551 into reactjs:master Feb 6, 2019

gotchane deleted the translate/reference-react-dom branch February 7, 2019 00:10

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Translate react-dom #45

Translate react-dom #45

gotchane commented Feb 2, 2019 •

edited

sasurau4 left a comment

gotchane commented Feb 3, 2019

sasurau4 commented Feb 3, 2019

gotchane commented Feb 5, 2019

koba04 left a comment

gotchane commented Feb 6, 2019

smikitky left a comment •

edited

smikitky Feb 6, 2019 •

edited

koba04 Feb 6, 2019

gotchane Feb 6, 2019

smikitky Feb 6, 2019

koba04 Feb 6, 2019

smikitky Feb 6, 2019

smikitky Feb 6, 2019

gotchane Feb 6, 2019

koba04 commented Feb 6, 2019

smikitky commented Feb 6, 2019

gotchane commented Feb 6, 2019

koba04 commented Feb 6, 2019

gotchane commented Feb 7, 2019

	> サーバで描画されたコンテナをクライアントで再利用するために `ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。
	> サーバで描画されたコンテナにコンテンツを書き込むために `ReactDOM.render()` を使用することは非推奨となり、React 17 では削除されます。代わりに [`hydrate()`](#hydrate) を使用してください。

	[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html) により HTML コンテンツが描画されたコンテナをクライアントで再利用するために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。
	[`render()`](#render) と同様ですが、[`ReactDOMServer`](/docs/react-dom-server.html) によって HTML コンテンツが描画されるコンテナに書き込むために使用されます。React は既存のマークアップにイベントリスナをアタッチしようとします。

Translate react-dom #45

Translate react-dom #45

Conversation

gotchane commented Feb 2, 2019 • edited

sasurau4 left a comment

Choose a reason for hiding this comment

gotchane commented Feb 3, 2019

sasurau4 commented Feb 3, 2019

gotchane commented Feb 5, 2019

koba04 left a comment

Choose a reason for hiding this comment

gotchane commented Feb 6, 2019

smikitky left a comment • edited

Choose a reason for hiding this comment

smikitky Feb 6, 2019 • edited

Choose a reason for hiding this comment

koba04 Feb 6, 2019

Choose a reason for hiding this comment

gotchane Feb 6, 2019

Choose a reason for hiding this comment

smikitky Feb 6, 2019

Choose a reason for hiding this comment

koba04 Feb 6, 2019

Choose a reason for hiding this comment

smikitky Feb 6, 2019

Choose a reason for hiding this comment

smikitky Feb 6, 2019

Choose a reason for hiding this comment

gotchane Feb 6, 2019

Choose a reason for hiding this comment

koba04 commented Feb 6, 2019

smikitky commented Feb 6, 2019

gotchane commented Feb 6, 2019

koba04 commented Feb 6, 2019

gotchane commented Feb 7, 2019

gotchane commented Feb 2, 2019 •

edited

smikitky left a comment •

edited

smikitky Feb 6, 2019 •

edited