New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate v2 docs in Japanese. #428

Merged
merged 83 commits into from Dec 5, 2016

Conversation

Projects
None yet
8 participants
@kitak
Contributor

kitak commented Oct 29, 2016

TODO

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

This comment has been minimized.

@inouetakuya

inouetakuya Nov 11, 2016

@kitak @tadyjp

  1. 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

inouetakuya Nov 11, 2016

@kitak @tadyjp

  1. 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?

This comment has been minimized.

@ktsn

ktsn Nov 11, 2016

Member

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

@ktsn

ktsn Nov 11, 2016

Member

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

This comment has been minimized.

@inouetakuya

inouetakuya Nov 12, 2016

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

@inouetakuya

inouetakuya Nov 12, 2016

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

@inouetakuya

This comment has been minimized.

Show comment
Hide comment
@inouetakuya

inouetakuya Nov 23, 2016

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

inouetakuya commented Nov 23, 2016

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

@inouetakuya

This comment has been minimized.

Show comment
Hide comment
@inouetakuya

inouetakuya Nov 23, 2016

@kitak Application Structure(structure.md) の翻訳やりたいですー

inouetakuya commented Nov 23, 2016

@kitak Application Structure(structure.md) の翻訳やりたいですー

@inouetakuya

This comment has been minimized.

Show comment
Hide comment
@inouetakuya

inouetakuya Nov 23, 2016

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

inouetakuya commented Nov 23, 2016

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

@inouetakuya

This comment has been minimized.

Show comment
Hide comment
@inouetakuya

inouetakuya Nov 29, 2016

@ktsn

レビューありがとうございました!大変勉強になりました。

指摘いただいた点の反映が終わりました。また #470, #421, #438 を反映しました(#421 の api.md 変更分を除く)

inouetakuya commented Nov 29, 2016

@ktsn

レビューありがとうございました!大変勉強になりました。

指摘いただいた点の反映が終わりました。また #470, #421, #438 を反映しました(#421 の api.md 変更分を除く)

@kimikimi714

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Nov 29, 2016

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

@kimikimi714

kimikimi714 Nov 29, 2016

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

This comment has been minimized.

@kitak

kitak Nov 30, 2016

Contributor

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

@kitak

kitak Nov 30, 2016

Contributor

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

This comment has been minimized.

@kimikimi714

kimikimi714 Nov 30, 2016

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

@kimikimi714

kimikimi714 Nov 30, 2016

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Nov 29, 2016

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

@kimikimi714

kimikimi714 Nov 29, 2016

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Nov 29, 2016

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

@kimikimi714

kimikimi714 Nov 29, 2016

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

This comment has been minimized.

@kazupon

kazupon Nov 30, 2016

Member

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

@kazupon

kazupon Nov 30, 2016

Member

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

This comment has been minimized.

@kimikimi714

kimikimi714 Nov 30, 2016

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

@kimikimi714

kimikimi714 Nov 30, 2016

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

This comment has been minimized.

@kitak

kitak Nov 30, 2016

Contributor

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

@kitak

kitak Nov 30, 2016

Contributor

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

This comment has been minimized.

@kimikimi714

kimikimi714 Nov 30, 2016

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

@kimikimi714

kimikimi714 Nov 30, 2016

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Nov 30, 2016

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

@kimikimi714

kimikimi714 Nov 30, 2016

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

This comment has been minimized.

@ktsn

ktsn Nov 30, 2016

Member

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

@ktsn

ktsn Nov 30, 2016

Member

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

Show outdated Hide outdated docs/ja/api.md
- 型: `Object`
Vuex store のための ルートステートオブジェクトです。

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

@ktsn

ktsn Dec 1, 2016

Member

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

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

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

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

@ktsn

ktsn Dec 1, 2016

Member

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

Show outdated Hide outdated docs/ja/api.md
``` js
{
state, // store.state と同じか, or モジュール内にあればローカルステート

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

or はとりましょう!

@ktsn

ktsn Dec 1, 2016

Member

or はとりましょう!

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

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

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

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

@ktsn

ktsn Dec 1, 2016

Member

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

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

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

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

アタッチされます

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

@ktsn

ktsn Dec 1, 2016

Member

アタッチされます

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

Show outdated Hide outdated docs/ja/api.md
store.subscribe((mutation, state) => {
console.log(mutation.type)
console.log(mutation.payload)
})

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

@ktsn

ktsn Dec 1, 2016

Member

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

Show outdated Hide outdated docs/ja/api.md
})
```
もっともよく利用されるプラグインです。[詳細](plugins.md)

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

@ktsn

ktsn Dec 1, 2016

Member

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

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

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

@ktsn

ktsn Dec 1, 2016

Member

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

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

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

Create component computed options

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

that return the sub tree of the Vuex store

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

@ktsn

ktsn Dec 1, 2016

Member

Create component computed options

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

that return the sub tree of the Vuex store

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

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

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

@ktsn

ktsn Dec 1, 2016

Member

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

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

@ktsn

ktsn Dec 1, 2016

Member

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

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

Show outdated Hide outdated docs/ja/api.md
``` js
{
state, // store.state と同じか, or モジュール内にあればローカルステート

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

Show outdated Hide outdated docs/ja/api.md
- 型: `Object`
Vuex store のための ルートステートオブジェクトです。

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

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

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 1, 2016

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

@kimikimi714

kimikimi714 Dec 1, 2016

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

Show outdated Hide outdated docs/ja/api.md
```
もっともよく利用されるプラグインです。[詳細](plugins.md)
プラグインの中でももっともよく利用されます。[詳細](plugins.md)

This comment has been minimized.

@ktsn

ktsn Dec 1, 2016

Member

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

@ktsn

ktsn Dec 1, 2016

Member

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

This comment has been minimized.

@kimikimi714

kimikimi714 Dec 2, 2016

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

@kimikimi714

kimikimi714 Dec 2, 2016

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

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

@kitak

This comment has been minimized.

Show comment
Hide comment
@kitak

kitak Dec 4, 2016

Contributor

Could you please merge it?

Contributor

kitak commented Dec 4, 2016

Could you please merge it?

@ktsn

ktsn approved these changes Dec 5, 2016

@ktsn

This comment has been minimized.

Show comment
Hide comment
@ktsn

ktsn Dec 5, 2016

Member

@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.

Member

ktsn commented Dec 5, 2016

@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

This comment has been minimized.

Show comment
Hide comment
@kitak

kitak Dec 5, 2016

Contributor

@ktsn

OK. I've done them.

Contributor

kitak commented Dec 5, 2016

@ktsn

OK. I've done them.

@ktsn

This comment has been minimized.

Show comment
Hide comment
@ktsn

ktsn Dec 5, 2016

Member

Thanks! I'm merging this.

Member

ktsn commented Dec 5, 2016

Thanks! I'm merging this.

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

1 check passed

ci/circleci Your tests passed on CircleCI!
Details
@ktsn

This comment has been minimized.

Show comment
Hide comment
@ktsn
Member

ktsn commented Dec 5, 2016

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment