Translate v2 docs in Japanese. #428

kitak · 2016-10-29T04:05:38Z

TODO

inouetakuya · 2016-11-11T13:57:21Z

docs/ja/getting-started.md

+
+1. Vuex ストアはリアクティブです。 Vue コンポーネントがストアから状態を取り出すとき、もしストアの状態が変化したら、ストアはリアクティブかつ効率的に更新を行います。
+
+2. ストアの状態を直接変更することはできません。明示的に**ミューテーションをコミットする**ことによってのみ、ストアの状態を変更します。これによって、全ての状態の変更について追跡可能な記録を残すことが保証され、ツールでのアプリケーションの動作の理解を助けます。


@kitak @tadyjp

You cannot directly mutate the store's state. The only way to change a store's state is by explicitly committing mutations. This ensures every state change leaves a track-able record, and enables tooling that helps us better understand our applications.

I am not really sure about the translation of "committing mutations".

Which do you think is the best?

ミューテーションをコミットする

ミューテーションを送る

another idea?

メソッド名と対応しているので「ミューテーションをコミットする」が良いと思います。

ありがとうございます！「ミューテーションをコミットする」でいこうと思います！

inouetakuya · 2016-11-23T02:37:53Z

@kitak Modules(modules.md) の翻訳やりたいですー

…late-ja

kimikimi714

翻訳しながら理解できなかった部分について自分でコメントを書きました。フィードバックよろしくお願いします。

kimikimi714 · 2016-11-29T22:45:43Z

docs/ja/api.md

+    rootState  // store.state と同じ
+    ```
+
+    登録されたゲッターは `store.getters` 上で外から見えるようになります。


exposeをどう訳すと良いかがわからず「外から見える」と訳しています

「公開されます」はどうでしょうか？

なるほど！そのほうがしっくりきますね。修正します。

kimikimi714 · 2016-11-29T22:47:00Z

docs/ja/api.md

+
+- **`dispatch(mutationName: String, ...args) | dispatch(mutation: Object)`**
+
+アクションをディスパッチします。すべてのトリガーされたアクションハンドラを解決するプロミスを返します。[詳細](actions.md)


上の他の方の翻訳例を見るとPromiseはPromiseのままのようなので、そちらに合わせるよう修正します。

kimikimi714 · 2016-11-29T22:49:25Z

docs/ja/api.md

+
+- **`mapActions(map: Array<string> | Object): Object`**
+
+  アクションをディスパッチするコンポーネントメソッドオプションを作成します。[詳細](actions.md#dispatching-actions-in-components)


component methods optionsという単語ひとかたまりかと思って訳してしまっているのですが、間違っている気がしています…。

コンポーネントのメソッドオプションでどうでしょうか？

確かに、そのほうが何のことかがもう少しわかりやすくなりますね。修正します。

いっそのこと、メソッドはプロパティ名のままで コンポーネントの methods オプションとかどうでしょうか。

なるほどです。無理に全部日本語にしようとしないほうがわかりやすそうですね。
コンポーネントの methods オプション で修正します。

kimikimi714 · 2016-11-30T13:42:30Z

docs/ja/api.md

+
+- **`replaceState(state: Object)`**
+
+ストアのルートステートを置き換えます。これは、ステートの水和やタイムトラベルのためだけに利用すべきです。


hydrationの訳もどうしていいものかわかりませんでした。
直訳だと水和であってると思うのですが、何かのジョークなのか?とも思ってよくわからないですね…。

hydration はハイドレーションでいいと思います。Server Side Rendering の用語です。

ktsn · 2016-12-01T01:12:36Z

docs/ja/api.md

+
+  - 型: `Object`
+
+    Vuex store のための ルートステートオブジェクトです。


他の方の翻訳ではストアと書かれてるので、 s/store/ストア/ していただけますか？

確かに。1.0のときにままにしていました。置き換えます。

ktsn · 2016-12-01T01:14:58Z

docs/ja/api.md

+
+  - 型: `{ [type: string]: Function }`
+
+    Vuex storeにミューテーションを登録します。ハンドラ関数は第一引数に `state` を常に受け取り(またモジュール内で定義されていれば、ローカルステートをモジュール化し)、指定されていれば第二引数に `payload` を受け取ります。


ローカルステートをモジュール化し

「モジュールのローカルステートを受け取り」が原文の意味として正しいですね。

確かに be moduled ではないですね。修正します。

ktsn · 2016-12-01T01:15:44Z

docs/ja/api.md

+
+    ``` js
+    {
+      state,     // store.state と同じか, or モジュール内にあればローカルステート


or はとりましょう！

消し忘れていました…。消します。

ktsn · 2016-12-01T01:16:38Z

docs/ja/api.md

+    Vuex storeにゲッターを登録します. ゲッター関数は次の引数を受け取ります:
+
+    ```
+    state,     // モジュール内で定義されていればローカルステートをモジュール化します


ローカルステートをモジュール化します

「モジュールのローカルステートとなります」が原文の意味として正しいですね。

ktsn · 2016-12-01T01:19:57Z

docs/ja/api.md

+    }
+    ```
+
+    各モジュールは、ルートオプションに似た `state` と `mutations` を含むことができます。モジュールの状態は、モジュールのキーを使って、ストアのルートステートにアタッチされます。モジュールのミューテーションとゲッターは、第一引数としてルートステートの代わりに、モジュールのローカルステートだけを受け取り、モジュールのアクションの `context.state` もローカルステートを指すようになります。


アタッチされます

結合されます。とかでどうでしょうか？

ktsn · 2016-12-01T01:55:49Z

docs/ja/api.md

+  store.subscribe((mutation, state) => {
+      console.log(mutation.type)
+      console.log(mutation.payload)
+      })


インデントが微妙にずれてますね。

ktsn · 2016-12-01T01:56:24Z

docs/ja/api.md

+      })
+  ```
+
+  もっともよく利用されるプラグインです。[詳細](plugins.md)


Most commonly used in plugins
なので、プラグイン内でよく使われると言う意味になります。

ktsn · 2016-12-01T01:57:23Z

docs/ja/api.md

+
+- **`hotUpdate(newOptions: Object)`**
+
+  新しいアクションとミューテーションでホットスワップします。[詳細](hot-reload.md)


こまかいですが、new actions and mutations は目的格なのででではなくをだと思います。

確かにではおかしいですね。修正します。

ktsn · 2016-12-01T02:01:24Z

docs/ja/api.md

+
+- **`mapState(map: Array<string> | Object): Object`**
+
+  Vuex storeのサブツリーを返すオプションを計算したコンポーネントを作成します。[詳細](state.md#the-mapstate-helper)


Create component computed options

は「コンポーネントの算出プロパティオプションを作成する」で、

that return the sub tree of the Vuex store

はそのオプションが「Vuex ストアのサブツリーを返す」ことを意味しています。

ktsn · 2016-12-01T02:01:53Z

docs/ja/api.md

+
+- **`mapGetters(map: Array<string> | Object): Object`**
+
+  ゲッターの評価後の値を返すオプションを計算したコンポーネントを作成します。[詳細](getters.md#the-mapgetters-helper)


こちらも上記と同様に、作成するのは「コンポーネントの算出プロパティオプション」です。

下の methods と合わせて computed オプションにしても良いかもしれません

なるほど。上のコメントも合わせてありがとうございます。
computedオプションにしてしまおうと思います。

kimikimi714

コメントをいただいた部分の修正を行いました。ご確認よろしくお願いします。

kimikimi714 · 2016-12-01T09:14:17Z

docs/ja/api.md

+
+    ``` js
+    {
+      state,     // store.state と同じか, or モジュール内にあればローカルステート


消し忘れていました…。消します。

kimikimi714 · 2016-12-01T09:15:52Z

docs/ja/api.md

+
+  - 型: `Object`
+
+    Vuex store のための ルートステートオブジェクトです。


確かに。1.0のときにままにしていました。置き換えます。

kimikimi714 · 2016-12-01T09:20:26Z

docs/ja/api.md

+
+  - 型: `{ [type: string]: Function }`
+
+    Vuex storeにミューテーションを登録します。ハンドラ関数は第一引数に `state` を常に受け取り(またモジュール内で定義されていれば、ローカルステートをモジュール化し)、指定されていれば第二引数に `payload` を受け取ります。


確かに be moduled ではないですね。修正します。

kimikimi714 · 2016-12-01T09:28:37Z

docs/ja/api.md

+
+  ストアのルートステートを置き換えます。これは、ステートの水和やタイムトラベルのためだけに利用すべきです。
+
+- **`watch(getter: Function, cb: Function, [options: Object])`**


https://github.com/vuejs/vuex/blob/dev/docs/en/api.md
~~でも (state: Object) になっているように思いますが、間違っていますでしょうか?~~

下の options?: Object にならないといけないところですね。失礼いたしました。修正します。

kimikimi714 · 2016-12-01T09:37:43Z

docs/ja/api.md

+
+- **`hotUpdate(newOptions: Object)`**
+
+  新しいアクションとミューテーションでホットスワップします。[詳細](hot-reload.md)


確かにではおかしいですね。修正します。

ktsn · 2016-12-01T09:55:19Z

docs/ja/api.md

  ```

-  もっともよく利用されるプラグインです。[詳細](plugins.md)
+  プラグインの中でももっともよく利用されます。[詳細](plugins.md)


何度もすみません。この訳だと、 subscribe ∈ プラグインという意味になってしまうと思います。
この文で言いたいのは、この subscribe メソッドの使い道として、それぞれの Vuex プラグインの中で使われることを想定しているということなので、中でも ではなく 中で が良いんじゃないかと思います。

なるほど！完全に勘違いしていました！
プラグイン内で利用されることがある、ということですね…。
修正します。

kitak · 2016-12-04T10:25:24Z

Could you please merge it?

ktsn · 2016-12-05T00:20:08Z

@kitak @inouetakuya @tadyjp @kimikimi714
Thanks for your hard work!
Can we add README.md and book.json for Japanese docs for our final task? :)
Make sure to merge latest dev branch into yours since there are a few update for docs.

kitak · 2016-12-05T01:04:30Z

@ktsn

OK. I've done them.

ktsn · 2016-12-05T04:34:57Z

Thanks! I'm merging this.

ktsn · 2016-12-05T04:39:33Z

Deployed 🎉 https://vuex.vuejs.org/ja/

kitak and others added 11 commits October 29, 2016 12:58

Starting japanese translation.

c29078a

Move intro.md from v1.0

0a1d6b6

Installation.md in Japanese

f6436b9

translate headers

f311ca0

Copy docs/en/getting-started.md from 1.0

084e85e

Copy docs/en/getting-started.md from 2.0, understanding diff 1.0 and 2.0

917f4ce

Copy docs/ja/getting-started.md from 1.0

0be72fa

Translated the part of getting-started.md which has no diff 1.0 and 2.0

f371744

Translate getting-started.md

5322189

Make getting-started.md more readable

98d2902

Tiny change

d93f15b

inouetakuya reviewed Nov 11, 2016

View reviewed changes

kitak and others added 17 commits November 20, 2016 21:58

Translate intro

aa9d6dc

translate intro

ed57506

Copy docs/en/getters.md to ja

ab7a095

Translate getters.md

373e5ad

Translate mapGetters helper

f756709

Copy docs/en/mutations.md from 1.0

ccdccb7

Copy docs/en/mutations.md from 2.0, understanding diff 1.0 and 2.0

5f91077

Copy docs/ja/mutations.md from 1.0

aff1ab5

Translate mutations.md

52f02b6

Delete unnecessary rows

bde44a0

Copy actions.md from 1.0

9387983

Copy actions.md from 2.0, understanding diff 1.0 and 2.0

84e162b

Copy docs/ja/actions.md from 1.0

fc4fc68

Translate state

4b220d0

Translate dispatching actions

d381f87

Translate actions.md

d245499

Merge branch 'translate-ja' of github.com:kitak/vuex into translate-ja

43a6b6e

kimikimi714 added 2 commits November 29, 2016 22:51

Translate docs/ja/api.md

c0b7cbb

Merge branch 'translate-ja' of ssh://github.com/kitak/vuex into trans…

657185e

…late-ja

kimikimi714 reviewed Nov 29, 2016

View reviewed changes

kimikimi714 added 3 commits November 30, 2016 22:25

Replace プロミス with Promise

5b9a8e4

Improve translation of 'expose'

9c94f93

Improve translation of 'component methods options'

cafbb47

kimikimi714 reviewed Nov 30, 2016

View reviewed changes

kimikimi714 added 2 commits November 30, 2016 22:44

Fix indent

e755323

Improve translation

808c3ba

ktsn reviewed Dec 1, 2016

View reviewed changes

kimikimi714 added 6 commits December 1, 2016 18:18

Replace Vue store with ストア

9c2fcba

Improve transration

ac3dede

Fix arguments of dispatch and watch

dbc71f9

Improve translation

acf740d

Fix indent

b981ffc

Improve translation

a615dd6

kimikimi714 reviewed Dec 1, 2016

View reviewed changes

Improve translation

64e72c4

ktsn reviewed Dec 1, 2016

View reviewed changes

Improve translation

07b5df3

kitak changed the title ~~[WIP] Translate v2 docs in Japanese.~~ Translate v2 docs in Japanese. Dec 4, 2016

ktsn approved these changes Dec 5, 2016

View reviewed changes

kitak added 2 commits December 5, 2016 09:52

Merge branch 'dev' into translate-ja

5634911

Add README.md and book.json

cfba71e

ktsn merged commit 730deb7 into vuejs:dev Dec 5, 2016


		1. Vuex ストアはリアクティブです。 Vue コンポーネントがストアから状態を取り出すとき、もしストアの状態が変化したら、ストアはリアクティブかつ効率的に更新を行います。

		2. ストアの状態を直接変更することはできません。明示的にミューテーションをコミットすることによってのみ、ストアの状態を変更します。これによって、全ての状態の変更について追跡可能な記録を残すことが保証され、ツールでのアプリケーションの動作の理解を助けます。


		- `dispatch(mutationName: String, ...args) \| dispatch(mutation: Object)`

		アクションをディスパッチします。すべてのトリガーされたアクションハンドラを解決するプロミスを返します。[詳細](actions.md)


		- `mapActions(map: Array<string> \| Object): Object`

		アクションをディスパッチするコンポーネントメソッドオプションを作成します。[詳細](actions.md#dispatching-actions-in-components)


		- `replaceState(state: Object)`

		ストアのルートステートを置き換えます。これは、ステートの水和やタイムトラベルのためだけに利用すべきです。


		- 型: `Object`

		Vuex store のためのルートステートオブジェクトです。


		- 型: `{ [type: string]: Function }`

		Vuex storeにミューテーションを登録します。ハンドラ関数は第一引数に `state` を常に受け取り(またモジュール内で定義されていれば、ローカルステートをモジュール化し)、指定されていれば第二引数に `payload` を受け取ります。


		- `hotUpdate(newOptions: Object)`

		新しいアクションとミューテーションでホットスワップします。[詳細](hot-reload.md)


		- `mapState(map: Array<string> \| Object): Object`

		Vuex storeのサブツリーを返すオプションを計算したコンポーネントを作成します。[詳細](state.md#the-mapstate-helper)


		- `mapGetters(map: Array<string> \| Object): Object`

		ゲッターの評価後の値を返すオプションを計算したコンポーネントを作成します。[詳細](getters.md#the-mapgetters-helper)


		ストアのルートステートを置き換えます。これは、ステートの水和やタイムトラベルのためだけに利用すべきです。

		- `watch(getter: Function, cb: Function, [options: Object])`

Translate v2 docs in Japanese. #428

Translate v2 docs in Japanese. #428

Conversation

kitak commented Oct 29, 2016 • edited Loading

TODO

inouetakuya Nov 11, 2016 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

inouetakuya commented Nov 23, 2016

kimikimi714 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

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

Choose a reason for hiding this comment

Choose a reason for hiding this comment

kimikimi714 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

kitak commented Dec 4, 2016

ktsn commented Dec 5, 2016

kitak commented Dec 5, 2016

ktsn commented Dec 5, 2016

ktsn commented Dec 5, 2016

kitak commented Oct 29, 2016 •

edited

Loading

inouetakuya Nov 11, 2016 •

edited

Loading