translated the "source code structure" into Japanese. #26

nasum · 2017-05-28T17:08:52Z

translated the "source code structure" into Japanese.

kazupon

レビュー 👀 しました。
レビューコメント 💬 の対応、よろしくお願いします！

kazupon · 2017-05-29T13:50:29Z

ja/structure.md

+
+## ステートフルなシングルトンは避ける
+
+クライアント専用のコードを書くとき、私たちはコードが毎回新鮮なコンテキストで評価されるという事実に慣れています。しかし、 Node.js サーバーは長時間実行されるプロセスです。私たちのコードがプロセスに要求されるとき、それは一度評価されメモリにとどまります。つまりシングルトンのオブジェクトを作成したとき、それは全ての受信リクエスト間でシェアされると言うことです。


fresh の訳ですが、新鮮ですと生き物のような気がするので、ここでは新しいでいいかと思います。

kazupon · 2017-05-29T13:53:16Z

ja/structure.md

+
+## ステートフルなシングルトンは避ける
+
+クライアント専用のコードを書くとき、私たちはコードが毎回新鮮なコンテキストで評価されるという事実に慣れています。しかし、 Node.js サーバーは長時間実行されるプロセスです。私たちのコードがプロセスに要求されるとき、それは一度評価されメモリにとどまります。つまりシングルトンのオブジェクトを作成したとき、それは全ての受信リクエスト間でシェアされると言うことです。


client-onlyの訳ですが、クライアント専用ですと文章的に違和感があるので、クライアントのみでいいと思います。

kazupon · 2017-05-29T13:54:29Z

ja/structure.md

+
+クライアント専用のコードを書くとき、私たちはコードが毎回新鮮なコンテキストで評価されるという事実に慣れています。しかし、 Node.js サーバーは長時間実行されるプロセスです。私たちのコードがプロセスに要求されるとき、それは一度評価されメモリにとどまります。つまりシングルトンのオブジェクトを作成したとき、それは全ての受信リクエスト間でシェアされると言うことです。
+
+基本的な例としては、私たちは **リクエストごとに新しいルート Vue インスタンスを作成します**。それは各ユーザがそれぞれのブラウザでアプリの新鮮なインスタンスを使用することに似ています。もし私たちが複数のリクエストをまたいでインスタンスを共有すると、それは容易にクロスリクエスト状態の汚染につながるでしょう。


ここのfreshも新しいにしましょう！

kazupon · 2017-05-29T13:57:22Z

ja/structure.md

+
+クライアント専用のコードを書くとき、私たちはコードが毎回新鮮なコンテキストで評価されるという事実に慣れています。しかし、 Node.js サーバーは長時間実行されるプロセスです。私たちのコードがプロセスに要求されるとき、それは一度評価されメモリにとどまります。つまりシングルトンのオブジェクトを作成したとき、それは全ての受信リクエスト間でシェアされると言うことです。
+
+基本的な例としては、私たちは **リクエストごとに新しいルート Vue インスタンスを作成します**。それは各ユーザがそれぞれのブラウザでアプリの新鮮なインスタンスを使用することに似ています。もし私たちが複数のリクエストをまたいでインスタンスを共有すると、それは容易にクロスリクエスト状態の汚染につながるでしょう。


アプリは略称なのでアプリケーションにしておきましょう！

kazupon · 2017-05-29T13:57:37Z

ja/structure.md

+
+基本的な例としては、私たちは **リクエストごとに新しいルート Vue インスタンスを作成します**。それは各ユーザがそれぞれのブラウザでアプリの新鮮なインスタンスを使用することに似ています。もし私たちが複数のリクエストをまたいでインスタンスを共有すると、それは容易にクロスリクエスト状態の汚染につながるでしょう。
+
+そのため、直接アプリのインスタンスを作成するのではなく、各リクエストで繰り返し実行される新しいアプリのインスタンスを作成するファクトリ関数を公開する必要があります：


ここも同じく、アプリは略称なのでアプリケーションにしておきましょう！

kazupon · 2017-05-29T14:03:20Z

ja/structure.md

+
+これまでは、同じ Vue アプリケーションをクライアントへ配信する方法を論じてはいませんでした。これを行うには、webpack を使用して Vue アプリケーションをバンドルする必要があります。実際、webpack を使用して Vue アプリケーションをサーバーにバンドルしたいと思っているのはおそらく次の理由によるものです。
+
+- 典型的な Vue アプリケーションは webpack と `vue-loader` によってビルドされ、 `file-loader` 経由でのファイルのインポートや`css-loader 経由でCSSをインポートなどの多くの webpack 固有の機能は Node.jsで直接動作しないため。`


体現止めではなく、〜ですにしておきましょう〜

kazupon · 2017-05-29T14:07:03Z

ja/structure.md

+
+## Webpackによるコード戦略
+
+webpack を使用してサーバーとクライアントのアプリケーションを処理しているので、ソースコードの大部分はユニバーサルに書かれており、すべての webpack の機能にアクセスできます。 同時に、ユニバーサルなコードを書くときに留意すべき[いくつかのことがあります。](./universal.md)


a number of things の訳ですが、いくつかあります。にした方が自然ではないでしょうか。

kazupon · 2017-05-29T14:09:37Z

ja/structure.md

+
+### `entry-server.js`:
+
+サーバーエントリはレンダリングごとに繰り返し呼び出すことができる関数をデフォルトでエクスポートします。現時点では、アプリケーションインスタンスを作成して返す以外のことはほとんど行いませんが、後でサーバーサイドのルートマッチングとデータプリフェッチロジックを実行します。The server entry uses a default export which is a function that can be called repeatedly for each render. At this moment, it doesn't do much other than creating and returning the app instance - but later when we will perform server-side route matching and data pre-fetching logic here.


原文が残ってしまっているので、削除しましょう！

kazupon · 2017-05-29T14:11:20Z

ja/structure.md

@@ -0,0 +1,114 @@
+# ソースコード戦略


Source Code Structureの訳ですが、このセクションでは、構造の説明なので、普通に ソースコードの構造でいいと思います。

kazupon · 2017-05-29T14:12:10Z

ja/structure.md

+
+セットアップの詳細については次のセクションで議論されます。今のところ、ビルドのセットアップが分かっていると仮定すると、webpack を有効にして Vue アプリコードを書くことが可能になっています。
+
+## Webpackによるコード戦略


ここタイトルのstructureも訳構造でいいと思います。

inouetakuya · 2017-06-20T12:04:01Z

ja/structure.md

+└── entry-server.js # runs on server only
+```
+
+### `app.js `


app.js の後に半角スペースが入ってしまっているようです

ここの半角スペース削除、お願いします！

kazupon · 2017-06-29T12:21:30Z

/ping @nasum
レビューコメント後に、コミットされていますが、もうマージしちゃっていいですか？

…ion (#26)

* Translate SUMMARY.md via GitLocalize * Revert "Chinese Translation: zh/summary" * Revert "Revert "Chinese Translation: zh/summary"" * Japanese Translation: ja/css.md (open-source-translators#19) * Translate css.md via GitLocalize * Translate css.md via GitLocalize * Update css.md Remove style closing tags * Translate css.md via GitLocalize * Update css.md * Translate api.md via GitLocalize * Translate streaming.md via GitLocalize (open-source-translators#22) * Translate caching.md via GitLocalize (open-source-translators#23) * Japanese Translation: ja/routing.md (open-source-translators#18) * Translate routing.md via GitLocalize * Translate routing.md via GitLocalize * Translate universal.md via GitLocalize (open-source-translators#29) * ja/api.md (open-source-translators#28) * Translate api.md via GitLocalize * Translate api.md via GitLocalize * Translate api.md via GitLocalize * Translate api.md via GitLocalize * Translate build-config.md via GitLocalize (open-source-translators#27) * Translate build-config.md via GitLocalize * Translate build-config.md via GitLocalize * Translate build-config.md via GitLocalize * Japanese translation: bundle-renderer.md (open-source-translators#30) * Translate bundle-renderer.md via GitLocalize * Translate bundle-renderer.md via GitLocalize * Translate basic.md (open-source-translators#32) * Translate basic.md via GitLocalize * Translate basic.md via GitLocalize * Translate basic.md via GitLocalize * Translate basic.md via GitLocalize * Japanese Translation: ja/data.md (open-source-translators#25) * Translate data.md via GitLocalize * Translate data.md via GitLocalize * Fix typos * コード内のコメントを日本語に翻訳した * コード内のコメントの意図をより明確にした * expose はモジュールとしての公開するという意味なので訳を変更した * 原文に ... とあるので一応残しておく * "Client Side Hydration" の翻訳 (open-source-translators#36) * Translate hydration.md via GitLocalize * Translate hydration.md via GitLocalize * Japanese Translation: ja/head.md (open-source-translators#33) * Translate head.md via GitLocalize * Translate head.md via GitLocalize * expose はモジュールとして公開するという意味なので公開という言葉を使うようにした * コードのコメントの翻訳が漏れていた * Japanese Translation: ja/routing.md (open-source-translators#38) * Translate routing.md via GitLocalize * Translate routing.md via GitLocalize * Japanese Translation: ja/caching.md (open-source-translators#37) * Translate caching.md via GitLocalize * Translate caching.md via GitLocalize * translated the "source code structure" into Japanese. (open-source-translators#26) * Translate structure.md via GitLocalize * Translate structure.md via GitLocalize * Translate structure.md via GitLocalize * Japanese Translation: ja/SUMMARY.md (open-source-translators#35) * Translate SUMMARY.md via GitLocalize * hydration.md と合わせた "Client Side Hydration" の翻訳 by hikimon · Pull Request open-source-translators#36 · open-source-translators/vue-ssr-docs open-source-translators#36 * en/ に合わせてインデントを 2 にした * Renderer 生成時の各オプションの階層を下げた。en/ でもそうなっている * Japanese translation: readme.md (open-source-translators#39) * Translate README.md via GitLocalize * Translate README.md via GitLocalize

Translate structure.md via GitLocalize

b1324b3

kazupon requested changes May 29, 2017

View reviewed changes

inouetakuya reviewed Jun 20, 2017

View reviewed changes

Masaya Nasu added 2 commits June 21, 2017 23:01

Translate structure.md via GitLocalize

93860f3

Translate structure.md via GitLocalize

84822d2

kazupon approved these changes Jul 1, 2017

View reviewed changes

kazupon merged commit 6dc3006 into open-source-translators:master Jul 1, 2017

kazupon mentioned this pull request Jul 1, 2017

PRをマージしたら conflict が発生 gitlocalize/feedback#3

Closed

kazupon pushed a commit that referenced this pull request Jul 9, 2017

Update docs to have double vs triple quoted meaning in for interpolat…

1c17b0b

…ion (#26)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

translated the "source code structure" into Japanese. #26

translated the "source code structure" into Japanese. #26

nasum commented May 28, 2017

kazupon left a comment

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

kazupon May 29, 2017

inouetakuya Jun 20, 2017

kazupon Jun 21, 2017

kazupon commented Jun 29, 2017


		## ステートフルなシングルトンは避ける

		クライアント専用のコードを書くとき、私たちはコードが毎回新鮮なコンテキストで評価されるという事実に慣れています。しかし、 Node.js サーバーは長時間実行されるプロセスです。私たちのコードがプロセスに要求されるとき、それは一度評価されメモリにとどまります。つまりシングルトンのオブジェクトを作成したとき、それは全ての受信リクエスト間でシェアされると言うことです。


		クライアント専用のコードを書くとき、私たちはコードが毎回新鮮なコンテキストで評価されるという事実に慣れています。しかし、 Node.js サーバーは長時間実行されるプロセスです。私たちのコードがプロセスに要求されるとき、それは一度評価されメモリにとどまります。つまりシングルトンのオブジェクトを作成したとき、それは全ての受信リクエスト間でシェアされると言うことです。

		基本的な例としては、私たちはリクエストごとに新しいルート Vue インスタンスを作成します。それは各ユーザがそれぞれのブラウザでアプリの新鮮なインスタンスを使用することに似ています。もし私たちが複数のリクエストをまたいでインスタンスを共有すると、それは容易にクロスリクエスト状態の汚染につながるでしょう。


		基本的な例としては、私たちはリクエストごとに新しいルート Vue インスタンスを作成します。それは各ユーザがそれぞれのブラウザでアプリの新鮮なインスタンスを使用することに似ています。もし私たちが複数のリクエストをまたいでインスタンスを共有すると、それは容易にクロスリクエスト状態の汚染につながるでしょう。

		そのため、直接アプリのインスタンスを作成するのではなく、各リクエストで繰り返し実行される新しいアプリのインスタンスを作成するファクトリ関数を公開する必要があります：


		これまでは、同じ Vue アプリケーションをクライアントへ配信する方法を論じてはいませんでした。これを行うには、webpack を使用して Vue アプリケーションをバンドルする必要があります。実際、webpack を使用して Vue アプリケーションをサーバーにバンドルしたいと思っているのはおそらく次の理由によるものです。

		- 典型的な Vue アプリケーションは webpack と `vue-loader` によってビルドされ、 `file-loader` 経由でのファイルのインポートや`css-loader 経由でCSSをインポートなどの多くの webpack 固有の機能は Node.jsで直接動作しないため。`


		## Webpackによるコード戦略

		webpack を使用してサーバーとクライアントのアプリケーションを処理しているので、ソースコードの大部分はユニバーサルに書かれており、すべての webpack の機能にアクセスできます。同時に、ユニバーサルなコードを書くときに留意すべき[いくつかのことがあります。](./universal.md)


		### `entry-server.js`:

		サーバーエントリはレンダリングごとに繰り返し呼び出すことができる関数をデフォルトでエクスポートします。現時点では、アプリケーションインスタンスを作成して返す以外のことはほとんど行いませんが、後でサーバーサイドのルートマッチングとデータプリフェッチロジックを実行します。The server entry uses a default export which is a function that can be called repeatedly for each render. At this moment, it doesn't do much other than creating and returning the app instance - but later when we will perform server-side route matching and data pre-fetching logic here.


		セットアップの詳細については次のセクションで議論されます。今のところ、ビルドのセットアップが分かっていると仮定すると、webpack を有効にして Vue アプリコードを書くことが可能になっています。

		## Webpackによるコード戦略

translated the "source code structure" into Japanese. #26

translated the "source code structure" into Japanese. #26

Conversation

nasum commented May 28, 2017

kazupon left a 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

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

kazupon commented Jun 29, 2017