Merge pull request #5048 from preco21/master

Docs: Update Korean docs as upstream

docs-translations/ko-KR/api/accelerator.md

@@ -5,8 +5,8 @@ Accelerator는 키보드 단축키를 표현하는 문자열입니다, 여러
 
 예제:
 
-* `Command+A`
-* `Ctrl+Shift+Z`
+* `CommandOrControl+A`
+* `CommandOrControl+Shift+Z`
 
 ## 플랫폼에 관련하여 주의할 점
 
@@ -14,6 +14,9 @@ Linux와 Windows에서는 `Command`키가 없으므로 작동하지 않습니다
 `CommandOrControl`을 사용하면 OS X의 `Command`와 Linux, Windows의 `Control` 모두
 지원할 수 있습니다.
 
+`Option` 대신 `Alt`을 사용하는게 좋습니다. `Option` 키는 OS X에만 있으므로
+모든 플랫폼에서 사용할 수 있는 `Alt` 키를 권장합니다.
+
 `Super`키는 Windows와 Linux 에서는 `윈도우`키를, OS X에서는 `Cmd`키로 맵핑됩니다.
 
 ## 사용 가능한 혼합키

docs-translations/ko-KR/api/app.md

@@ -353,6 +353,10 @@ npm 모듈 규칙에 따라 대부분의 경우 `package.json`의 `name` 필드
 현재 어플리케이션의 [로케일](https://ko.wikipedia.org/wiki/%EB%A1%9C%EC%BC%80%EC%9D%BC)을
 반환합니다.
 
+**참고:** 패키징된 앱을 배포할 때, `locales` 폴더도 같이 배포해야 합니다.
+
+**참고:** Windows에선 `ready` 이벤트가 발생한 이후에 이 메서드를 사용해야 합니다.
+
 ### `app.addRecentDocument(path)` _OS X_ _Windows_
 
 * `path` String

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

@@ -81,8 +81,7 @@ win.show();
 * `enableLargerThanScreen` Boolean - 윈도우 크기가 화면 크기보다 크게 재조정 될
   수 있는지 여부. 기본값은 `false`입니다.
 * `backgroundColor` String - `#66CD00` 와 `#FFF`, `#80FFFFFF` (알파 지원됨) 같이
-  16진수로 표현된 윈도우의 배경 색. 기본값은 Linux와 Windows에선 `#000` (검정)이며,
-  Mac에선 `#FFF` (또는, transparent(투명)일 경우 clear(색 없음)로 설정)
+  16진수로 표현된 윈도우의 배경 색. 기본값은 `#FFF` (white).
 * `hasShadow` Boolean - 윈도우가 그림자를 가질지 여부를 지정합니다. 이 속성은
   OS X에서만 구현되어 있습니다. 기본값은 `true`입니다.
 * `darkTheme` Boolean - 설정에 상관 없이 무조건 어두운 윈도우 테마를 사용합니다.
@@ -296,11 +295,20 @@ __참고__: OS X에선 이 이벤트가 그저 `moved` 이벤트의 별칭(alias
 
 ### Event: 'app-command' _Windows_
 
+Returns:
+
+* `event` Event
+* `command` String
+
 [App Command](https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx)가
 호출됐을 때 발생하는 이벤트입니다. 이 이벤트는 일반적으로 키보드 미디어 키 또는
 브라우저 커맨드(기본 동작 키)에 관련되어 있습니다. 예를 들어 Windows에서 작동하는
 몇몇 마우스는 "뒤로가기" 같은 동작을 포함하고 있습니다.
 
+반환되는 커맨드들은 모두 소문자화되며 언더스코어(`_`)는 하이픈(`-`)으로 변경되며
+`APPCOMMAND_` 접두어는 제거됩니다.
+e.g. `APPCOMMAND_BROWSER_BACKWARD` 는 `browser-backward`와 같이 반환됩니다.
+
 ```javascript
 someWindow.on('app-command', function(e, cmd) {
   // 마우스의 뒤로가기 버튼을 눌렀을 때 뒤로가기 탐색을 실행합니다

docs-translations/ko-KR/api/dialog.md

@@ -12,6 +12,13 @@ const dialog = require('electron').dialog;
 console.log(dialog.showOpenDialog({ properties: [ 'openFile', 'openDirectory', 'multiSelections' ]}));
 ```
 
+대화 상자는 Electron의 메인 스레드에서 열립니다. 만약 랜더러 프로세스에서 대화 상자
+객체를 사용하고 싶다면, `remote`를 통해 접근하는 방법을 고려해야 합니다:
+
+```javascript
+const dialog = require('electron').remote.dialog;
+```
+
 **OS X 참고**: 대화 상자를 시트처럼 보여지게 하려면 `browserWindow` 인자에
 `BrowserWindow` 객체의 참조를 제공하면 됩니다.
 

docs-translations/ko-KR/api/global-shortcut.md

@@ -14,9 +14,9 @@ const app = electron.app;
 const globalShortcut = electron.globalShortcut;
 
 app.on('ready', function() {
-  // 'ctrl+x' 단축키를 리스너에 등록합니다.
-  var ret = globalShortcut.register('ctrl+x', function() {
-    console.log('ctrl+x is pressed');
+  // 'CommandOrControl+X' 단축키를 리스너에 등록합니다.
+  var ret = globalShortcut.register('CommandOrControl+X', function() {
+    console.log('CommandOrControl+X is pressed');
   });
 
   if (!ret) {
@@ -24,12 +24,12 @@ app.on('ready', function() {
   }
 
   // 단축키가 등록되었는지 확인합니다.
-  console.log(globalShortcut.isRegistered('ctrl+x'));
+  console.log(globalShortcut.isRegistered('CommandOrControl+X'));
 });
 
 app.on('will-quit', function() {
   // 단축키의 등록을 해제합니다.
-  globalShortcut.unregister('ctrl+x');
+  globalShortcut.unregister('CommandOrControl+X');
 
   // 모든 단축키의 등록을 해제합니다.
   globalShortcut.unregisterAll();

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

@@ -71,7 +71,7 @@
 메인 프로세스는 `ipcMain` 모듈을 통해 `channel` 이벤트를 리스닝 할 수 있고,
 `event.returnValue`로 회신 할 수 있습니다.
 
-__참고:__ 동기 메서드는 모든 랜더러 프로세스의 작업을 일시 중단시킵니다. 사용 목적이
+**참고:** 동기 메서드는 모든 랜더러 프로세스의 작업을 일시 중단시킵니다. 사용 목적이
 확실하지 않다면 사용하지 않는 것이 좋습니다.
 
 ### `ipcRenderer.sendToHost(channel[, arg1][, arg2][, ...])`

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

@@ -14,7 +14,7 @@
 * `options` Object
   * `click` Function - 메뉴 아이템이 클릭될 때 `click(menuItem, browserWindow)`
     형태로 호출 되는 콜백 함수
-  * `role` String - 메뉴 아이템의 액션을 정의합니다. 이 속성을 지정하면 `click`
+  * `role` String - 메뉴 아이템의 액션을 정의합니다; 이 속성을 지정하면 `click`
     속성이 무시됩니다.
   * `type` String - `MenuItem`의 타입 `normal`, `separator`, `submenu`,
     `checkbox` 또는 `radio`를 사용할 수 있습니다. 만약 값이 `Menu`가 아니면
@@ -23,18 +23,22 @@
   * `sublabel` String
   * `accelerator` [Accelerator](accelerator.md)
   * `icon` [NativeImage](native-image.md)
-  * `enabled` Boolean
-  * `visible` Boolean
-  * `checked` Boolean
-  * `submenu` Menu - 보조메뉴를 설정합니다. `type`이 `submenu`일 경우 반드시
-    설정해야 합니다. 일반 메뉴 아이템일 경우 생략할 수 있습니다.     
+  * `enabled` Boolean - 만약 `false`로 설정되면, 메뉴 아이템이 회색으로 변하며
+    클릭할 수 없게 됩니다.
+  * `visible` Boolean - 만약 `false`로 설정되면, 메뉴 아이템이 완전히 숨겨집니다.
+  * `checked` Boolean - 반드시 `checkbox` 또는 `radio` 타입의 메뉴 아이템에만
+    지정해야 합니다.
+  * `submenu` Menu - 반드시 `submenu` 타입의 메뉴 아이템에만 지정해야 합니다. 만약
+    `submenu`가 지정되면 `type: 'submenu'`는 생략될 수 있습니다. 만약 값이 `Menu`가
+    아닐 경우 `Menu.buildFromTemplate`을 통해 자동적으로 변환됩니다.     
   * `id` String - 현재 메뉴 아이템에 대해 유일키를 지정합니다. 이 키는 이후
     `position` 옵션에서 사용할 수 있습니다.
   * `position` String - 미리 지정한 `id`를 이용하여 메뉴 아이템의 위치를 세밀하게
     조정합니다.
 
-메뉴 아이템을 생성할 때, 다음 목록과 일치하는 표준 동작은 수동으로 직접 구현하는 대신
-`role` 속성을 지정하여 고유 OS 경험을 최대한 살릴 수 있습니다.
+어떠한 메뉴 아이템이 표준 롤에 일치한다면, `role`을 지정하는 것이 동작을 `click`
+함수로 일일이 구현하려 시도하는 것 보다 더 좋을 수 있습니다. 빌트-인 `role` 동작은
+더 좋은 네이티브 경험을 제공할 것입니다.
 
 `role` 속성은 다음 값을 가질 수 있습니다:
 
@@ -57,3 +61,21 @@ OS X에서의 `role`은 다음 값을 추가로 가질 수 있습니다:
 * `window` - 부 메뉴를 가지는 "Window" 메뉴
 * `help` - 부 메뉴를 가지는 "Help" 메뉴
 * `services` - 부 메뉴를 가지는 "Services" 메뉴
+
+## Instance Properties
+
+다음 속성들은 존재하는 `MenuItem`에서 계속 변경될 수 있습니다:
+
+  * `enabled` Boolean
+  * `visible` Boolean
+  * `checked` Boolean
+
+이 속성들의 의미는 위 옵션에서 설명한 것과 같습니다.
+
+`checkbox` 메뉴 아이템은 선택될 때 해당 아이템의 `checked` 속성을 통해 활성화 그리고
+비활성화 상태인지를 표시합니다. 또한 `click` 함수를 지정하여 추가적인 작업을 할 수도
+있습니다.
+
+`radio` 메뉴 아이템은 클릭되었을 때 `checked` 속성을 활성화 합니다. 그리고 같은
+메뉴의 인접한 모든 다른 아이템은 비활성화됩니다. 또한 `click` 함수를 지정하여 추가적인
+작업을 할 수도 있습니다.

docs-translations/ko-KR/api/tray.md

@@ -74,7 +74,7 @@ appIcon.setContextMenu(contextMenu);
 
 트레이 아이콘이 클릭될 때 발생하는 이벤트입니다.
 
-__주의:__ `bounds`는 OS X 와 Windows에서만 작동합니다.
+**참고:** `bounds`는 OS X 와 Windows에서만 작동합니다.
 
 ### Event: 'right-click' _OS X_ _Windows_
 

docs-translations/ko-KR/api/web-view-tag.md

@@ -80,6 +80,9 @@
 "on"으로 지정하면 `webview` 페이지 내에서 `require`와 `process 객체`같은 node.js
 API를 사용할 수 있습니다. 이를 지정하면 내부에서 로우레벨 리소스에 접근할 수 있습니다.
 
+**참고:** Node 통합 기능은 `webview`에서 부모 윈도우가 해당 옵션이 비활성화되어있는
+경우 항상 비활성화됩니다.
+
 ### `plugins`
 
 ```html
@@ -595,7 +598,10 @@ Returns:
 
 ```javascript
 webview.addEventListener('new-window', function(e) {
-  require('electron').shell.openExternal(e.url);
+  var protocol = require('url').parse(e.url).protocol;
+  if (protocol === 'http:' || protocol === 'https:') {
+    require('electron').shell.openExternal(e.url);
+  }
 });
 ```
 

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

@@ -22,6 +22,9 @@
 `features` 문자열은 표준 브라우저의 포맷을 따르고 있지만, 각 기능은 `BrowserWindow`의
 옵션이어야 합니다.
 
+**참고:** Node 통합 기능은 열린 `window`에서 부모 윈도우가 해당 옵션이
+비활성화되어있는 경우 항상 비활성화됩니다.
+
 ### `window.opener.postMessage(message, targetOrigin)`
 
 * `message` String

docs-translations/ko-KR/development/coding-style.md

@@ -23,8 +23,7 @@ C++ 코드는 많은 Chromium의 추상화와 타입을 사용합니다. 따라
 
 ## JavaScript
 
-* 하드 탭(hard tabs) 대신 소프트 탭(2 spaces) 들여쓰기를 사용합니다.
-* 항상 구문의 끝은 `;`으로 마쳐야 합니다.
+* [표준](http://npm.im/standard) JavaScript 코딩 스타일을 사용합니다.
 * Google의 코딩 스타일에도 맞추기 위해 파일의 끝에는 **절대** 개행을 삽입해선 안됩니다.
 * 파일 이름의 공백은 `_`대신에 `-`을 사용하여야 합니다. 예를 들어
 `file_name.js`를 `file-name.js`로 고쳐야합니다. 왜냐하면

docs-translations/ko-KR/development/setting-up-symbol-server.md

@@ -21,7 +21,7 @@ http://54.249.141.255:8086/atom-shell/symbols 입니다. 일단 이 URL에 직
 ## Windbg에서 심볼 서버 사용하기
 
 Windbg 심볼 경로는 구분자와 `*` 문자로 설정되어 있습니다. Electron 심볼 서버만
-사용하려면 심볼 경로의 엔트리를 추가해야 합니다. (__참고:__  `c:\code\symbols`
+사용하려면 심볼 경로의 엔트리를 추가해야 합니다. (**참고:**  `c:\code\symbols`
 디렉터리 경로를 PC가 원하는 경로로 수정할 수 있습니다):
 
 ```

docs-translations/ko-KR/faq/electron-faq.md

@@ -144,19 +144,6 @@ npm uninstall -g electron
 모듈이며, 반면 `electron.webFrame` 모듈은 랜더러 프로세스에서만 사용할 수 있는
 모듈입니다.
 
-## 왜 저의 앱 배경이 투명하죠?
-
-Electron `0.37.3` 부터, 기본 클라이언트 배경색이 `투명색`으로 변경되었습니다.
-간단히 HTML에서 배경색을 지정합니다:
-
-```html
-<style type='text/css'>
-  html {
-    background: white;
-  }
-</style>
-```
-
 [memory-management]: https://developer.mozilla.org/ko/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/ko-KR/tutorial/debugging-main-process.md

@@ -19,7 +19,7 @@
 
 ## node-inspector로 디버깅 하기
 
-__참고:__ Electron은 현재 node-inspector 유틸리티와 호환성 문제가 있습니다. 따라서
+**참고:** Electron은 현재 node-inspector 유틸리티와 호환성 문제가 있습니다. 따라서
 node-inspector 콘솔 내에서 메인 프로세스의 `process` 객체를 탐색할 경우 크래시가
 발생할 수 있습니다.
 

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

@@ -14,7 +14,7 @@ Windows, Linux, OS X 운영체제 모두 기본적으로 어플리케이션에
 통해 개발자가 편리하게 데스크톱 알림을 사용할 수 있는 기능을 제공합니다. 데스크톱 알림은
 운영체제의 네이티브 알림 API를 사용하여 표시합니다.
 
-__참고:__ 이 API는 HTML5 API이기 때문에 랜더러 프로세스에서만 사용할 수 있습니다.
+**참고:** 이 API는 HTML5 API이기 때문에 랜더러 프로세스에서만 사용할 수 있습니다.
 
 ```javascript
 var myNotification = new Notification('Title', {

docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md

@@ -4,11 +4,11 @@ Electron은 v0.34.0 버전부터 앱 패키지를 Mac App Store(MAS)에 제출
 되었습니다. 이 가이드는 어플리케이션을 앱 스토어에 등록하는 방법과 빌드의 한계에 대한
 설명을 제공합니다.
 
-__참고:__ v0.36.0 버전부터 어플리케이션이 샌드박스화 된 상태로 실행되면 GPU 작동을
+**참고:** v0.36.0 버전부터 어플리케이션이 샌드박스화 된 상태로 실행되면 GPU 작동을
 방지하는 버그가 있었습니다. 따라서 이 버그가 고쳐지기 전까진 v0.35.x 버전을 사용하는
 것을 권장합니다. 이 버그에 관한 자세한 사항은 [issue #3871][issue-3871]를 참고하세요.
 
-__참고:__ Mac App Store에 어플리케이션을 등록하려면
+**참고:** Mac App Store에 어플리케이션을 등록하려면
 [Apple Developer Program][developer-program]에 등록되어 있어야 하며 비용이 발생할
 수 있습니다.
 

docs-translations/ko-KR/tutorial/using-widevine-cdm-plugin.md

@@ -8,7 +8,7 @@ Electron은 라이센스상의 문제로 Widevine CDM 플러그인을 직접 제
 따라서 플러그인을 얻으려면 먼저 사용할 Electron 빌드의 아키텍쳐와 버전에 맞춰 공식
 Chrome 브라우저를 설치해야 합니다.
 
-__참고:__ Chrome 브라우저의 메이저 버전은 Electron에서 사용하는 Chrome 버전과
+**참고:** Chrome 브라우저의 메이저 버전은 Electron에서 사용하는 Chrome 버전과
 같습니다, 만약 그렇지 않다면 `navigator.plugins`가 로드됐더라도 정상적으로 작동하지
 않습니다.
 
@@ -42,7 +42,7 @@ Linux에선 플러그인 바이너리들이 Chrome 브라우저와 함께 제공
 `widevinecdmadapter`의 위치를 전달하고 플러그인의 버전을 `--widevine-cdm-version`
 스위치에 전달해야 합니다.
 
-__참고:__ `widevinecdmadapter` 바이너리가 Electron으로 전달되어도, `widevinecdm`
+**참고:** `widevinecdmadapter` 바이너리가 Electron으로 전달되어도, `widevinecdm`
 바이너리는 옆에 같이 두어야 합니다.
 
 커맨드 라인 스위치들은 `app` 모듈의 `ready` 이벤트가 발생하기 전에 전달되어야 합니다.