Merge pull request electron#4291 from yamatoya/master

📝 Update as upstream

Author: zcbenz

docs-translations/jp/api/app.md

@@ -431,6 +431,12 @@ dock アイコンを表示します。
 
 アプリケーションの[dock menu][dock-menu]を設定します。
 
+### `app.dock.setIcon(image)` _OS X_
+
+* `image` [NativeImage](native-image.md)
+
+dock アイコンに紐づいた`image`を設定します。
+
 [dock-menu]:https://developer.apple.com/library/mac/documentation/Carbon/Conceptual/customizing_docktile/concepts/dockconcepts.html#//apple_ref/doc/uid/TP30000986-CH2-TPXREF103
 [tasks]:http://msdn.microsoft.com/en-us/library/windows/desktop/dd378460(v=vs.85).aspx#tasks
 [app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx

docs-translations/jp/api/environment-variables.md

@@ -24,6 +24,11 @@ Windows コンソール上:
 
 Chromeのインターナルログをコンソールに出力します。
 
+
+## `ELECTRON_LOG_ASAR_READS`
+
+ASARファイルからElectronが読み込んだとき、システム`tmpdir`へ読み込みオフセットとファイルのパスを記録します。ファイルの順序を最適化するために、得られたファイルはASARモジュールに提供されます。
+
 ## `ELECTRON_ENABLE_STACK_DUMPING`
 
 Electronがクラッシュしたとき、コンソールにスタックとレースを出力します。

docs-translations/jp/api/protocol.md

@@ -45,9 +45,22 @@ app.on('ready', function() {
 
 レスポンスとしてファイルを送信する`scheme`のプロトコルを登録します。`scheme`で`request`が生成された時、`handler`は`handler(request, callback)`で呼び出されます。`scheme` 登録が成功したり、`completion(error)`が失敗したときに、`completion` は`completion(null)`で呼び出されます。
 
+* `request` Object
+  * `url` String
+  * `referrer` String
+  * `method` String
+  * `uploadData` Array (オプション)
+* `callback` Function
+
+`uploadData` は `data` オブジェクトの配列です:
+
+* `data` Object
+  * `bytes` Buffer - 送信するコンテンツ
+  * `file` String - アップロードするファイルパス
+
 `request`をハンドルするために、`callback`はファイルパスまたは`path`プロパティを持つオブジェクトで呼び出すべきです。例えば、`callback(filePath)` または`callback({path: filePath})`です。
 
-何もなし、数字、`error`プロパティを持つオブジェクトで、`callback`が呼び出された時、 `request`は指定した`error`番号で失敗します。使用できる提供されているエラー番号は、[net error list](https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h)を参照してください。
+何もなし、数字、`error`プロパティを持つオブジェクトで、`callback`が呼び出された時、 `request`は指定した`error`番号で失敗します。使用できる提供されているエラー番号は、[net error list][net-error]を参照してください。
 
 既定では、`scheme`は、`file:`のような一般的なURIの構文に続くプロトコルと違う解析がされ、`http:`のように扱われます。なので、恐らく標準的なスキーマーのように扱われるスキーマーを持つために、`protocol.registerStandardSchemes` を呼び出したくなります。
 
@@ -57,7 +70,9 @@ app.on('ready', function() {
 * `handler` Function
 * `completion` Function (optional)
 
-レスポンスとして`Buffer`を送信する`scheme`プロトコルを登録します。`callback`は、`Buffer`オブジェクトまたは`data`と `mimeType`、`chart`プロパティを持つオブジェクトを呼び出す必要があります。
+レスポンスとして`Buffer`を送信する`scheme`プロトコルを登録します。
+
+ `callback`は、`Buffer`オブジェクトまたは、`data`と`mimeType`、 `charset`プロパティを持つオブジェクトのどちらかで呼ばれる必要があることを除いて、この使用方法は、`registerFileProtocol`と同じです。
 
 例:
 
@@ -76,22 +91,32 @@ protocol.registerBufferProtocol('atom', function(request, callback) {
 * `handler` Function
 * `completion` Function (optional)
 
-レスポンスとして`String`を送信する`scheme`プロトコルを登録します。`callback`は、`String`または`data`と `mimeType`、`chart`プロパティを持つオブジェクトを呼び出す必要があります。
+レスポンスとして`String`を送信する`scheme`プロトコルを登録します。
+
+`callback`は、`String`または`data`と `mimeType`、`chart`プロパティを持つオブジェクトを呼び出す必要があることを除いて、使用方法は`registerFileProtocol`と同じです。
 
 ### `protocol.registerHttpProtocol(scheme, handler[, completion])`
 
 * `scheme` String
 * `handler` Function
 * `completion` Function (optional)
 
-レスポンスとしてHTTPリクエストを送信する`scheme`プロトコルを登録します。`callback`は、`url`と`method`、`referrer`、`uploadData`、`session`プロパティを持つオブジェクトを呼び出す必要があります。
+レスポンスとしてHTTPリクエストを送信する`scheme`プロトコルを登録します。
+
+`callback`は、`url`と`method`、`referrer`、`uploadData`、`session`プロパティを持つオブジェクトを呼び出す必要があることを除いて、使用方法は`registerFileProtocol`と同じです。
+
+* `redirectRequest` Object
+  * `url` String
+  * `method` String
+  * `session` Object (オプション)
+  * `uploadData` Object (オプション)
 
 既定では、HTTPリクエストは現在のセッションを再利用します。別のセッションでリクエストをしたい場合、`session` に `null`を設定する必要があります。
 
 POSTリクエストは`uploadData`オブジェクトを提供する必要があります。
 * `uploadData` object
   * `contentType` String - コンテンツのMIMEタイプ
-  *  `data` String - 送信されるコンテンツ
+  * `data` String - 送信されるコンテンツ
 
 ### `protocol.unregisterProtocol(scheme[, completion])`
 
@@ -139,12 +164,12 @@ POSTリクエストは`uploadData`オブジェクトを提供する必要があ
 
 `scheme`プロトコルをインターセプタ―し、レスポンスとして新しいHTTPリクエストを送信するプロトコルの新しいハンドラーとして`handler`を使います。
 
-Intercepts `scheme` protocol and uses `handler` as the protocol's new handler
-which sends a new HTTP request as a response.
-
 ### `protocol.uninterceptProtocol(scheme[, completion])`
 
 * `scheme` String
 * `completion` Function
 
 インターセプタ―したインストールされた`scheme`を削除し、オリジナルハンドラーをリストアします。
+
+
+[net-error]: https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h

docs-translations/jp/api/session.md

@@ -197,6 +197,7 @@ proxyURL = [<proxyScheme>"://"]<proxyHost>[":"<proxyPort>]
 ```
 
 具体例:
+
 * `http=foopy:80;ftp=foopy2` - `http://`URLは`foopy:80`HTTPプロキシを使用し、`ftp://`URLは`foopy2:80` HTTPプロキシを使用します。
 * `foopy:80` - 全てのURLで`foopy:80`を使用します。
 * `foopy:80,bar,direct://` - 全てのURLで`foopy:80`HTTPプロキシを使用し、`foopy:80`が提供されていなければ`bar`を使用し、さらに使えない場合はプロキシを使いません。
@@ -296,6 +297,14 @@ session.defaultSession.webRequest.onBeforeSendHeaders(filter, function(details,
   * `method` String
   * `resourceType` String
   * `timestamp` Double
+  * `uploadData` Array (オプション)
+  * `callback` Function
+
+`uploadData`は `data`オブジェクトの配列です。
+
+* `data` Object
+  * `bytes` Buffer - 送信されるコンテンツ
+  * `file` String - アップロードされるファイルパス
 
 `callback`は`response`オブジェクトでコールされる必要があります:
 
@@ -317,6 +326,7 @@ session.defaultSession.webRequest.onBeforeSendHeaders(filter, function(details,
   * `resourceType` String
   * `timestamp` Double
   * `requestHeaders` Object
+* `callback` Function
 
 The `callback` has to be called with an `response` object:
 
@@ -355,6 +365,7 @@ The `callback` has to be called with an `response` object:
   * `statusLine` String
   * `statusCode` Integer
   * `responseHeaders` Object
+* `callback` Function
 
 `callback`は`response`オブジェクトでコールされる必要があります:
 

docs-translations/jp/api/synopsis.md

@@ -4,7 +4,7 @@ Electron では全ての [Node.js のビルトインモジュール](http://node
 
 Electron はネイティブのデスクトップアプリケーション開発のための幾つかの追加のビルトインモジュールも提供しています。メインプロセスでだけ使えるモジュールもあれば、レンダラプロセス(ウェブページ)でだけ使えるモジュール、あるいはメインプロセス、レンダラプロセスどちらでも使えるモジュールもあります。
 
-基本的なルールは：[GUI][gui]、または低レベルのシステムに関連するモジュールはメインモジュールでだけ利用できるべきです。これらのモジュールを使用できるようにするためには [メインプロセス対レンダラプロセス][main-process] スクリプトの概念を理解する必要があります。 
+基本的なルールは：[GUI][gui]、または低レベルのシステムに関連するモジュールはメインモジュールでだけ利用できるべきです。これらのモジュールを使用できるようにするためには [メインプロセス対レンダラプロセス](../tutorial/quick-start.md#メインプロセス)スクリプトの概念を理解する必要があります。
 
 メインプロセススクリプトは普通の Node.js スクリプトのようなものです：
 
@@ -64,6 +64,5 @@ require('electron').hideInternalModules()
 ```
 
 [gui]: https://en.wikipedia.org/wiki/Graphical_user_interface
-[main-process]: ../tutorial/quick-start.md#メインプロセス
 [desctructuring-assignment]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment
 [issue-387]: https://github.com/atom/electron/issues/387

docs-translations/jp/faq/electron-faq.md

@@ -69,5 +69,38 @@ delete window.module;
 </head>
 ```
 
+## `require('electron').xxx` は定義されていません。
+
+Electronの組み込みモジュールを使うとに、次のようなエラーに遭遇するかもしれません。
+
+```
+> require('electron').webFrame.setZoomFactor(1.0);
+Uncaught TypeError: Cannot read property 'setZoomLevel' of undefined
+```
+
+これは、ローカルまたはグローバルのどちらかで [npm `electron` module][electron-module] をインストールしたことが原因で、Electronの組み込みモジュールを上書きしてしまいます。
+
+正しい組み込みモジュールを使用しているかを確認するために、`electron`モジュールのパスを出力します。
+
+```javascript
+console.log(require.resolve('electron'));
+```
+
+そして、次の形式かどうかを確認します。
+
+```
+"/path/to/Electron.app/Contents/Resources/atom.asar/renderer/api/lib/exports/electron.js"
+```
+
+If it is something like もし、`node_modules/electron/index.js`　のような形式の場合は、npm `electron` モジュールを削除するか、それをリネームします。
+
+```bash
+npm uninstall electron
+npm uninstall -g electron
+```
+
+しかし、組み込みモジュールを使用しているのに、まだこのエラーが出る場合、不適切なプロセスでモジュールを使用しようとしている可能性が高いです。例えば、`electron.app`はメインプロセスのみで使え、一方で`electron.webFrame`はレンダラープロセスのみに提供されています。
+
 [memory-management]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_Management
 [variable-scope]: https://msdn.microsoft.com/library/bzt2dkta(v=vs.94).aspx
+[electron-module]: https://www.npmjs.com/package/electron

docs-translations/jp/tutorial/debugging-main-process.md

@@ -55,13 +55,13 @@ $ electron --debug=5858 your/app
 $ electron --debug-brk=5858 your/app
 ```
 
-### 5. Electronを使用して、[node-inspector][node-inspector] サーバーを開始する
+### 6. Electronを使用して、[node-inspector][node-inspector] サーバーを開始する
 
 ```bash
 $ ELECTRON_RUN_AS_NODE=true path/to/electron.exe node_modules/node-inspector/bin/inspector.js
 ```
 
-### 6. デバッグUIを読み込みます
+### 7. デバッグUIを読み込みます
 
 Chromeブラウザで、 http://127.0.0.1:8080/debug?ws=127.0.0.1:8080&port=5858 を開きます。エントリーラインを見るために、debug-brkを始めるには、ポーズをクリックします。
 

docs-translations/jp/tutorial/desktop-environment-integration.md

@@ -25,16 +25,7 @@ myNotification.onclick = function () {
 * Windows 10では、通知はすぐに動作します。
 * Windows 8.1 と Windows 8では、[Application User
 Model ID][app-user-model-id]で、アプリへのショートカットはスタートメニューにインストールされます。しかし、スタートメニューにピン止めをする必要がありません。
-* Windows 7以前は、通知はサポートされていません。 しかし、[Tray API](tray-balloon)を使用してバルーンヒントを送信することができます。
-
-通知にイメージを使うために、通知オプションの `icon` プロパティにローカルのイメージファイル（`png`が望ましい）を設定します。 正しくない、または`http/https`の URLを設定した場合でも、通知は表示されますが、イメージは表示されません。
-
-```javascript
-new Notification('Title', {
-  body: 'Notification with icon',
-  icon: 'file:///C:/Users/feriese/Desktop/icon.png'
-});
-```
+* Windows 7以前は、通知はサポートされていません。 しかし、[Tray API][tray-balloon]を使用してバルーンヒントを送信することができます。
 
 その上で、bodyの最大サイズは250文字であることに留意してください。Windowsチームは、通知は200文字にすることを推奨しています。