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

Update ja document #240

Merged
merged 38 commits into from Jul 30, 2016

Conversation

Projects
None yet
5 participants
@kitak
Contributor

kitak commented Jul 6, 2016

TODO

  • What is Vuex?(intro.md) @kitak
  • Getting Started(getting-started.md) @kitak
  • Tutorial(tutorial.md) @ktsn
  • Core Concepts
    • State and Getters(state.md) @kitak
    • Mutations(mutations.md) @kitak
    • Actions(actions.md) @ktsn
  • Data Flow(data-flow.md) @ktsn
  • Application Structure(structure.md) @kitak
  • Plugins(plugins.md) @kitak
  • Strict Mode(strict.md) @kitak
  • Form Handling(forms.md) @ktsn
  • Testing(testing.md) @ktsn
  • Hot Reloading(hot-reload.md) @kitak
  • API Reference(api.md) @kitak
@yyx990803

This comment has been minimized.

Show comment
Hide comment
@yyx990803

yyx990803 Jul 6, 2016

Member

Thanks! Is this for 1.0 or 2.0?

Member

yyx990803 commented Jul 6, 2016

Thanks! Is this for 1.0 or 2.0?

@kitak

This comment has been minimized.

Show comment
Hide comment
@kitak

kitak Jul 6, 2016

Contributor

@yyx990803

This is for 1.0.

Contributor

kitak commented Jul 6, 2016

@yyx990803

This is for 1.0.

@kitak kitak changed the title from [WIP] Update jp document to [WIP] Update ja document Jul 6, 2016

Show outdated Hide outdated docs/ja/SUMMARY.md
- [Vuex とは何か](intro.md)
- [Vuex 入門](getting-started.md)
- [チュートリアル](tutorial.md)
- コアコンセプト
- [ステート](state.md)

This comment has been minimized.

@kazupon

kazupon Jul 6, 2016

Member

英語では、State and Getters となっていますね。

@kazupon

kazupon Jul 6, 2016

Member

英語では、State and Getters となっていますね。

This comment has been minimized.

@kitak

kitak Jul 6, 2016

Contributor

🙇

@kitak

kitak Jul 6, 2016

Contributor

🙇

Show outdated Hide outdated docs/ja/intro.md
大規模アプリケーションで状態を共有させるために優れた対処として**コンポーネントのローカル状態****アプリケーションレベルの状態**を区別する必要があります。アプリケーション状態は特定のコンポーネントに属していませんが、私達のコンポーネントはリアクティブな DOM 更新のためにそれを監視できます。1 つの場所でそれを集中的に管理することによって、あるコンポーネントがそこに属する必要よりも全てに影響を与えるため、もはやイベントあちこちを渡す必要はありません。加えて、私達は、記録と状態変化の理解を容易にするための全ての変異を検査することができ、タイムトラベルデバッグのような派手なものも実装可能です
大規模アプリケーションで状態を共有をより良く対処するために**コンポーネント内部の状態****アプリケーションレベルの状態**を区別する必要があります。アプリケーションレベルの状態状態は特定のコンポーネントに属していませんが、私達のコンポーネントはリアクティブな DOM 更新のためにまだそれを監視することができます。ひとつの場所で一元的にそれを管理することによって、複数のコンポーネントに影響を与えるすべてがそこに属している必要があるので、もはやイベントをあちこちに渡す必要はありません。加えて、全ての変更の記録と検査をおこなうことで、状態変化の理解を容易にし、さらに、タイムトラベルデバッグのようなお洒落な機能も実装できます

This comment has been minimized.

@ktsn

ktsn Jul 6, 2016

Member

「アプリケーションレベルの状態状態」になってます……!

@ktsn

ktsn Jul 6, 2016

Member

「アプリケーションレベルの状態状態」になってます……!

This comment has been minimized.

@kitak

kitak Jul 6, 2016

Contributor

🙇

@kitak

kitak Jul 6, 2016

Contributor

🙇

Show outdated Hide outdated docs/ja/intro.md
Vuex は Vue.js アプリケーションで集中状態管理するためのアプリケーションアーキテクチャです。[Flux](https://facebook.github.io/flux/) や [Redux](https://github.com/rackt/redux) からインスピレーションを得ていますが、 簡易化された概念、そして Vue.js リアクティブシステムの長所を得るために、特別に設計された実装になっています。
Vuex は Vue.js アプリケーションで状態を一元的に管理するためのアプリケーションアーキテクチャです。[Flux](https://facebook.github.io/flux/) や [Redux](https://github.com/rackt/redux) にインスパイアされていますが、 それよりも単純化された概念を持ち、Vue.js のリアクティブシステムの長所を生かすために、特別に設計された実装になっています。

This comment has been minimized.

@hypermkt

hypermkt Jul 6, 2016

  • が、 それよりも
    • それよりの前にある半角スペース1個は消しても良さそうです。
  • 持ち、Vue.js のリアクティブシステムの
    • Vue.jsの先頭には半角スペース1個が必要です。
@hypermkt

hypermkt Jul 6, 2016

  • が、 それよりも
    • それよりの前にある半角スペース1個は消しても良さそうです。
  • 持ち、Vue.js のリアクティブシステムの
    • Vue.jsの先頭には半角スペース1個が必要です。
@kazupon

This comment has been minimized.

Show comment
Hide comment
@kazupon

kazupon Jul 7, 2016

Member

LGTM 👍

Member

kazupon commented on 2823b51 Jul 7, 2016

LGTM 👍

@kazupon

This comment has been minimized.

Show comment
Hide comment
@kazupon

kazupon Jul 7, 2016

Member

LGTM 👍

Member

kazupon commented on 976d647 Jul 7, 2016

LGTM 👍

Show outdated Hide outdated docs/ja/state.md
### Vue コンポーネントにおいて Vuex ステートを取得する
`state` オブジェクトは、Vue インスタンスに渡される `data` オブジェクトに似ており、一度 Vuex store に渡され、[Vue のリアクティブシステム](http://vuejs.org/guide/reactivity.html) によってリアクティブになります。これは、Vue コンポーネントにバインディングする Vuex state は、算出プロパティ (computed property) の中からそれを返すのと同じくらい簡単なことを意味します:
### Vue コンポーネント で Vuex ステート を取得する

This comment has been minimized.

@ktsn

ktsn Jul 8, 2016

Member

「Get X into Y」 で 「X を Y に入れる」なので、すこし意味が違っているように見えますねー。
Vue コンポーネントを_つかって_ Vuex ステートを取得するような印象を受けます。

@ktsn

ktsn Jul 8, 2016

Member

「Get X into Y」 で 「X を Y に入れる」なので、すこし意味が違っているように見えますねー。
Vue コンポーネントを_つかって_ Vuex ステートを取得するような印象を受けます。

This comment has been minimized.

@kitak

kitak Jul 8, 2016

Contributor

「Vuex の状態を Vue コンポーネントに入れる」と修正しました

@kitak

kitak Jul 8, 2016

Contributor

「Vuex の状態を Vue コンポーネントに入れる」と修正しました

Show outdated Hide outdated docs/ja/state.md
})
```
ルートインスタンスに `store` オプションを渡すことで、渡されたストをルートの全ての子コンポーネントに注入します。これは `this.$store` で各コンポーネントから参照することができますが、それを参照する必要があるケースはほとんどありません。

This comment has been minimized.

@ktsn

ktsn Jul 8, 2016

Member

渡されたスト

ストアですかね?

@ktsn

ktsn Jul 8, 2016

Member

渡されたスト

ストアですかね?

This comment has been minimized.

@kitak

kitak Jul 8, 2016

Contributor

🙇

@kitak

kitak Jul 8, 2016

Contributor

🙇

Show outdated Hide outdated docs/ja/state.md
### ゲッター( Getters )を複数のコンポーネントの間で共有する
見ての通り、`filteredMessages` げったーは、複数のコンポーネントで有用そうです。この場合、同じ名前でコンポーネント間で共有するのがよいアイディアです。

This comment has been minimized.

@ktsn

ktsn Jul 8, 2016

Member

s/げったー/ゲッター/ ですね!

@ktsn

ktsn Jul 8, 2016

Member

s/げったー/ゲッター/ ですね!

This comment has been minimized.

@kitak

kitak Jul 8, 2016

Contributor

🙇

@kitak

kitak Jul 8, 2016

Contributor

🙇

### 単純なアクション

This comment has been minimized.

@kazupon

kazupon Jul 9, 2016

Member

非同期という用語は、原文の方では、asynchronous という用語が bold されているので、同じく bold が必要です。

@kazupon

kazupon Jul 9, 2016

Member

非同期という用語は、原文の方では、asynchronous という用語が bold されているので、同じく bold が必要です。

This comment has been minimized.

@ktsn

ktsn Jul 9, 2016

Member

おっと、抜けていましたね。ありがとうございますー。

@ktsn

ktsn Jul 9, 2016

Member

おっと、抜けていましたね。ありがとうございますー。

Show outdated Hide outdated docs/ja/mutations.md
@@ -1,6 +1,6 @@
# ミューテーション
Vuex のミューテーションは基本的にイベントです。各ミューテーションは**名前****ハンドラ**を持ちます。ハンドラ関数は常に全体のステートツリーを第1引数として取得します:
Vuex のミューテーションは本質的にイベントです。各ミューテーションは**名前****ハンドラ**を持ちます。ハンドラ関数は常に Vuex のstateを第1引数として取得します:

This comment has been minimized.

@kazupon

kazupon Jul 10, 2016

Member

日本語訳ガイドラインに沿う場合、state の前後に半角スペースを入れるといいでしょう。

@kazupon

kazupon Jul 10, 2016

Member

日本語訳ガイドラインに沿う場合、state の前後に半角スペースを入れるといいでしょう。

Show outdated Hide outdated docs/ja/mutations.md
直接ミューテーションハンドラ呼び出すことはできません。ここでのオプションは、よりイベント登録のようなものです"`INCREMENT` イベントがディスパッチされるとき、このハンドラは呼ばれます。"ミューテーションハンドラを起動するためには、ミューテーションイベントをディスパッチする必要があります:
直接ミューテーションハンドラを呼び出すことはできません。このmutationsオプションは、よりイベント登録のようなものです: "`INCREMENT` イベントがディスパッチされるとき、このハンドラが呼ばれる" ミューテーションハンドラを起動するためには、ミューテーションイベントをディスパッチする必要があります:

This comment has been minimized.

@kazupon

kazupon Jul 10, 2016

Member

ここの mutations も半角スペース前後に入れるとよいと思います。

@kazupon

kazupon Jul 10, 2016

Member

ここの mutations も半角スペース前後に入れるとよいと思います。

Show outdated Hide outdated docs/ja/mutations.md
場合によっては、プラグインに状態の変化を記録して欲しくないかもしれません。あるいは、短い間隔、ポーリングでのストアへの複数のディスパッチも、常に追跡する必要はないでしょう。これらの状況では、ミューテーションを沈黙( silence )させることが適切であると考えることができます。
Note: サイレントディスパッチは可能な限り避けるべきです。サイレントミューテーションは、開発ツールの全ての状態の変更を追跡するという規約を壊します。絶対に必要だという状況で控えめに使用してください。

This comment has been minimized.

@kazupon

kazupon Jul 10, 2016

Member

Note: の訳は、注意: でよい気がします。

@kazupon

kazupon Jul 10, 2016

Member

Note: の訳は、注意: でよい気がします。

Show outdated Hide outdated docs/ja/structure.md
2. ミューテーションハンドラだけステートを変異できます
3. ミューテーションは同期でなければなく、そしてそれらを作成するだけの副作用はミューテーションとステートになるべきです
4. データフェッチングのような全ての非同期ロジックはアクションで実行されるべきです
1. アプリケーションステートは単一オブジェクトとして、ストアで保持されます

This comment has been minimized.

@kazupon

kazupon Jul 12, 2016

Member

次の項目2.state の訳状態とでてきているのですが、それに合わせると、アプリケーションステートではなく、アプリケーションの状態の方が、ドキュメント読んでいて違和感が無いような気がしました。

@kazupon

kazupon Jul 12, 2016

Member

次の項目2.state の訳状態とでてきているのですが、それに合わせると、アプリケーションステートではなく、アプリケーションの状態の方が、ドキュメント読んでいて違和感が無いような気がしました。

This comment has been minimized.

@kitak

kitak Jul 12, 2016

Contributor

たしかにそうですね。アプリケーションステートに統一します。

@kitak

kitak Jul 12, 2016

Contributor

たしかにそうですね。アプリケーションステートに統一します。

Show outdated Hide outdated docs/ja/structure.md
``` js
// コンポーネントで...
import { filteredTodos } from './getters'
代わりに、常にサブツリーのルートののプロパティとして、実際の状態を保存します。

This comment has been minimized.

@ktsn

ktsn Jul 12, 2016

Member

「のの」になってます。

@ktsn

ktsn Jul 12, 2016

Member

「のの」になってます。

This comment has been minimized.

@kitak

kitak Jul 12, 2016

Contributor

🙇

@kitak

kitak Jul 12, 2016

Contributor

🙇

@kazupon

This comment has been minimized.

Show comment
Hide comment
@kazupon

kazupon Jul 12, 2016

Member

'createPlugin'のタイポ、見つけました。👀

'createPlugin'のタイポ、見つけました。👀

Show outdated Hide outdated docs/ja/hot-reload.md
新しいアクションとミューテーションによって `store.hotUpdate()` として呼び出すのと同じくらい簡単です:
ミューテーションとモジュールに対して、`store.hotUpdate()` API method を利用する必要があります:

This comment has been minimized.

@kazupon

kazupon Jul 14, 2016

Member

"API store.hotUpdate() メソッド"とかどうでしょう?

@kazupon

kazupon Jul 14, 2016

Member

"API store.hotUpdate() メソッド"とかどうでしょう?

This comment has been minimized.

@kitak

kitak Jul 16, 2016

Contributor

🙆

@kitak

kitak Jul 16, 2016

Contributor

🙆

@kazupon

This comment has been minimized.

Show comment
Hide comment
@kazupon

kazupon Jul 16, 2016

Member

@kitak @ktsn
great works!!

Member

kazupon commented Jul 16, 2016

@kitak @ktsn
great works!!

@kitak kitak changed the title from [WIP] Update ja document to Update ja document Jul 17, 2016

@kitak

This comment has been minimized.

Show comment
Hide comment
@kitak

kitak Jul 17, 2016

Contributor

@yyx990803

We have finished translation.

Contributor

kitak commented Jul 17, 2016

@yyx990803

We have finished translation.

@kitak

This comment has been minimized.

Show comment
Hide comment
@kitak

kitak Jul 20, 2016

Contributor

@yyx990803

Please merge this branch.

Contributor

kitak commented Jul 20, 2016

@yyx990803

Please merge this branch.

@yyx990803

This comment has been minimized.

Show comment
Hide comment
@yyx990803

yyx990803 Jul 30, 2016

Member

@kitak sorry, have been ignoring this email chain because there was a lot of WIP noise, just noticed it's done!

Member

yyx990803 commented Jul 30, 2016

@kitak sorry, have been ignoring this email chain because there was a lot of WIP noise, just noticed it's done!

@yyx990803 yyx990803 merged commit 5048db7 into vuejs:master Jul 30, 2016

1 check passed

ci/circleci Your tests passed on CircleCI!
Details

jaychsu added a commit to jaychsu/vuex that referenced this pull request Sep 7, 2016

Merge remote-tracking branch 'upstream/master'
* upstream/master: (52 commits)
  Update ja document (#240)
  small word correction (#257)
  Modify type files to external module definition format to publish them via npm (#242)
  update docs for 1.0-rc.2
  Fix typo of docs (#238)
  [release] 1.0.0-rc.2
  [build] 1.0.0-rc.2
  improve type test for subscribe
  update type definition for subscribe
  store.on(mutation) -> store.subscribe
  Update types for nested modules (#235)
  update plugins doc
  [release] 1.0.0-rc
  [build] 1.0.0-rc
  ignore explorations
  Update declaration (#218)
  add renamed logger
  include events methods in api reference
  expose replaceState()
  docs
  ...

@kitak kitak deleted the kitak:update-jp-doc branch Oct 29, 2016

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