Merge pull request #5849 from preco21/korean-docs-6

docs: Update Korean docs as upstream

README-ko.md

@@ -7,19 +7,18 @@
 
 ### [Electron](https://github.com/electron/electron/) 한국어 참조 문서
 
-:zap: *이전까지 Atom Shell로 불렸지만, Electron으로 변경되었습니다* :zap:
-
 Electron 프레임워크는 JavaScript, HTML 그리고 CSS를 사용하여
 Cross-Platform 데스크톱 어플리케이션을 개발할 수 있도록 해주는 프레임워크입니다.
 [Node.js](https://nodejs.org/)와 [Chromium](http://www.chromium.org)을 기반으로
 만들어졌으며 [Atom Editor](https://github.com/atom/atom)에 사용되고 있습니다.
+더 많은 어플리케이션은 [이곳](http://electron.atom.io/apps)에서 확인하세요.
 
 Electron에 대한 중요한 알림을 받고 싶다면 Twitter에서
 [@ElectronJS](https://twitter.com/electronjs)를 팔로우 하세요.
 
 이 프로젝트는 기여자 규약인 [행동강령](CODE_OF_CONDUCT.md)을 준수합니다. 따라서 이
 프로젝트의 개발에 참여하려면 이 규약을 지켜야 합니다. 받아들일 수 없는 행위를 발견했을
-경우 atom@github.com로 보고하세요.
+경우 electron@github.com로 보고하세요.
 
 ## 다운로드
 

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

@@ -280,6 +280,32 @@ GPU가 작동하던 중 크래시가 일어났을 때 발생하는 이벤트입
 모든 윈도우는 사용자의 동의 여부에 상관없이 즉시 종료되며 `before-quit` 이벤트와
 `will-quit` 이벤트가 발생하지 않습니다.
 
+### `app.relaunch([options])`
+
+* `options` Object (optional)
+  * `args` Array (optional)
+  * `execPath` String (optional)
+
+현재 인스턴스가 종료되면 어플리케이션을 재시작합니다.
+
+기본적으로 새 인스턴스는 같은 작업 디렉토리의 것과 함께 현재 인스턴스의 명령줄 인수를
+사용합니다. 만약 `args`가 지정되면, `args`가 기본 명령줄 인수 대신에 전달됩니다.
+`execPath`가 지정되면, 현재 어플리케이션 대신 `execPath`가 실행됩니다.
+
+참고로 이 메서드는 어플리케이션을 종료하지 않으며, 어플리케이션을 다시 시작시키려면
+`app.relaunch`를 호출한 후 `app.quit` 또는 `app.exit`를 실행해주어야 합니다.
+
+`app.relaunch`가 여러 번 호출되면, 현재 인스턴스가 종료된 후 여러 인스턴스가
+시작됩니다.
+
+다음은 현재 인스턴스를 즉시 종료시킨 후 새로운 명령줄 인수를 추가하여 새
+인스턴스의 어플리케이션을 실행하는 예시입니다:
+
+```javascript
+app.relaunch({args: process.argv.slice(1) + ['--relaunch']})
+app.exit(0)
+```
+
 ### `app.focus()`
 
 Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. OS X에선, 어플리케이션을 활성화
@@ -370,7 +396,7 @@ npm 모듈 규칙에 따라 대부분의 경우 `package.json`의 `name` 필드
 
 **참고:** 패키징된 앱을 배포할 때, `locales` 폴더도 같이 배포해야 합니다.
 
-**참고:** Windows에선 `ready` 이벤트가 발생한 이후에 이 메서드를 사용해야 합니다.
+**참고:** Windows에선 `ready` 이벤트가 발생한 이후에 이 메서드를 호출해야 합니다.
 
 ### `app.addRecentDocument(path)` _OS X_ _Windows_
 
@@ -445,16 +471,6 @@ Windows에서 사용할 수 있는 JumpList의 [Tasks][tasks] 카테고리에 `t
   아이콘을 가지고 있을 경우, 사용할 아이콘의 인덱스를 이 옵션으로 지정해 주어야 합니다.
   단, 아이콘을 하나만 포함하고 있는 경우 0을 지정하면 됩니다.
 
-### `app.allowNTLMCredentialsForAllDomains(allow)`
-
-* `allow` Boolean
-
-항상 동적으로 HTTP NTLM 또는 Negotiate 인증에 자격 증명을 보낼 것인지 설정합니다.
-
-기본적으로 Electron은 "로컬 인터넷" 사이트 URL에서 NTLM/Kerberos 자격 증명만을
-보냅니다. (같은 도메인 내에서) 그러나 기업 네트워크가 잘못 구성된 경우 종종 작업에
-실패할 수 있습니다. 이때 이 메서드를 통해 모든 URL을 허용할 수 있습니다.
-
 ### `app.makeSingleInstance(callback)`
 
 * `callback` Function
@@ -508,11 +524,18 @@ app.on('ready', () => {
 });
 ```
 
-### `app.setUserActivity(type, userInfo)` _OS X_
+### `app.releaseSingleInstance()`
+
+모든 `makeSingleInstance`에 의해 생성된 제한을 해제합니다. 이 메서드는 다시 여러
+인스턴스의 어플리케이션이 나란히 실행될 수 있도록 합니다.
+
+### `app.setUserActivity(type, userInfo[, webpageURL])` _OS X_
 
 * `type` String - 고유하게 activity를 식별합니다.
   [`NSUserActivity.activityType`][activity-type]을 맵핑합니다.
 * `userInfo` Object - 다른 기기에서 사용하기 위해 저장할 앱-특정 상태.
+* `webpageURL` String - 적당한 앱이 기기에 설치되지 않았을 때 브라우저에서 로드할
+  웹 페이지. 스킴은 반드시 `http` 또는 `https`가 되어야 합니다.
 
 `NSUserActivity`를 만들고 현재 activity에 설정합니다. 이 activity는 이후 다른 기기와
 [Handoff][handoff]할 때 자격으로 사용됩니다.

docs-translations/ko-KR/api/auto-updater.md

@@ -8,6 +8,8 @@
 다음 프로젝트 중 하나를 선택하여, 어플리케이션을 배포하기 위한 멀티-플랫폼 릴리즈
 서버를 손쉽게 구축할 수 있습니다:
 
+- [nuts][nuts]: *어플리케이션을 위한 똑똑한 릴리즈 서버이며 GitHub를 백엔드로
+  사용합니다. Squirrel을 통해 자동 업데이트를 지원합니다. (Mac & Windows)*
 - [electron-release-server][electron-release-server]: *완벽하게 모든 기능을
 지원하는 electron 어플리케이션을 위한 자가 호스트 릴리즈 서버입니다. auto-updater와
 호환됩니다*
@@ -117,3 +119,4 @@ Returns:
 [app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx
 [electron-release-server]: https://github.com/ArekSredzki/electron-release-server
 [squirrel-updates-server]: https://github.com/Aluxian/squirrel-updates-server
+[nuts]: https://github.com/GitbookIO/nuts

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

@@ -36,8 +36,10 @@ win.show();
 
 * `width` Integer - 윈도우의 가로 너비. 기본값은 `800`입니다.
 * `height` Integer - 윈도우의 세로 높이. 기본값은 `600`입니다.
-* `x` Integer - 화면을 기준으로 창 좌측을 오프셋 한 위치. 기본값은 `화면중앙`입니다.
-* `y` Integer - 화면을 기준으로 창 상단을 오프셋 한 위치. 기본값은 `화면중앙`입니다.
+* `x` Integer (**required** y가 사용되면) - 화면을 기준으로 창 좌측을 오프셋 한 위치.
+  기본값은 `화면중앙`입니다.
+* `y` Integer (**required** x가 사용되면) - 화면을 기준으로 창 상단을 오프셋 한 위치.
+  기본값은 `화면중앙`입니다.
 * `useContentSize` Boolean - `width`와 `height`를 웹 페이지의 크기로 사용합니다.
   이 속성을 사용하면 웹 페이지의 크기에 윈도우 프레임 크기가 추가되므로 실제 창은 조금
   더 커질 수 있습니다. 기본값은 `false`입니다.
@@ -61,14 +63,21 @@ win.show();
 * `fullscreen` Boolean - 윈도우의 전체화면 활성화 여부. 이 속성을 명시적으로
   `false`로 지정했을 경우, OS X에선 전체화면 버튼이 숨겨지거나 비활성됩니다. 기본값은
   `false` 입니다.
-* `fullscreenable` Boolean - OS X의 최대화/줌 버튼이 전체화면 모드 또는 윈도우
-  최대화를 토글할 수 있게 할지 여부입니다. 기본값은 `true` 입니다.
+* `fullscreenable` Boolean - 윈도우가 전체화면 모드로 전환될 수 있는지 여부입니다.
+  또한 OS X에선, 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 실행할지 여부도
+  포함됩니다. 기본값은 `true`입니다.
 * `skipTaskbar` Boolean - 작업표시줄 어플리케이션 아이콘 표시 스킵 여부. 기본값은
   `false`입니다.
 * `kiosk` Boolean - Kiosk(키오스크) 모드. 기본값은 `false`입니다.
 * `title` String - 기본 윈도우 제목. 기본값은 `"Electron"`입니다.
 * `icon` [NativeImage](native-image.md) - 윈도우 아이콘, 생략하면 실행 파일의
   아이콘이 대신 사용됩니다.
+* `icon` [NativeImage](native-image.md) - 윈도우 아이콘. Windows에선 가장 좋은
+  시각적 효과를 얻기 위해 `ICO`를 사용하는 것을 권장하며, 또한 undefined로 남겨두면
+  실행 파일의 아이콘이 대신 사용됩니다.
+On Windows it is
+  recommended to use `ICO` icons to get best visual effects, you can also
+  leave it undefined so the executable's icon will be used.
 * `show` Boolean - 윈도우가 생성되면 보여줄지 여부. 기본값은 `true`입니다.
 * `frame` Boolean - `false`로 지정하면 창을 [Frameless Window](frameless-window.md)
   형태로 생성합니다. 기본값은 `true`입니다.
@@ -209,19 +218,17 @@ Returns:
 
 보통 창을 닫아야 할지 결정하기 위해 `beforeunload` 이벤트를 사용하려고 할 것입니다.
 이 이벤트는 윈도우 콘텐츠를 새로고칠 때도 발생합니다.
-Electron에선 빈 문자열 또는 `false`를 전달할 경우 윈도우 종료를 취소합니다.
-
+Electron에선 `undefined`가 아닌 이외의 값을 전달할 경우 윈도우 종료를 취소합니다.
 예시는 다음과 같습니다:
 
 ```javascript
 window.onbeforeunload = (e) => {
   console.log('I do not want to be closed');
 
-  // 반드시 문자열을 반환해야 하고 사용자에게 페이지 언로드에 대한 확인 창을 보여주는
-  // 보통의 브라우저와는 달리 Electron은 개발자에게 더 많은 옵션을 제공합니다.
-  // 빈 문자열을 반환하거나 false를 반환하면 페이지 언로드를 방지합니다.
-  // 또한 dialog API를 통해 사용자에게 어플리케이션을 종료할지에 대한 확인 창을
-  // 보여줄 수도 있습니다.
+  // 일반적인 브라우저와는 달리 사용자에게 확인 창을 보여주지 않고, non-void 값을 반환하면
+  // 조용히 닫기를 취소합니다.
+  // Dialog API를 통해 사용자가 어플리케이션을 종료할지 정할 수 있도록 확인 창을 표시하는 것을
+  // 추천합니다.
   e.returnValue = false;
 };
 ```
@@ -676,7 +683,7 @@ let win = new BrowserWindow({width: 800, height: 600});
 
 **참고:** 웹 페이지의 제목과 네이티브 윈도우의 제목은 서로 다를 수 있습니다.
 
-### `win.setSheetOffset(offset)` _OS X_
+### `win.setSheetOffset(offsetY[, offsetX])` _OS X_
 
 Mac OS X에서 시트를 부착할 위치를 지정합니다. 기본적으로 시트는 윈도우의 프레임 바로
 아래의 위치에 부착됩니다. 아마도 이 기능은 보통 다음과 같이 HTML 렌더링된 툴바 밑에
@@ -861,6 +868,12 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고 
 
 페이지의 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다.
 
+### `win.setIcon(icon)` _Windows_ _Linux_
+
+* `icon` [NativeImage](native-image.md)
+
+윈도우 아이콘을 변경합니다.
+
 ### `win.setAutoHideMenuBar(hide)`
 
 * `hide` Boolean

docs-translations/ko-KR/api/chrome-command-line-switches.md

@@ -22,11 +22,15 @@ app.on('ready', () => {
 
 ## --disable-http-cache
 
-HTTP 요청 캐시를 비활성화 합니다.
+HTTP 요청 캐시를 비활성화합니다.
+
+## --disable-http2
+
+HTTP/2와 SPDY/3.1 프로토콜을 비활성화합니다.
 
 ## --remote-debugging-port=`port`
 
-지정한 `port`에 HTTP 기반의 리모트 디버거를 활성화 시킵니다. (개발자 도구)
+지정한 `port`에 HTTP 기반의 리모트 디버거를 활성화합니다. (개발자 도구)
 
 ## --js-flags=`flags`
 
@@ -91,6 +95,24 @@ resolver, http 프록시 연결의 `CONNECT`, `SOCKS` 프록시 연결의 endpoi
 
 `--host-rules` 플래그와 비슷하지만 이 플래그는 host resolver에만 적용됩니다.
 
+## --auth-server-whitelist=`url`
+
+통합 인증을 사용하도록 설정할 쉼표로 구분된 서버의 리스트.
+
+예를 들어:
+
+```
+--auth-server-whitelist='*example.com, *foobar.com, *baz'
+```
+
+그리고 모든 `example.com`, `foobar.com`, `baz`로 끝나는 `url`은 통합 인증을
+사용하도록 설정됩니다. `*` 접두어가 없다면 url은 정확히 일치해야 합니다.
+
+## --auth-negotiate-delegate-whitelist=`url`
+
+필수적인 사용자 자격 증명을 보내야 할 쉼표로 구분된 서버의 리스트.
+`*` 접두어가 없다면 url은 정확히 일치해야 합니다.
+
 ## --ignore-certificate-errors
 
 인증서 에러를 무시합니다.

docs-translations/ko-KR/api/environment-variables.md

@@ -2,8 +2,8 @@
 
 > 어플리케이션의 구성과 동작을 코드 변경 없이 제어합니다.
 
-Electron의 몇몇 동작은 명령 줄과 어플리케이션의 코드보다 먼저 초기화되어야 하므로 환경
-변수에 의해 작동합니다.
+특정 Electron 동작은 명령줄 플래그와 어플리케이션의 코드보다 먼저 초기화되어야 하므로
+환경 변수에 의해 작동합니다.
 
 POSIX 쉘의 예시입니다:
 
@@ -19,35 +19,35 @@ Windows 콘솔의 예시입니다:
 > electron
 ```
 
-## `ELECTRON_RUN_AS_NODE`
+### `ELECTRON_RUN_AS_NODE`
 
 프로세스를 일반 Node.js 프로세스처럼 시작합니다. (electron 모듈 제외)
 
-## `ELECTRON_ENABLE_LOGGING`
+### `ELECTRON_ENABLE_LOGGING`
 
 Chrome의 내부 로그를 콘솔에 출력합니다.
 
-## `ELECTRON_LOG_ASAR_READS`
+### `ELECTRON_LOG_ASAR_READS`
 
 Electron이 ASAR 파일을 읽을 때, 읽기 오프셋의 로그를 남기고 시스템 `tmpdir`에 파일로
 저장합니다. 결과 파일은 ASAR 모듈의 파일 순서를 최적화 하는데 사용할 수 있습니다.
 
-## `ELECTRON_ENABLE_STACK_DUMPING`
+### `ELECTRON_ENABLE_STACK_DUMPING`
 
 Electron이 크래시되면, 콘솔에 stack trace를 출력합니다.
 
 이 환경 변수는 `crashReporter`가 시작되지 않았을 경우 작동하지 않습니다.
 
-## `ELECTRON_DEFAULT_ERROR_MODE` _Windows_
+### `ELECTRON_DEFAULT_ERROR_MODE` _Windows_
 
-Electron이 크래시되면, 크래시 정보 창을 표시합니다.
+Electron이 크래시되면 스택 출력 정보를 콘솔에 출력합니다.
 
 이 환경 변수는 `crashReporter`가 시작되지 않았을 경우 작동하지 않습니다.
 
-## `ELECTRON_NO_ATTACH_CONSOLE` _Windows_
+### `ELECTRON_NO_ATTACH_CONSOLE` _Windows_
 
 현재 콘솔 세션에 소속시키지 않습니다.
 
-## `ELECTRON_FORCE_WINDOW_MENU_BAR` _Linux_
+### `ELECTRON_FORCE_WINDOW_MENU_BAR` _Linux_
 
 Linux의 전역 메뉴바를 사용하지 않습니다.

docs-translations/ko-KR/api/native-image.md

@@ -25,7 +25,13 @@ const appIcon = new Tray(image);
 현재 `PNG` 와 `JPEG` 이미지 포맷을 지원하고 있습니다.
 손실 없는 이미지 압축과 투명도 지원을 위해 `PNG` 사용을 권장합니다.
 
-그리고 Windows에서는 `ICO` 포맷도 사용할 수 있습니다.
+Windows에서는 파일 경로로부터 `ICO` 포맷도 사용할 수 있으며, 가장 좋은 시각적 효과를
+얻기 위해 최소한 아이콘에 다음 사이즈를 포함하는 것을 권장합니다:
+
+* 16x16
+* 32x32
+* 64x64
+* 256x256
 
 ## 고해상도 이미지