diff --git a/docs-translations/ko-KR/README.md b/docs-translations/ko-KR/README.md index 1f898f45fa89..537df5914d3f 100644 --- a/docs-translations/ko-KR/README.md +++ b/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 버전으로 변경할 수 있습니다. +반드시 사용하는 Electron 버전과 문서 버전을 일치시켜야 합니다. 버전 숫자는 문서 +페이지 URL에 포함되어 있습니다. 만약 그렇지 않다면, 아마 개발 브랜치의 문서일 +것이며 당신의 Electron 버전과 호환되지 않는 API 변경을 포함할 것 입니다. +이전 버전 문서는 깃허브에서 [태그로 열어] +(https://github.com/electron/electron/tree/v1.4.0) 볼 수 있습니다. +"branches/tags 변경" 드롭다운을 열고 해당 버전의 태그를 선택하세요. -**역자주:** 한국어 번역 문서는 `atom.io`에 반영되어 있지 않습니다. 한국어 번역 문서는 -현재 `upstream` 원본 문서의 변경에 따라 최대한 문서의 버전을 맞추려고 노력하고 있지만 -가끔 누락된 번역이 존재할 수 있습니다. +**역자주:** 한국어 번역 문서는 `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) diff --git a/docs-translations/ko-KR/api/app.md b/docs-translations/ko-KR/api/app.md index d97881cf4460..682094529358 100644 --- a/docs-translations/ko-KR/api/app.md +++ b/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_ diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index 5a32aad1839e..0f0b67211acc 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/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] diff --git a/docs-translations/ko-KR/api/environment-variables.md b/docs-translations/ko-KR/api/environment-variables.md index d497edc4c8b1..8db1406653d5 100644 --- a/docs-translations/ko-KR/api/environment-variables.md +++ b/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 모듈 제외) diff --git a/docs-translations/ko-KR/api/power-monitor.md b/docs-translations/ko-KR/api/power-monitor.md index 860ac5eecbd4..2858a147e277 100644 --- a/docs-translations/ko-KR/api/power-monitor.md +++ b/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` diff --git a/docs-translations/ko-KR/api/protocol.md b/docs-translations/ko-KR/api/protocol.md index 25aaf9ce7284..50ee2ec92aa0 100644 --- a/docs-translations/ko-KR/api/protocol.md +++ b/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)` 또는 diff --git a/docs-translations/ko-KR/api/screen.md b/docs-translations/ko-KR/api/screen.md index ff5923045339..e5822f8746e4 100644 --- a/docs-translations/ko-KR/api/screen.md +++ b/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)를 상속 받았습니다. diff --git a/docs-translations/ko-KR/api/session.md b/docs-translations/ko-KR/api/session.md index 4925669abf64..e10bd71d5a3e 100644 --- a/docs-translations/ko-KR/api/session.md +++ b/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` 객체와 함께 호출되어야 합니다: diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index 2a36e188aa3d..347d8775db41 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/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` diff --git a/docs-translations/ko-KR/api/web-view-tag.md b/docs-translations/ko-KR/api/web-view-tag.md index a5ca65eb360c..c372e5e9b56c 100644 --- a/docs-translations/ko-KR/api/web-view-tag.md +++ b/docs-translations/ko-KR/api/web-view-tag.md @@ -1,4 +1,4 @@ -# `` 태그 +# `` 태그 > 외부 웹 콘텐츠를 고립된 프레임과 프로세스에서 표시합니다. @@ -207,6 +207,20 @@ API를 사용할 수 있습니다. 이를 지정하면 내부에서 로우레벨 문자열의 전체 목록은 [RuntimeEnabledFeatures.in][blink-feature-string] 파일에서 찾을 수 있습니다. +### `guestinstance` + +```html + +``` + +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`를 만들 때 사용되어야 하는 옵션. 페이지가 새로운 브라우저 창을 생성할 때 발생하는 이벤트입니다. diff --git a/docs-translations/ko-KR/tutorial/desktop-environment-integration.md b/docs-translations/ko-KR/tutorial/desktop-environment-integration.md index bf68f51e08e9..a07817cf460a 100644 --- a/docs-translations/ko-KR/tutorial/desktop-environment-integration.md +++ b/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) diff --git a/docs-translations/ko-KR/tutorial/using-native-node-modules.md b/docs-translations/ko-KR/tutorial/using-native-node-modules.md index fb503679c04b..20f0036172ef 100644 --- a/docs-translations/ko-KR/tutorial/using-native-node-modules.md +++ b/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을 빌드한다는 것을 알려줍니다.