Merge pull request electron#4146 from yamatoya/master

zcbenz · zcbenz · commit af3def91f210 · 2016-01-19T12:12:41.000-08:00
Add Japanes translated docs.
diff --git a/docs-translations/jp/api/clipboard.md b/docs-translations/jp/api/clipboard.md
@@ -0,0 +1,103 @@
+# clipboard
+
+`clipboard`モジュールは、コピーとペースト操作を実行するメソッドを提供します。次の例は、クリップボードに文字列を書き込む方法を示しています：
+
+```javascript
+const clipboard = require('electron').clipboard;
+clipboard.writeText('Example String');
+```
+
+X Windowsシステム上では、セレクションクリップボードがあります。それを操作するために、それぞれのメソッドで、`selection`を通す必要があります。
+
+```javascript
+clipboard.writeText('Example String', 'selection');
+console.log(clipboard.readText('selection'));
+```
+
+## メソッド
+
+`clipboard`モジュールには、次のメソッドがあります:
+
+**Note:** 実験的APIには、そのようにマークしてあり、将来的には削除される可能性があります。
+
+### `clipboard.readText([type])`
+
+* `type` String (optional)
+
+プレーンテキストとしてクリップボードの内容を返します。
+
+### `clipboard.writeText(text[, type])`
+
+* `text` String
+* `type` String (optional)
+
+プレーンテキストとしてクリップボードに`text`を書き込みます。
+
+### `clipboard.readHtml([type])`
+
+* `type` String (optional)
+
+HTMLマークアップとして、クリップボードの内容を返します。
+
+### `clipboard.writeHtml(markup[, type])`
+
+* `markup` String
+* `type` String (optional)
+
+クリップボードにHTMLマークアップとして書き込みます。
+
+### `clipboard.readImage([type])`
+
+* `type` String (optional)
+
+[NativeImage](native-image.md)としてクリップボードの内容を返します。
+
+### `clipboard.writeImage(image[, type])`
+
+* `image` [NativeImage](native-image.md)
+* `type` String (optional)
+
+`image` としてクリップボードに書き込みます。
+
+### `clipboard.clear([type])`
+
+* `type` String (optional)
+
+クリップボードの内容をクリアします。
+
+### `clipboard.availableFormats([type])`
+
+* `type` String (optional)
+
+`type`のクリップボードがサポートしているフォーマット配列を返します。
+
+### `clipboard.has(data[, type])` _実験_
+
+* `data` String
+* `type` String (optional)
+
+`data`で指定したフォーマットをクリップボードがサポートしているかどうかを返します。
+
+```javascript
+console.log(clipboard.has('<p>selection</p>'));
+```
+
+### `clipboard.read(data[, type])` _実験_
+
+* `data` String
+* `type` String (optional)
+
+クリップボードから`data`を読み込みます。
+
+### `clipboard.write(data[, type])`
+
+* `data` Object
+  * `text` String
+  * `html` String
+  * `image` [NativeImage](native-image.md)
+* `type` String (optional)
+
+```javascript
+clipboard.write({text: 'test', html: "<b>test</b>"});
+```
+クリップボードに`data`を書き込みます。
diff --git a/docs-translations/jp/api/crash-reporter.md b/docs-translations/jp/api/crash-reporter.md
@@ -0,0 +1,66 @@
+# crashReporter
+
+`crash-reporter`モジュールはアプリのクラッシュレポートを送信することができます。
+
+リモートサーバーに自動的にクラッシュレポートを登録する例です。
+
+```javascript
+const crashReporter = require('electron').crashReporter;
+
+crashReporter.start({
+  productName: 'YourName',
+  companyName: 'YourCompany',
+  submitURL: 'https://your-domain.com/url-to-submit',
+  autoSubmit: true
+});
+```
+
+## メソッド
+
+`crash-reporter`モジュールは次のメソッドを持ちます:
+
+### `crashReporter.start(options)`
+
+`options` Object, properties:
+
+* `productName` String, デフォルト: Electron.
+* `companyName` String (**必須**)
+* `submitURL` String, (**必須**)
+  * クラッシュレポートがPOSTで送信されるURL
+* `autoSubmit` Boolean, デフォルト: `true`.
+  * ユーザーの判断なくクラッシュレポートを送信します
+* `ignoreSystemCrashHandler` Boolean, デフォルト: `false`.
+* `extra` Object
+  * あなたが定義できるオブジェクトは、レポートと一緒に送信されます。
+  * 文字列プロパティのみが正しく送信されます。
+  * オブジェクトのネストはサポートしていません。
+
+他の`crashReporter`APIを使用する前にこのメソッドをコールする必要があります。
+
+**Note:** OS Xでは、Electronは、WindowsとLinux上の`breakpad` とは異なる、新しい`crashpad`クライアントを使用します。クラッシュ収集機能を有効にするために、メインプロセスや、クラッシュレポートを収集したいそれぞれのレンダラープロセスで、`crashpad`を初期化するために`crashReporter.start`APIをコールする必要があります。
+
+### `crashReporter.getLastCrashReport()`
+
+日付と最後のクラッシュレポートのIDを返します。もしなんのクラッシュレポートも送信されていないか、クラッシュレポーターが起動していない場合、`null`を返します。
+
+### `crashReporter.getUploadedReports()`
+
+滑ってのアップロードされたクラッシュレポートが返されます。それぞれのレポートには日付とアップロードされたIDが含まれます。
+
+## crash-reporter Payload
+
+クラッシュレポーターは`POST`で`submitURL` に次のデーターが送信されます。
+
+* `ver` String - Electronのバージョン
+* `platform` String - 例： 'win32'.
+* `process_type` String - 例： 'renderer'.
+* `guid` String - 例： '5e1286fc-da97-479e-918b-6bfb0c3d1c72'
+* `_version` String - `package.json`でのバージョン
+* `_productName` String - `crashReporter`でのプロダクト名 `オプション`
+  object.
+* `prod` String - 基盤となる製品の名前。この場合は、Electronです。
+* `_companyName` String - `crashReporter`での会社名 `オプション`
+  object.
+* `upload_file_minidump` File - ファイル形式のクラッシュレポート
+* `crashReporter`での`extra`オブジェクトのすべてのレベル1のプロパティ
+  `オプション` object
diff --git a/docs-translations/jp/api/download-item.md b/docs-translations/jp/api/download-item.md
@@ -0,0 +1,92 @@
+# DownloadItem
+
+`DownloadItem`は、Electronでアイテムのダウンロードを示すEventEmitterです。 `Session`モジュールの`will-download`イベントで使用され、ダウンロードしたアイテムをコントロールすることができます。
+
+```javascript
+// In the main process.
+win.webContents.session.on('will-download', function(event, item, webContents) {
+  // Set the save path, making Electron not to prompt a save dialog.
+  item.setSavePath('/tmp/save.pdf');
+  console.log(item.getMimeType());
+  console.log(item.getFilename());
+  console.log(item.getTotalBytes());
+  item.on('updated', function() {
+    console.log('Received bytes: ' + item.getReceivedBytes());
+  });
+  item.on('done', function(e, state) {
+    if (state == "completed") {
+      console.log("Download successfully");
+    } else {
+      console.log("Download is cancelled or interrupted that can't be resumed");
+    }
+  });
+```
+
+## イベント
+
+### イベント: 'updated'
+
+`downloadItem`が更新されたときに出力されます。
+
+### イベント: 'done'
+
+* `event` Event
+* `state` String
+  * `completed` - ダウンロードが成功で完了
+  * `cancelled` - ダウンロードをキャンセル
+  * `interrupted` - ファイルサーバーとの接続が切れてエラー
+
+ダウンロードが終了状態になったときに出力されます。終了状態には、ダウンロードの完了、ダウンロードのキャンセル（`downloadItem.cancel()`経由）、レジュームできないダウンロードの中断などです。
+
+## メソッド
+
+`downloadItem`オブジェクトは次のメソッドを持ちます:
+
+### `downloadItem.setSavePath(path)`
+
+* `path` String - ダウンロードアイテムの保存ファイルパスを設定します。
+
+APIはセッションの`will-download`コールバック関数のみで提供されます。API経由で保存パスを設定しなかった場合、Electronは保存パスを決めるための元のルーチン（通常は保存ダイアログ）を使用します。
+
+### `downloadItem.pause()`
+
+ダウンロードをポーズします。
+
+### `downloadItem.resume()`
+
+ポーズしたダウンロードを再開します。
+
+### `downloadItem.cancel()`
+
+ダウンロード操作をキャンセルします。
+
+### `downloadItem.getURL()`
+
+どのURLからアイテムをダウンロードするのかを示す`String`を返します。
+
+### `downloadItem.getMimeType()`
+
+mimeタイプを示す`String`を返します。
+
+### `downloadItem.hasUserGesture()`
+
+ダウンロードがユーザージェスチャーを持っているかどうかを示す`Boolean`を返します。
+
+### `downloadItem.getFilename()`
+
+ダウンロードアイテムのファイル名を示す`String`を返します。
+
+**Note:** ファイル名はローカルディスクに実際に保存するものといつも同じとは限りません。ダウンロード保存ダイアログでユーザーがファイル名を変更していると、保存するファイルの実際の名前は異なります。
+
+### `downloadItem.getTotalBytes()`
+
+ダウンロードアイテムの合計バイトサイズを示す`Integer`を返します。
+サイズが不明な場合、0を返します。
+
+### `downloadItem.getReceivedBytes()`
+
+ダウンロードしたアイテムの受信バイト数を示す`Integer`を返します。
+
+### `downloadItem.getContentDisposition()`
+
+レスポンスヘッダーからContent-Dispositionを示す`String`を返します。
diff --git a/docs-translations/jp/api/environment-variables.md b/docs-translations/jp/api/environment-variables.md
@@ -0,0 +1,47 @@
+# 環境変数
+
+コマンドラインやアプリのコードよりも早く初期化されるために、Electronのいくつかの挙動は環境変数がコントロールしています。
+
+POSIX shellでの例:
+
+```bash
+$ export ELECTRON_ENABLE_LOGGING=true
+$ electron
+```
+
+Windows コンソール上:
+
+```powershell
+> set ELECTRON_ENABLE_LOGGING=true
+> electron
+```
+
+## `ELECTRON_RUN_AS_NODE`
+
+通常のNode.jsプロセスでプロセスを開始します。
+
+## `ELECTRON_ENABLE_LOGGING`
+
+Chromeのインターナルログをコンソールに出力します。
+
+## `ELECTRON_ENABLE_STACK_DUMPING`
+
+Electronがクラッシュしたとき、コンソールにスタックとレースを出力します。
+`crashReporter`が開始していないと、この環境変数は動作しません。
+
+## `ELECTRON_DEFAULT_ERROR_MODE` _Windows_
+
+Electronがクラッシュしたとき、Windowsのクラッシュダイアログを表示します。
+`crashReporter`が開始していないと、この環境変数は動作しません。
+
+## `ELECTRON_NO_ATTACH_CONSOLE` _Windows_
+
+現在のコンソールセッションにはアタッチできません。
+
+## `ELECTRON_FORCE_WINDOW_MENU_BAR` _Linux_
+
+Linuxでグローバルメニューバーを使用できません。
+
+## `ELECTRON_HIDE_INTERNAL_MODULES`
+
+`require('ipc')`のような古い組み込みモジュールとの互換モードを無効にします。
diff --git a/docs-translations/jp/api/global-shortcut.md b/docs-translations/jp/api/global-shortcut.md
@@ -0,0 +1,64 @@
+# globalShortcut
+
+さまざまなショートカットの動作をカスタマイズするために、オペレーティングシステムのグローバルのキーボードショートカットを`globalShortcut`モジュールは登録したり、解除したりできます。
+
+**Note:** ショートカットはグローバルです。アプリがキーボードフォーカスを持っていなくても動作します。`app`モジュールの `ready`イベントが出力されるまでは使うべきではありません。
+
+```javascript
+const electron = require('electron');
+const app = electron.app;
+const globalShortcut = electron.globalShortcut;
+
+app.on('ready', function() {
+  // Register a 'ctrl+x' shortcut listener.
+  var ret = globalShortcut.register('ctrl+x', function() {
+    console.log('ctrl+x is pressed');
+  });
+
+  if (!ret) {
+    console.log('registration failed');
+  }
+
+  // Check whether a shortcut is registered.
+  console.log(globalShortcut.isRegistered('ctrl+x'));
+});
+
+app.on('will-quit', function() {
+  // Unregister a shortcut.
+  globalShortcut.unregister('ctrl+x');
+
+  // Unregister all shortcuts.
+  globalShortcut.unregisterAll();
+});
+```
+
+## メソッド
+
+`globalShortcut`モジュールは次のメソッドを持ちます:
+
+### `globalShortcut.register(accelerator, callback)`
+
+* `accelerator` [Accelerator](accelerator.md)
+* `callback` Function
+
+`accelerator`のグローバルショートカットを登録します。`callback`は、ユーザーが登録しているショートカットを押したときにコールされます。
+
+ほかのアプリケーションがすでにacceleratorを使用している時、この呼び出しは静かに失敗します。アプリケーション間でグローバルショートカットの争いをしてほしくないので、オペレーティングシステムはこの挙動を採用しています。
+
+### `globalShortcut.isRegistered(accelerator)`
+
+* `accelerator` [Accelerator](accelerator.md)
+
+このアプリケーションが`accelerator`に登録されているかどうかを返します。
+
+acceleratorがすでにほかのアプリケーションで取得していると、このコールは、`false`を返します。アプリケーション間でグローバルショートカットの争いをしてほしくないので、オペレーティングシステムはこの挙動を採用しています。
+
+### `globalShortcut.unregister(accelerator)`
+
+* `accelerator` [Accelerator](accelerator.md)
+
+Unregisters the global shortcut of `accelerator`のグローバルショートカットを解除します。
+
+### `globalShortcut.unregisterAll()`
+
+全てのグローバルショートカットを解除します。
diff --git a/docs-translations/jp/api/screen.md b/docs-translations/jp/api/screen.md
