Browse Source

Merge pull request #7342 from tinydew4/update-changes

Update changes to korean docs.
Zeke Sikelianos 8 years ago
parent
commit
90c5972fce

+ 13 - 13
docs-translations/ko-KR/README.md

@@ -1,19 +1,18 @@
-반드시 사용하는 Electron 버전과 문서 버전을 일치시켜야 합니다. 버전 숫자는 문서 페이지
-URL에 포함되어 있습니다. 만약 그렇지 않다면, 아마 현재 보고 있는 문서는 개발 중인
-브랜치의 문서를 보고 있을 가능성이 있으며 해당 문서는 추후 API의 변경 가능성이 있고
-현재 사용하고 있는 Electron의 버전과 호환되지 않을 수 있습니다. 이 경우 atom.io의
-[사용할 수 있는 버전](http://electron.atom.io/docs/) 목록에서 다른 버전으로 변경할
-수 있습니다. 또한 GitHub 인터페이스의 "Switch branches/tags" 드롭다운 메뉴에서도
-사용 중인 Electron 버전으로 변경할 수 있습니다.
-
-**역자주:** 한국어 번역 문서는 `atom.io`에 반영되어 있지 않습니다. 한국어 번역 문서는
-현재 `upstream` 원본 문서의 변경에 따라 최대한 문서의 버전을 맞추려고 노력하고 있지만
-가끔 누락된 번역이 존재할 수 있습니다.
+반드시 사용하는 Electron 버전과 문서 버전을 일치시켜야 합니다. 버전 숫자는 문서
+페이지 URL에 포함되어 있습니다. 만약 그렇지 않다면, 아마 개발 브랜치의 문서일
+것이며 당신의 Electron 버전과 호환되지 않는 API 변경을 포함할 것 입니다.
+이전 버전 문서는 깃허브에서 [태그로 열어]
+(https://github.com/electron/electron/tree/v1.4.0) 볼 수 있습니다.
+"branches/tags 변경" 드롭다운을 열고 해당 버전의 태그를 선택하세요.
+
+**역자주:** 한국어 번역 문서는 `atom.io`에 반영되어 있지 않습니다. 한국어 번역
+문서는 현재 `upstream` 원본 문서의 변경에 따라 최대한 문서의 버전을 맞추려고
+노력하고 있지만 가끔 누락된 번역이 존재할 수 있습니다.
 
 ## FAQ
 
-Electron에 대해 자주 묻는 질문이 있습니다. 이슈를 생성하기 전에 다음 문서를 먼저
-확인해 보세요:
+Electron에 대해 자주 묻는 질문이 있습니다. 이슈를 생성하기 전에 다음 문서를
+먼저 확인해 보세요:
 
 * [Electron FAQ](faq.md)
 
@@ -100,3 +99,4 @@ Electron에 대해 자주 묻는 질문이 있습니다. 이슈를 생성하기
 * [디버그 설명서 (macOS)](development/debug-instructions-macos.md)
 * [디버그 설명서 (Windows)](development/debug-instructions-windows.md)
 * [디버거 심볼 서버 설정](development/setting-up-symbol-server.md)
+* [문서 스타일가이드](styleguide.md)

+ 6 - 1
docs-translations/ko-KR/api/app.md

@@ -272,7 +272,12 @@ app.on('login', (event, webContents, request, authInfo, callback) => {
 
 ### Event: 'gpu-process-crashed'
 
-GPU가 작동하던 중 크래시가 일어났을 때 발생하는 이벤트입니다.
+Returns:
+
+* `event` Event
+* `killed` Boolean
+
+GPU 처리가 충돌하거나 종료되었을 때 발생하는 이벤트입니다.
 
 ### Event: 'accessibility-support-changed' _macOS_ _Windows_
 

+ 5 - 1
docs-translations/ko-KR/api/browser-window.md

@@ -438,6 +438,10 @@ someWindow.on('app-command', (e, cmd) => {
 
 스크롤 휠 이벤트가 동작을 멈췄을 때 발생하는 이벤트입니다.
 
+#### Event: 'scroll-touch-edge' _macOS_
+
+스크롤 휠 이벤트로 요소의 끝에 도달했을 때 발생하는 이벤트입니다.
+
 #### Event: 'swipe' _macOS_
 
 Returns:
@@ -955,7 +959,7 @@ win.loadURL(url)
 
 * `progress` Double
 * `options` Object (optional)
-  * `mode` String _Windows_ - 프로그스 막대의 모드 (`none`, `normal`,
+  * `mode` String _Windows_ - 프로그스 막대의 모드 (`none`, `normal`,
     `indeterminate`, `error`, `paused`)
 
 작업표시줄에 표시되고 있는 애플리케이션 아이콘에 진행 상태를 표시합니다. [0, 1.0]

+ 27 - 0
docs-translations/ko-KR/api/environment-variables.md

@@ -19,6 +19,33 @@ Windows 콘솔의 예시입니다:
 > electron
 ```
 
+## 제품 변수
+
+다음 환경 변수는 Electron 애플리케이션 패키지 실행에 우선적으로 사용된다.
+
+### `GOOGLE_API_KEY`
+
+Electron 은 하드코딩 된 구글의 위치정보 웹서비스 요청을 위한 API 키를 포함하고
+있습니다. 이 API 키가 모든 버전의 Electron 에 포함되어 있기 때문에 종종
+사용량을 초과합니다. 이 문제를 해결하기 위해 자신의 구글 API 키를 사용할 수
+있습니다. 메인 프로세스 파일에 다음 코드를 위치정보 요청이 있는 브라우저를 열기
+전에 넣어주세요.
+
+```javascript
+process.env.GOOGLE_API_KEY = 'YOUR_KEY_HERE'
+```
+
+구글 API 키를 획득하는 방법은 다음 페이지를 참고하세요.
+https://www.chromium.org/developers/how-tos/api-keys
+
+기본적으로, 새로 생성된 구글 API 키는 위치정보 요청이 허용되지 않습니다.
+위치정보 요청을 사용하려면 다음 페이지를 방문하세요:
+https://console.developers.google.com/apis/api/geolocation/overview
+
+## 개발 변수
+
+다음 환경 변수는 개발과 디버깅시 우선적으로 사용된다.
+
 ### `ELECTRON_RUN_AS_NODE`
 
 프로세스를 일반 Node.js 프로세스처럼 시작합니다. (electron 모듈 제외)

+ 5 - 4
docs-translations/ko-KR/api/power-monitor.md

@@ -1,4 +1,4 @@
-# powerMonitor
+# powerMonitor
 
 > 파워의 상태 변경을 모니터링합니다.
 
@@ -8,10 +8,11 @@
 예시:
 
 ```javascript
-const {app} = require('electron');
+const electron = require('electron');
+const {app} = electron;
 
 app.on('ready', () => {
-  require('electron').powerMonitor.on('suspend', () => {
+  electron.powerMonitor.on('suspend', () => {
     console.log('절전모드로 진입합니다!');
   });
 });
@@ -19,7 +20,7 @@ app.on('ready', () => {
 
 ## Events
 
-`power-monitor` 모듈은 다음과 같은 이벤트를 가지고 있습니다:
+`powerMonitor` 모듈은 다음과 같은 이벤트를 가지고 있습니다:
 
 ## Event: `suspend`
 

+ 7 - 4
docs-translations/ko-KR/api/protocol.md

@@ -1,4 +1,4 @@
-# protocol
+# protocol
 
 > 커스텀 프로토콜을 등록하거나 이미 존재하능 프로토콜의 요청의 동작을 변경합니다.
 
@@ -85,11 +85,14 @@ app.on('ready', () => {
   * `uploadData` Array (optional)
 * `callback` Function
 
-The `uploadData` is an array of `data` objects:
+`uploadData` 는 `data` 객체의 배열입니다:
 
 * `data` Object
-  * `bytes` Buffer - Content being sent.
-  * `file` String - Path of file being uploaded.
+  * `bytes` Buffer - 전송될 콘텐츠.
+  * `file` String - 업로드될 파일의 경로.
+  * `blobUUID` String - blob 데이터의 UUID. 데이터를 이용하기 위해
+    [ses.getBlobData](session.md#sesgetblobdataidentifier-callback) 메소드를
+    사용하세요.
 
 `request`를 처리할 때 반드시 파일 경로 또는 `path` 속성을 포함하는 객체를 인수에
 포함하여 `callback`을 호출해야 합니다. 예: `callback(filePath)` 또는

+ 3 - 3
docs-translations/ko-KR/api/screen.md

@@ -1,9 +1,9 @@
-# screen
+# screen
 
 > 화면 크기, 디스플레이, 커서 위치 등의 정보를 가져옵니다.
 
-이 모듈은 `app` 모듈의 `ready` 이벤트가 발생하기 전까지 사용할 수 없습니다. (호출 또는
-모듈 포함)
+이 모듈은 `app` 모듈의 `ready` 이벤트가 발생하기 전까지 포함하거나 사용할 수
+없습니다.
 
 `screen`은 [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter)를
 상속 받았습니다.

+ 11 - 0
docs-translations/ko-KR/api/session.md

@@ -323,6 +323,14 @@ session.defaultSession.allowNTLMCredentialsForDomains('*')
 
 현재 세션의 유저 에이전트를 표현하는 `String`을 반환합니다.
 
+#### `ses.getBlobData(identifier, callback)`
+
+* `identifier` String - Valid UUID.
+* `callback` Function
+  * `result` Buffer - Blob data.
+
+`identifier` 에 연결된 blob 데이터를 반환합니다.
+
 ### Instance Properties
 
 다음은 `Session` 인스턴스에서 사용할 수 있는 속성들입니다:
@@ -505,6 +513,9 @@ session.defaultSession.webRequest.onBeforeSendHeaders(filter, (details, callback
 * `data` Object
   * `bytes` Buffer - 전송될 콘텐츠.
   * `file` String - 업로드될 파일의 경로.
+  * `blobUUID` String - blob 데이터의 UUID. 데이터를 이용하기 위해
+    [ses.getBlobData](session.md#sesgetblobdataidentifier-callback) 메소드를
+    사용하세요.
 
 `callback`은 `response` 객체와 함께 호출되어야 합니다:
 

+ 12 - 2
docs-translations/ko-KR/api/web-contents.md

@@ -135,7 +135,7 @@ Returns:
 * `url` String
 * `frameName` String
 * `disposition` String - `default`, `foreground-tab`, `background-tab`,
-  `new-window`, `other`중 하나일 수 있습니다.
+  `new-window`, `save-to-disk`, `other`중 하나일 수 있습니다.
 * `options` Object - 새로운 `BrowserWindow` 객체를 만들 때 사용되는 옵션 객체입니다.
 
 페이지가 `url`에 대하여 새로운 윈도우를 열기위해 요청한 경우 발생하는 이벤트입니다.
@@ -191,7 +191,12 @@ Returns:
 
 #### Event: 'crashed'
 
-렌더러 프로세스가 예기치 못하게 종료되었을 때 발생되는 이벤트입니다.
+Returns:
+
+* `event` Event
+* `killed` Boolean
+
+렌더러 프로세스가 충돌하거나 종료될 때 발생되는 이벤트입니다.
 
 #### Event: 'plugin-crashed'
 
@@ -1106,6 +1111,11 @@ win.webContents.on('did-finish-load', () => {
 
 *오프 스크린 렌더링* 이 활성화된 경우 현재 프레임 레이트를 반환합니다.
 
+#### `contents.invalidate()`
+
+*오프 스크린 렌더링* 이 활성화된 경우 프레임을 무효화 하고 `'paint'` 이벤트를
+통해 새로 만듭니다.
+
 ### Instance Properties
 
 #### `contents.id`

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

@@ -1,4 +1,4 @@
-# `<webview>` 태그
+# `<webview>` 태그
 
 > 외부 웹 콘텐츠를 고립된 프레임과 프로세스에서 표시합니다.
 
@@ -207,6 +207,20 @@ API를 사용할 수 있습니다. 이를 지정하면 내부에서 로우레벨
 문자열의 전체 목록은 [RuntimeEnabledFeatures.in][blink-feature-string] 파일에서
 찾을 수 있습니다.
 
+### `guestinstance`
+
+```html
+<webview src="https://www.github.com/" guestinstance="3"></webview>
+```
+
+webview 를 특정 webContents 와 연결해주는 값 입니다. webview 가 처음 로드될 때
+새 webContents 가 생성되고 이 속성이 그 인스턴스의 식별자로 설정됩니다. 새로운
+또는 기존 webview 에 이 속성을 설정하면 다른 webview 에서 현재 렌더링하는 기존
+webContents 와 연결합니다.
+
+기존 webview 는 `destroy` 이벤트가 발생하고 새 URL 이 로드될 때 새 webContens
+가 생성될 것 입니다.
+
 ## Methods
 
 `webview` 태그는 다음과 같은 메서드를 가지고 있습니다:
@@ -656,7 +670,7 @@ Returns:
 * `url` String
 * `frameName` String
 * `disposition` String - `default`, `foreground-tab`, `background-tab`,
-  `new-window`, `other`를 사용할 수 있습니다.
+  `new-window`, `save-to-disk`, `other`를 사용할 수 있습니다.
 * `options` Object - 새로운 `BrowserWindow`를 만들 때 사용되어야 하는 옵션.
 
 페이지가 새로운 브라우저 창을 생성할 때 발생하는 이벤트입니다.

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

@@ -241,17 +241,17 @@ __Audacious의 런처 숏컷:__
 
 ![audacious](https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png)
 
-## 작업 표시줄 안의 프로그스 바 (Windows, macOS, Unity)
+## 작업 표시줄 안의 프로그스 바 (Windows, macOS, Unity)
 
-Windows에선 작업 표시줄의 애플리케이션 버튼에 프로그스 바를 추가할 수 있습니다.
+Windows에선 작업 표시줄의 애플리케이션 버튼에 프로그스 바를 추가할 수 있습니다.
 이 기능은 사용자가 애플리케이션의 창을 열지 않고도 애플리케이션의 작업의 상태 정보를
 시각적으로 보여줄 수 있도록 해줍니다.
 
-macOS에선 프로그스바가 dock 아이콘의 일부에 표시됩니다.
+macOS에선 프로그스바가 dock 아이콘의 일부에 표시됩니다.
 
-또한 Unity DE도 런처에 프로그스 바를 부착할 수 있습니다.
+또한 Unity DE도 런처에 프로그스 바를 부착할 수 있습니다.
 
-__작업 표시줄 버튼의 프로그스 바:__
+__작업 표시줄 버튼의 프로그스 바:__
 
 ![Taskbar Progress Bar](https://cloud.githubusercontent.com/assets/639601/5081682/16691fda-6f0e-11e4-9676-49b6418f1264.png)
 

+ 1 - 0
docs-translations/ko-KR/tutorial/using-native-node-modules.md

@@ -20,6 +20,7 @@ Node의 버전과 전혀 다른 V8 버전을 사용하고 있을 가능성이 
 export npm_config_target=1.2.3
 # Electron의 아키텍쳐, ia32 또는 x64가 될 수 있습니다.
 export npm_config_arch=x64
+export npm_config_target_arch=x64
 # Electron에 대한 헤더 다운로드 링크.
 export npm_config_disturl=https://atom.io/download/atom-shell
 # node-pre-gyp에 Electron을 빌드한다는 것을 알려줍니다.