From 872fe87605af068d85f5322576c600441659bec6 Mon Sep 17 00:00:00 2001
From: kazuya kawaguchi <kawakazu80@gmail.com>
Date: Fri, 24 Mar 2017 21:44:07 +0900
Subject: [PATCH 1/3] pick up from #664

---
 docs/ja/configurations/custom-blocks.md | 70 ++++++++++++++++++++++++-
 docs/ja/start/spec.md                   |  7 +++
 2 files changed, 75 insertions(+), 2 deletions(-)

diff --git a/docs/ja/configurations/custom-blocks.md b/docs/ja/configurations/custom-blocks.md
index a9d41d00c..e4caef2c3 100644
--- a/docs/ja/configurations/custom-blocks.md
+++ b/docs/ja/configurations/custom-blocks.md
@@ -4,9 +4,9 @@
 
 `*.vue` ファイル内にカスタム言語ブロックを定義することが出来ます。カスタムブロックの内容は `vue-loader` のオブジェクトで指定された loader によって処理され、次にコンポーネントモジュールによって要求されます。この設定は `lang` 属性の代わりにタグ名を使用する点をのぞいて[高度な loader の設定](../configurations/advanced.md)に記載されたものと似ています。
 
-もしカスタムブロックにマッチする loader を見つけたら、それは処理されます。でなければそのカスタムブロックは単に無視されます。
+もしカスタムブロックにマッチする loader を見つけたら、それは処理されます。でなければそのカスタムブロックは単に無視されます。Additionally, if the found loader returns a function, that function will be called with the component of the *.vue file as a parameter.
 
-## 例
+## Single docs file example
 
 全ての `<docs>` カスタムブロックを一つのドキュメントファイルに展開する例を示します：
 
@@ -65,3 +65,69 @@ module.exports = {
   ]
 }
 ```
+
+## Runtime available docs
+
+Here's an example of injecting the `<docs>` custom blocks into the component so that it's available during runtime.
+
+#### docs-loader.js 
+
+In order for the custom block content to be injected, we'll need a custom loader: 
+
+``` js
+module.exports = function (source, map) {
+  this.callback(null, 'module.exports = function(Component) {Component.options.__docs = ' +
+    JSON.stringify(source) +
+    '}', map)
+}
+```
+
+#### webpack.config.js
+
+Now we'll configure webpack to use our custom loader for `<docs>` custom blocks.
+
+``` js
+const docsLoader = require.resolve('./custom-loaders/docs-loader.js')
+
+module.exports = {
+  module: {
+    rules: [
+      {
+        test: /\.vue$/,
+        loader: 'vue',
+        options: {
+          loaders: {
+            'docs': docsLoader
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+#### component.vue
+
+We are now able to access the `<docs>` block's content of imported components during runtime. 
+
+``` html
+<template>
+  <div>
+    <component-b />
+    <p>{{ docs }}</p>
+  </div>
+</template>
+
+<script>
+import componentB from 'componentB';
+
+export default = {
+  data () {
+    return {
+      docs: componentB.__docs
+    }
+  },
+  components: {componentB}
+}
+</script>
+```
diff --git a/docs/ja/start/spec.md b/docs/ja/start/spec.md
index cc27296a8..7cc2eda72 100644
--- a/docs/ja/start/spec.md
+++ b/docs/ja/start/spec.md
@@ -94,6 +94,13 @@ export default {
 <style src="todomvc-app-css/index.css">
 ```
 
+`src` imports also work with custom blocks, e.g.:
+
+``` html
+<unit-test src="./unit-test.js">
+</unit-test>
+```
+
 ### シンタックスハイライト
 
 現在それらはシンタクスハイライトをサポートしているのは、[Sublime Text](https://github.com/vuejs/vue-syntax-highlight), [Atom](https://atom.io/packages/language-vue), [Vim](https://github.com/posva/vim-vue), [Visual Studio Code](https://marketplace.visualstudio.com/items/liuji-jim.vue), [Brackets](https://github.com/pandao/brackets-vue), [JetBrains products](https://plugins.jetbrains.com/plugin/8057) (WebStorm, PhpStorm, etc). 他のエディタ/IDEへのコントリビュートは高く評価されます！もし Vue コンポーネント内でプリプロセッサを使用していない場合は、エディタで `*.vue` ファイルを HTML として扱うことが出来ます。

From b388e3c0a6d9fe1c839585764d6762988d85a151 Mon Sep 17 00:00:00 2001
From: kazuya kawaguchi <kawakazu80@gmail.com>
Date: Fri, 24 Mar 2017 21:53:25 +0900
Subject: [PATCH 2/3] translate #664

---
 docs/ja/configurations/custom-blocks.md | 14 +++++++-------
 docs/ja/start/spec.md                   |  2 +-
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/ja/configurations/custom-blocks.md b/docs/ja/configurations/custom-blocks.md
index e4caef2c3..c79e7f695 100644
--- a/docs/ja/configurations/custom-blocks.md
+++ b/docs/ja/configurations/custom-blocks.md
@@ -4,9 +4,9 @@
 
 `*.vue` ファイル内にカスタム言語ブロックを定義することが出来ます。カスタムブロックの内容は `vue-loader` のオブジェクトで指定された loader によって処理され、次にコンポーネントモジュールによって要求されます。この設定は `lang` 属性の代わりにタグ名を使用する点をのぞいて[高度な loader の設定](../configurations/advanced.md)に記載されたものと似ています。
 
-もしカスタムブロックにマッチする loader を見つけたら、それは処理されます。でなければそのカスタムブロックは単に無視されます。Additionally, if the found loader returns a function, that function will be called with the component of the *.vue file as a parameter.
+もしカスタムブロックにマッチする loader を見つけたら、それは処理されます。でなければそのカスタムブロックは単に無視されます。加えて、見つかった loader が関数を返す場合は、その関数は `*.vue` ファイルのコンポーネントをパラメータとして呼び出します。
 
-## Single docs file example
+## 単一ドキュメントファイルの例
 
 全ての `<docs>` カスタムブロックを一つのドキュメントファイルに展開する例を示します：
 
@@ -66,13 +66,13 @@ module.exports = {
 }
 ```
 
-## Runtime available docs
+## 実行可能なドキュメント
 
-Here's an example of injecting the `<docs>` custom blocks into the component so that it's available during runtime.
+`<docs>`カスタムブロックをコンポーネントに注入して実行時に利用できるようにする例です。
 
 #### docs-loader.js 
 
-In order for the custom block content to be injected, we'll need a custom loader: 
+カスタムブロックコンテンツを注入するためには、カスタム loader が必要です:
 
 ``` js
 module.exports = function (source, map) {
@@ -84,7 +84,7 @@ module.exports = function (source, map) {
 
 #### webpack.config.js
 
-Now we'll configure webpack to use our custom loader for `<docs>` custom blocks.
+次に、`<docs>` カスタムブロック用のカスタム loader を使用するように webpack を設定します。
 
 ``` js
 const docsLoader = require.resolve('./custom-loaders/docs-loader.js')
@@ -108,7 +108,7 @@ module.exports = {
 
 #### component.vue
 
-We are now able to access the `<docs>` block's content of imported components during runtime. 
+実行時にインポートされたコンポーネントの `<docs>` ブロックの内容にアクセスできるようになりました。
 
 ``` html
 <template>
diff --git a/docs/ja/start/spec.md b/docs/ja/start/spec.md
index 7cc2eda72..8bca22041 100644
--- a/docs/ja/start/spec.md
+++ b/docs/ja/start/spec.md
@@ -94,7 +94,7 @@ export default {
 <style src="todomvc-app-css/index.css">
 ```
 
-`src` imports also work with custom blocks, e.g.:
+`src` によるインポートはカスタムブロックでも動作します、例:
 
 ``` html
 <unit-test src="./unit-test.js">

From a8bc87e418c689c1dd071010436dfdb0fbf413ea Mon Sep 17 00:00:00 2001
From: kazuya kawaguchi <kawakazu80@gmail.com>
Date: Sat, 25 Mar 2017 00:16:55 +0900
Subject: [PATCH 3/3] improve title

from review comment: https://github.com/vuejs/vue-loader/pull/737#discussion_r107923846
---
 docs/ja/configurations/custom-blocks.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ja/configurations/custom-blocks.md b/docs/ja/configurations/custom-blocks.md
index c79e7f695..9b56edba1 100644
--- a/docs/ja/configurations/custom-blocks.md
+++ b/docs/ja/configurations/custom-blocks.md
@@ -66,7 +66,7 @@ module.exports = {
 }
 ```
 
-## 実行可能なドキュメント
+## 実行時に利用可能なドキュメント
 
 `<docs>`カスタムブロックをコンポーネントに注入して実行時に利用できるようにする例です。