update ja docs #228

kazupon · 2019-02-08T09:32:30Z

kazupon · 2019-02-08T09:34:01Z

@ktsn
Can you review this PR ? 🙏

ktsn · 2019-02-08T09:38:12Z

docs/ja/api/README.md

 :::

-The `template` option can also be function that returns the rendered HTML or a Promise that resolves to the rendered HTML. This allows you to leverage native JavaScript template strings and potential async operations in the template rendering process.
+`template` オプションは、描画された HTML 、もしくは描画された HTML を解決する Promise を返す関数を指定できます。これにより、ネイティブの JavaScript 文字列、そしてテンプレート描画プロセスにおける可能性としてある非同期な操作を利用できます。


ネイティブの JavaScript 文字列

原文ではテンプレート文字列のことを言ってるように見えます。

ktsn · 2019-02-08T09:44:48Z

docs/ja/api/README.md

 :::

-The `template` option can also be function that returns the rendered HTML or a Promise that resolves to the rendered HTML. This allows you to leverage native JavaScript template strings and potential async operations in the template rendering process.
+`template` オプションは、描画された HTML 、もしくは描画された HTML を解決する Promise を返す関数を指定できます。これにより、ネイティブの JavaScript 文字列、そしてテンプレート描画プロセスにおける可能性としてある非同期な操作を利用できます。


そしてテンプレート描画プロセスにおける可能性としてある非同期な操作を利用できます。

potential async operations なので、"可能性" は "非同期な操作" にかかっていますが、この訳文だと少しそれが見えづらいように思います。
"テンプレート描画プロセスにおいてあり得る非同期な操作を利用できます。" みたいな感じでどうでしょうか？

ktsn · 2019-02-08T09:45:37Z

docs/ja/api/README.md


-1. The rendering result of the app component as a string;
-2. The rendering context object.
+1. 文字列としてアプリケーションコンポーネントの描画結果


アプリケーションコンポーネントの描画結果の文字列
とか。

ktsn · 2019-02-08T09:47:05Z

docs/ja/api/README.md

-1. The rendering result of the app component as a string;
-2. The rendering context object.
+1. 文字列としてアプリケーションコンポーネントの描画結果
+2. コンテキストオブジェクトの描画


rendering は context object にかかっているので、"描画コンテキストオブジェクト" にしてしまって良い気がします。

ktsn · 2019-02-08T09:49:02Z

docs/ja/api/README.md

@@ -140,7 +140,7 @@ const renderer = createRenderer({
 })
 ```

-Note that when using a custom template function, nothing will be automatically injected - you will be in full control of what the eventual HTML includes, but also will be responsible for including everything yourself (e.g. asset links if you are using the bundle renderer).
+カスタムテンプレート関数を使用するとき、自動的に注入されるものが何もないことに注意してください。最終的な HTML に含まれるものを完全に制御できますが、全てあなた自身で含める責任があります (例えば、バンドルレンダラを使用する場合、アセットリンク)。


責任があります

直訳だとこうなのですが、この文脈だと違和感があるので必要がありますにするのはどうですか？

ktsn · 2019-02-08T10:08:25Z

docs/ja/guide/data.md

@@ -86,13 +85,13 @@ export function createApp () {

 フェッチする必要があるデータはアクセスしたルート (route) によって決まります。またそのルートによってどのコンポーネントが描画されるかも決まります。実のところ、与えられたルートに必要とされるデータは、そのルートで描画されるコンポーネントに必要とされるデータでもあるのです。したがって、データをフェッチするロジックはルートコンポーネントの中に置くのが自然でしょう。

-We will use the `serverPrefetch` option (new in 2.6.0+) in our components. This option is recognized by the server renderer and will pause the rendering until the promise it returns is resolved. This allows us to "wait" on async data during the rendering process.
+コンポーネントでは、 `serverPrefetch` オプション (新規2.6.0以降)を使用します。このオプションは、サーバレンダラによって認識され、そして Promise が解決されるまで描画を一時停止します。これにより、描画処理中に非同期データを"待つ"ことができます。


そして Promise が解決されるまで描画を一時停止します。

原文の it returns が抜けてしまってますね。

ktsn · 2019-02-08T10:13:47Z

docs/ja/guide/data.md


-Now we know that the rendering process will wait for data fetching in our components, how do we know when it is "done"? In order to do that, we need to attach a `rendered` callback to the render context (also new in 2.6), which the server renderer will call when the entire rendering process is finished. At this moment, the store should have been filled with the final state. We can then inject it on to the context in that callback:
+これで、描画プロセスがコンポーネント内のデータフェッチを待つことがわかりましたが、それが"完了"したというのをどうやって分かるのでしょうか？それをするために、描画プロセス全体が終了したときに、サーバレンダラは、"rendered" コールバックを描画コンテキストにアタッチする必要があります（これも 2.6 での新機能）。現時点で、ストア最終的な状態で満たされているはずです。そのコールバックでそのコンテキストにそれを注入することができます:


それをするために、描画プロセス全体が終了したときに、サーバレンダラは、"rendered" コールバックを描画コンテキストにアタッチする必要があります（これも 2.6 での新機能）。

それをするために、描画コンテキストに rendered コールバックをアタッチする必要があります（これも 2.6 での新機能）。これは描画プロセス全体が終了したときにサーバーレンダラによって呼ばれます。

みたいな感じですかねー。

ktsn · 2019-02-08T10:15:16Z

docs/ja/guide/data.md


-Now we know that the rendering process will wait for data fetching in our components, how do we know when it is "done"? In order to do that, we need to attach a `rendered` callback to the render context (also new in 2.6), which the server renderer will call when the entire rendering process is finished. At this moment, the store should have been filled with the final state. We can then inject it on to the context in that callback:
+これで、描画プロセスがコンポーネント内のデータフェッチを待つことがわかりましたが、それが"完了"したというのをどうやって分かるのでしょうか？それをするために、描画プロセス全体が終了したときに、サーバレンダラは、"rendered" コールバックを描画コンテキストにアタッチする必要があります（これも 2.6 での新機能）。現時点で、ストア最終的な状態で満たされているはずです。そのコールバックでそのコンテキストにそれを注入することができます:


ストア最終的な状態

ストアはですかね。

ktsn · 2019-02-08T10:15:53Z

docs/ja/guide/data.md


-Now we know that the rendering process will wait for data fetching in our components, how do we know when it is "done"? In order to do that, we need to attach a `rendered` callback to the render context (also new in 2.6), which the server renderer will call when the entire rendering process is finished. At this moment, the store should have been filled with the final state. We can then inject it on to the context in that callback:
+これで、描画プロセスがコンポーネント内のデータフェッチを待つことがわかりましたが、それが"完了"したというのをどうやって分かるのでしょうか？それをするために、描画プロセス全体が終了したときに、サーバレンダラは、"rendered" コールバックを描画コンテキストにアタッチする必要があります（これも 2.6 での新機能）。現時点で、ストア最終的な状態で満たされているはずです。そのコールバックでそのコンテキストにそれを注入することができます:


そのコールバックでそのコンテキストにそれを注入することができます

"その", "それ"が続いていて難しいので、以下のような感じでどうでしょうか。

そのコールバック内でコンテキストに状態を注入できます。

ktsn · 2019-02-08T10:19:38Z

docs/ja/guide/data.md

@@ -275,5 +274,5 @@ export default {
 モジュールはルートコンポーネントの依存関係になっているので、webpack によってルートコンポーネントの非同期チャンクに移動されます。

 ::: warning
-Don't forget to use the `preserveState: true` option for `registerModule` so we keep the state injected by the server.
+サーバによって注入された状態が維持されるため、`registerModule` に  `preserveState: true` オプションを使用することを忘れないでください。


サーバによって注入された状態が維持されるため

この書き方だと逆の意味でも取れてしまいます。
状態を維持するため　にするのはどうでしょうか？

ref: - vuejs#228 (review) - vuejs#228 (comment)

ref: - vuejs#228 (comment) - vuejs#228 (comment)

ref: - vuejs#228 (comment)

ref: - vuejs#228 (comment) - vuejs#228 (comment)

ref: - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment)

ktsn

👍

kazupon · 2019-02-09T06:07:13Z

Thanks!

kazupon added 2 commits February 8, 2019 16:46

merge 2.6 updating en docs to ja docs

aeb8b64

docs(ja): translates

2587474

docs(ja): more translation

e77c2ec

ktsn reviewed Feb 8, 2019

View reviewed changes

kazupon added 6 commits February 9, 2019 00:46

docs(ja): update

dca2c03

ref: - vuejs#228 (review) - vuejs#228 (comment)

docs(ja): update template function explanation

0b6bfaf

ref: - vuejs#228 (comment) - vuejs#228 (comment)

docs(ja): update template function example codes

ad862f4

ref: - vuejs#228 (comment)

docs(ja): update serializer

9ea4000

ref: - vuejs#228 (comment) - vuejs#228 (comment)

docs(ja): update server only component options

b75e237

ref: - vuejs#228 (comment) - vuejs#228 (comment)

docs(ja): update data section

8b13784

ref: - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment) - vuejs#228 (comment)

ktsn approved these changes Feb 9, 2019

View reviewed changes

kazupon merged commit 14e3169 into vuejs:master Feb 9, 2019

kazupon deleted the docs/ja branch February 9, 2019 06:07

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

update ja docs #228

update ja docs #228

kazupon commented Feb 8, 2019

kazupon commented Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn Feb 8, 2019

ktsn left a comment

kazupon commented Feb 9, 2019


		Now we know that the rendering process will wait for data fetching in our components, how do we know when it is "done"? In order to do that, we need to attach a `rendered` callback to the render context (also new in 2.6), which the server renderer will call when the entire rendering process is finished. At this moment, the store should have been filled with the final state. We can then inject it on to the context in that callback:
		これで、描画プロセスがコンポーネント内のデータフェッチを待つことがわかりましたが、それが"完了"したというのをどうやって分かるのでしょうか？それをするために、描画プロセス全体が終了したときに、サーバレンダラは、"rendered" コールバックを描画コンテキストにアタッチする必要があります（これも 2.6 での新機能）。現時点で、ストア最終的な状態で満たされているはずです。そのコールバックでそのコンテキストにそれを注入することができます:

update ja docs #228

update ja docs #228

Conversation

kazupon commented Feb 8, 2019

kazupon commented Feb 8, 2019

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ktsn left a comment

Choose a reason for hiding this comment

kazupon commented Feb 9, 2019