Merge pull request #111 from kazupon/translate_docs_ja

Translate docs for ja

Author: yyx990803

docs/LANGS.md

@@ -0,0 +1 @@
+* [日本語](ja/)

docs/ja/README.md

@@ -0,0 +1 @@
+SUMMARY.md

docs/ja/SUMMARY.md

@@ -0,0 +1,29 @@
+# vue-router ドキュメンテーション [![npm package](https://img.shields.io/npm/v/vue-router.svg)](https://www.npmjs.com/package/vue-router)
+
+- [インストール](installation.md)
+- [基本的な使い方](basic.md)
+- [Nested Routes](nested.md)
+- [Route オブジェクト & Route マッチング](route.md)
+- [Router オプション](options.md)
+- [router-view](view.md)
+- [v-link](link.md)
+- [トランジションパイプライン](pipeline/README.md)
+  - [トランジションフック](pipeline/hooks.md)
+  - [data](pipeline/data.md)
+  - [activate](pipeline/activate.md)
+  - [deactivate](pipeline/deactivate.md)
+  - [canActivate](pipeline/can-activate.md)
+  - [canDeactivate](pipeline/can-deactivate.md)
+  - [canReuse](pipeline/can-reuse.md)
+- [API リファレンス](api/README.md)
+  - [Router インスタンスプロパティ](api/properties.md)
+  - [router.start](api/start.md)
+  - [router.stop](api/stop.md)
+  - [router.map](api/map.md)
+  - [router.on](api/on.md)
+  - [router.go](api/go.md)
+  - [router.replace](api/replace.md)
+  - [router.redirect](api/redirect.md)
+  - [router.alias](api/alias.md)
+  - [router.beforeEach](api/before-each.md)
+  - [router.afterEach](api/after-each.md)

docs/ja/api/README.md

@@ -0,0 +1,13 @@
+# API リファレンス
+
+- [Router インスタンスプロパティ](properties.md)
+- [router.start](start.md)
+- [router.stop](stop.md)
+- [router.map](map.md)
+- [router.on](on.md)
+- [router.go](go.md)
+- [router.replace](replace.md)
+- [router.redirect](redirect.md)
+- [router.alias](alias.md)
+- [router.beforeEach](before-each.md)
+- [router.afterEach](after-each.md)

docs/ja/api/after-each.md

@@ -0,0 +1,21 @@
+# `router.afterEach(hook)`
+
+route トランジションが正常に**活性化フェーズに入る**とき、毎回呼び出されるグローバルアフターフック (global after hook) を設定します。
+
+このフックが唯一トランジションが検証されたという意味を表すときに、呼ぼれるのを注意してください。すなわち、全ての `canDeactivate` と `canActivate` フックが正常に解決し、ブラウザ URL　が更新されます。これは、全ての `activate` フックが解決されたことを保証しません。
+
+一度フックする前の唯一のグローバルです。しかしながら、このフック内部であなた自身のミドルウェアシステムを実装することができます。
+
+### 引数
+
+- `hook {Function}`
+
+  hook 関数は[トランジションオブジェクト](../pipeline/hooks.html#transition-object)な単一の引数を受信します。しかし、route オブジェクトは `to` と `from` プロパティ のみだけアクセスすることができます。フック後、グローバルではトランジションメソッドを呼び出すことは**できません**。
+
+### 例
+
+``` js
+router.afterEach(function (transition) {
+  console.log('Successfully navigated to: ' + transition.to.path)
+})
+```

docs/ja/api/alias.md

@@ -0,0 +1,25 @@
+# `router.alias(aliasMap)`
+
+ルーターに対してグローバルエイリアスのルールを設定します。エイリアスとリダイレクトとの違いは、リダイレクトは `toPath` で `fromPath` を置換する代わり、エイリアスは `toPath` としてマッチしている限り、`fromPath` を維持します。
+
+例えば、`/a` を `/a/b/c` にエイリアスする場合、`/a` にアクセスするとき、ブラウザ URL は `/a` を表示します。しかしながら、ルーターは代わりに `/a/b/c` にアクセスするかのようなパスをマッチします。
+
+### 引数
+
+- `aliasMap {Object}`
+
+  エイリアスマップオブジェクトは `{ fromPath: toPath, ... }` の形にする必要があります。パスは動的セグメントを含むことができます。
+
+### 例
+
+``` js
+router.alias({
+
+  // /a/b/c であるかのように /a にマッチします
+  '/a': '/a/b/c',
+
+  // エイリアスは動的セグメント名がマッチする必要がある
+  // 動的セグメントを含むことができます
+  '/user/:userId': '/user/profile/:userId'
+})
+```

docs/ja/api/before-each.md

@@ -0,0 +1,38 @@
+# `router.beforeEach(hook)`
+
+全ての route トランジションが開始する前に呼ばれるグローバルビフォーフック (global before hook) を設定します。これは、トランジションパイプライン全体の前で、もし、フックがトランジションで拒否する場合、パイプラインは本当に開始されません。
+
+一度フックする前の唯一のグローバルであることに注意してください。しかしながら、このフック内部であなた自身のミドルウェアシステムを実装することができます。
+
+### 引数
+
+- `hook {Function}`
+
+  hook 関数は[トランジションオブジェクト](../pipeline/hooks.html#transition-object)な単一の引数を受信します。
+
+### 例
+
+基本
+
+``` js
+router.beforeEach(function (transition) {
+  if (transition.to.path === '/forbidden') {
+    transition.abort()
+  } else {
+    transition.next()
+  }
+})
+```
+
+Promise + ES6
+
+``` js
+router.beforeEach(function ({ to, next }) {
+  if (to.path === '/auth-required') {
+    // true または false で解決する Promise を返します
+    return AuthService.isLoggedIn()
+  } else {
+    next()
+  }
+})
+```

docs/ja/api/go.md

@@ -0,0 +1,9 @@
+# `router.go(path)`
+
+プログラム的に新しい route にナビゲートします。
+
+### 引数
+
+- `path: String`
+
+  パスは純粋なパスの必要があります(すなわち、動的セグメントではない、またはスターセグメント)。パスは `/` で開始されず、現在のアクティブなパスの相対パスで解決されます。

docs/ja/api/map.md

@@ -0,0 +1,47 @@
+# `router.map(routeMap)`
+
+主に、ルーターに対して route マッピングを定義するメソッドです。
+
+### 引数
+
+- `routeMap: Object`
+
+  キーはパスで、値は route 設定オブジェクトです。パスのマッチングルールは、[Route マッチング](../route.html#route-matching)を参照してください。
+
+### Route 設定オブジェクト
+
+route 設定オブジェクトは2つのフィールドを含むことができます:
+
+- `component`: パスがマッチされるときにトップレベルの `<router-view>` outlet にレンダリングする Vue コンポーネント。値は `Vue.extend` の呼び出しによって返されたコンストラクタ、または純粋なコンポーネントオプションオブジェクトのいずれか可能です。後者の場合はルーターが暗黙的に `Vue.extend` を呼び出します。
+
+- `subRoutes`: ここには他のサブ route マップをネストすることができます。`routeRoutes` マップ内の各サブパスついて、ルーターは親パスを追加することによって完全なパスに対してマッチします。マッチしたコンポーネントは親の route コンポーネントの `<router-view>` outlet にレンダリングされます。
+
+### 例
+
+``` js
+router.map({
+  // コンポーネントコンストラクタ
+  '/a': {
+    component: Vue.extend({ /* ... */ })
+  },
+  // 純粋なコンポーネントオプションオブジェクト
+  '/b': {
+    component: {
+      template: '<p>Hello from /b</p>'
+    }
+  },
+  // nested routes
+  '/c': {
+    component: {
+      // 単純に子の view をレンダリング
+      template: '<router-view></router-view>'
+    },
+    subRoutes: {
+      // パスが /c/d であるときにレンダリング
+      '/d': { component: { template: 'D' }},
+      // パスが /c/e であるときにレンダリング
+      '/e': { component: { template: 'E' }}
+    }
+  }
+})
+```

docs/ja/api/on.md

@@ -0,0 +1,18 @@
+# `router.on(path, config)`
+
+単一の root レベルの route 設定を追加します。内部的に、`router.map()` は単に 受信したルーターマップオブジェクトで各 key-value ペアに対して `router.on()` を呼びます。
+
+### 引数
+
+- `path: String` - [Route マッチング](../route.md#route-matching)を参照してください。
+- `config: Object` - [Route 設定オブジェクト](map.md#route-config-object)を参照してください。
+
+### 例
+
+``` js
+router.on('/user/:userId', {
+  component: {
+    template: '<div>{{$route.params.userId}}</div>'
+  }
+})
+```