Merge pull request #3743 from preco21/master

Update as upstream

docs-translations/ko-KR/README.md

@@ -62,6 +62,7 @@ GitHub 프로젝트내에서만 볼 수 있고 `master` 브랜치의 문서는
 
 ### 랜더러 프로세스에서 사용할 수 있는 모듈 (웹 페이지):
 
+* [desktopCapturer](api/desktop-capturer.md)
 * [ipcRenderer](api/ipc-renderer.md)
 * [remote](api/remote.md)
 * [webFrame](api/web-frame.md)

docs-translations/ko-KR/api/browser-window.md

@@ -737,3 +737,9 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고
 윈도우가 모든 워크스페이스에서 표시될지 여부를 반환합니다.
 
 **참고:** 이 API는 Windows에서 언제나 false를 반환합니다.
+
+### `win.setIgnoreMouseEvents(ignore)` _OS X_
+
+* `ignore` Boolean
+
+윈도우에서 일어나는 모든 마우스 이벤트를 무시합니다.

docs-translations/ko-KR/api/desktop-capturer.md

@@ -0,0 +1,68 @@
+# desktopCapturer
+
+`desktopCapturer` 모듈은 `getUserMedia`에서 사용 가능한 소스를 가져올 때 사용할 수
+있습니다.
+
+```javascript
+// 렌더러 프로세스 내부
+var desktopCapturer = require('electron').desktopCapturer;
+
+desktopCapturer.getSources({types: ['window', 'screen']}, function(error, sources) {
+  if (error) throw error;
+  for (var i = 0; i < sources.length; ++i) {
+    if (sources[i].name == "Electron") {
+      navigator.webkitGetUserMedia({
+        audio: false,
+        video: {
+          mandatory: {
+            chromeMediaSource: 'desktop',
+            chromeMediaSourceId: sources[i].id,
+            minWidth: 1280,
+            maxWidth: 1280,
+            minHeight: 720,
+            maxHeight: 720
+          }
+        }
+      }, gotStream, getUserMediaError);
+      return;
+    }
+  }
+});
+
+function gotStream(stream) {
+  document.querySelector('video').src = URL.createObjectURL(stream);
+}
+
+function getUserMediaError(e) {
+  console.log('getUserMediaError');
+}
+```
+
+## Methods
+
+`desktopCapturer` 모듈은 다음과 같은 메서드를 가지고 있습니다:
+
+### `desktopCapturer.getSources(options, callback)`
+
+* `options` Object
+  * `types` Array - 캡쳐될 데스크탑 소스의 타입에 대한 리스트를 배열로 지정합니다.
+    사용 가능한 타입은 `screen`과 `window`입니다.
+  * `thumbnailSize` Object (optional) - 섬네일 크기를 조정할 때 최대한 맞춰질 크기,
+    기본값은 `{width: 150, height: 150}`입니다.
+* `callback` Function
+
+모든 데스크탑 소스를 요청합니다. 요청의 처리가 완료되면 `callback`은
+`callback(error, sources)` 형식으로 호출됩니다.
+
+`sources`는 `Source` 객체의 배열입니다. 각 `Source`는 캡쳐된 화면과 독립적인
+윈도우를 표현합니다. 그리고 다음과 같은 속성을 가지고 있습니다:
+* `id` String - `navigator.webkitGetUserMedia` API에서 사용할 수 있는 캡쳐된 윈도우
+  또는 화면의 id입니다. 포맷은 `window:XX` 또는 `screen:XX`로 표현되며 `XX` 는
+  무작위로 생성된 숫자입니다.
+* `name` String - 캡쳐된 화면과 윈도우에 대해 묘사된 이름입니다. 만약 소스가
+  화면이라면, `Entire Screen` 또는 `Screen <index>`가 될 것이고 소스가 윈도우라면,
+  해당 윈도우의 제목이 반환됩니다.
+* `thumbnail` [NativeImage](NativeImage.md) - 섬네일 이미지.
+
+**참고:** `source.thumbnail`의 크기는 언제나 `options`의 `thumnbailSize`와 같다고
+보장할 수 없습니다. 섬네일의 크기는 화면과 윈도우의 크기에 의존하여 조정됩니다.

docs-translations/ko-KR/api/ipc-main.md

@@ -66,4 +66,4 @@ ipcRenderer.send('asynchronous-message', 'ping');
 비동기로 메시지를 전달할 수 있습니다. 자세한 내용은
 [webContents.send][webcontents-send]를 참고하세요.
 
-[webcontents-send]: web-contents.md#webcontentssendchannel-args
+[webcontents-send]: web-contents.md#webcontentssendchannel-arg1-arg2-

docs-translations/ko-KR/api/menu-item.md

@@ -17,7 +17,8 @@
   * `role` String - 메뉴 아이템의 액션을 정의합니다. 이 속성을 지정하면 `click`
     속성이 무시됩니다.
   * `type` String - `MenuItem`의 타입 `normal`, `separator`, `submenu`,
-    `checkbox` 또는 `radio` 사용가능
+    `checkbox` 또는 `radio`를 사용할 수 있습니다. 만약 값이 `Menu`가 아니면
+    `Menu.buildFromTemplate`를 통해 자동으로 변환됩니다.
   * `label` String
   * `sublabel` String
   * `accelerator` [Accelerator](accelerator.md)

docs-translations/ko-KR/tutorial/desktop-environment-integration.md

@@ -24,7 +24,7 @@ myNotification.onclick = function () {
 }
 ```
 
-위 코드를 통해 생성한 데스크톱 알림은 각 운영체제 모두 비슷한 사용자 경험을 제공합니다.
+위 코드를 통해 생성한 데스크톱 알림은 각 운영체제 모두 비슷한 사용자 경험을 제공하지만,
 하지만 몇 가지 다른 점들이 있습니다.
 
 ### Windows