📝 Update Korean docs as upstream

[ci skip]
This commit is contained in:
Plusb Preco 2016-06-13 03:42:26 +09:00
parent bab8f6f60f
commit 68e99be9f6
5 changed files with 88 additions and 24 deletions

View file

@ -351,6 +351,7 @@ Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. OS X에
* `music` - 사용자의 음악 디렉터리. * `music` - 사용자의 음악 디렉터리.
* `pictures` - 사용자의 사진 디렉터리. * `pictures` - 사용자의 사진 디렉터리.
* `videos` - 사용자의 동영상 디렉터리. * `videos` - 사용자의 동영상 디렉터리.
* `pepperFlashSystemPlugin` - 시스템 버전의 Pepper Flash 플러그인의 전체 경로.
### `app.setPath(name, path)` ### `app.setPath(name, path)`

View file

@ -2,49 +2,70 @@
> 원격 소스로부터의 파일 다운로드를 제어합니다. > 원격 소스로부터의 파일 다운로드를 제어합니다.
`DownloadItem`은 EventEmitter를 상속받았으며 Electron의 다운로드 아이템을 표현합니다. `DownloadItem``EventEmitter`를 상속받았으며 Electron의 다운로드 아이템을
이 클래스 객체는 `Session` 모듈`will-download` 이벤트에 사용되며 사용자가 다운로드 표현합니다. 이 클래스 객체는 `Session` 클래스`will-download` 이벤트에 사용되며
아이템을 다룰 수 있도록 도와줍니다. 사용자가 다운로드 아이템을 다룰 수 있도록 도와줍니다.
```javascript ```javascript
// 메인 프로세스 // 메인 프로세스
win.webContents.session.on('will-download', (event, item, webContents) => { win.webContents.session.on('will-download', (event, item, webContents) => {
// Set the save path, making Electron not to prompt a save dialog. // Set the save path, making Electron not to prompt a save dialog.
item.setSavePath('/tmp/save.pdf'); item.setSavePath('/tmp/save.pdf')
console.log(item.getMimeType());
console.log(item.getFilename()); item.on('updated', (event, state) => {
console.log(item.getTotalBytes()); if (state === 'interrupted') {
item.on('updated', () => { console.log('Download is interrupted but can be resumed')
console.log('Received bytes: ' + item.getReceivedBytes()); } else if (state === 'progressing') {
}); if (item.isPaused()) {
item.on('done', (e, state) => { console.log('Download is paused')
if (state === 'completed') { } else {
console.log('Download successfully'); console.log(`Received bytes: ${item.getReceivedBytes()}`)
} else { }
console.log('Download is cancelled or interrupted that can\'t be resumed');
} }
}); })
}); item.once('done', (event, state) => {
if (state === 'completed') {
console.log('Download successfully')
} else {
console.log(`Download failed: ${state}`)
}
})
})
``` ```
## Events ## Events
### Event: 'updated' ### Event: 'updated'
`downloadItem`이 갱신될 때 발생하는 이벤트입니다. Returns:
### Event: 'done' * `event` Event
* `state` String
다운로드가 업데이트되었으며 아직 끝나지 않았을 때 발생하는 이벤트입니다.
`state`는 다음 중 하나가 될 수 있습니다:
* `progressing` - 다운로드가 진행중입니다.
* `interrupted` - 다운로드가 중지되었으며 다시 재개할 수 있습니다.
### Event: 'done'
Returns:
* `event` Event * `event` Event
* `state` String * `state` String
* `completed` - 다운로드가 성공적으로 완료되었습니다.
* `cancelled` - 다운로드가 취소되었습니다.
* `interrupted` - 다운로드 중 파일 서버로부터의 연결이 끊겼습니다.
다운로드가 종료될 때 발생하는 이벤트입니다. 이 이벤트는 다운로드 중 문제가 발생하여 다운로드가 종료될 때 발생하는 이벤트입니다. 이 이벤트는 다운로드 중 문제가 발생하여
중단되거나, 모두 성공적으로 완료된 경우, `downloadItem.cancel()` 같은 메서드를 통해 중단되거나, 모두 성공적으로 완료된 경우, `downloadItem.cancel()` 같은 메서드를 통해
취소하는 경우의 종료 작업이 모두 포함됩니다. 취소하는 경우의 종료 작업이 모두 포함됩니다.
`state`는 다음 중 하나가 될 수 있습니다:
* `completed` - 다운로드가 성공적으로 완료되었습니다.
* `cancelled` - 다운로드가 취소되었습니다.
* `interrupted` - 다운로드가 중지되었으며 다시 재개할 수 있습니다.
## Methods ## Methods
`downloadItem` 객체는 다음과 같은 메서드를 가지고 있습니다: `downloadItem` 객체는 다음과 같은 메서드를 가지고 있습니다:
@ -61,10 +82,18 @@ win.webContents.session.on('will-download', (event, item, webContents) => {
다운로드를 일시 중지합니다. 다운로드를 일시 중지합니다.
### `downloadItem.isPaused()`
다운로드가 일시 중지되었는지 여부를 반환합니다.
### `downloadItem.resume()` ### `downloadItem.resume()`
중디된 다운로드를 재개합니다. 중디된 다운로드를 재개합니다.
### `downloadItem.canResume()`
다운로드를 재개할 수 있는지 여부를 반환합니다.
### `downloadItem.cancel()` ### `downloadItem.cancel()`
다운로드를 취소합니다. 다운로드를 취소합니다.
@ -101,3 +130,14 @@ win.webContents.session.on('will-download', (event, item, webContents) => {
### `downloadItem.getContentDisposition()` ### `downloadItem.getContentDisposition()`
응답 헤더에서 Content-Disposition 필드를 문자열로 반환합니다. 응답 헤더에서 Content-Disposition 필드를 문자열로 반환합니다.
### `downloadItem.getState()`
현재 상태를 `String` 타입으로 가져옵니다.
값은 다음이 될 수 있습니다:
* `progressing` - 다운로드가 진행중입니다.
* `completed` - 다운로드가 성공적으로 완료되었습니다.
* `cancelled` - 다운로드가 취소되었습니다.
* `interrupted` - 다운로드가 중지되었습니다.

View file

@ -539,3 +539,23 @@ HTTP 요청을 보내기 전 요청 헤더를 사용할 수 있을 때 `listener
* `timestamp` Double * `timestamp` Double
* `fromCache` Boolean * `fromCache` Boolean
* `error` String - 에러 설명. * `error` String - 에러 설명.
#### `ses.protocol`
현재 세션의 [protocol](protocol.md) 모듈 인스턴스를 반환합니다.
```javascript
const {app, session} = require('electron')
const path = require('path')
app.on('ready', function () {
const protocol = session.fromPartition(partitionName).protocol
protocol.registerFileProtocol('atom', function (request, callback) {
var url = request.url.substr(7)
callback({path: path.normalize(__dirname + '/' + url)})
}, function (error) {
if (error)
console.error('Failed to register protocol')
})
})
```

View file

@ -8,7 +8,7 @@ Electron은 프로젝트 생성을 위해 [gyp](https://gyp.gsrc.io/)를 사용
Electron을 빌드 할 때 `gyp` 파일들은 다음과 같은 규칙을 따릅니다: Electron을 빌드 할 때 `gyp` 파일들은 다음과 같은 규칙을 따릅니다:
* `atom.gyp`는 Electron의 빌드 과정 자체를 정의합니다. * `electron.gyp`는 Electron의 빌드 과정 자체를 정의합니다.
* `common.gypi`는 Node가 Chromium과 함께 빌드될 수 있도록 조정한 빌드 설정입니다. * `common.gypi`는 Node가 Chromium과 함께 빌드될 수 있도록 조정한 빌드 설정입니다.
* `vendor/brightray/brightray.gyp``brightray`의 빌드 과정을 정의하고 Chromium * `vendor/brightray/brightray.gyp``brightray`의 빌드 과정을 정의하고 Chromium
링킹에 대한 기본적인 설정을 포함합니다. 링킹에 대한 기본적인 설정을 포함합니다.

View file

@ -39,6 +39,9 @@ app.on('ready', () => {
}); });
``` ```
`app.getPath('pepperFlashSystemPlugin')` 형태로 호출하면 시스템에 설치된 Pepper
Flash 플러그인의 경로를 가져올 수도 있습니다.
## `<webview>` 태그를 이용하여 플러그인을 활성화 ## `<webview>` 태그를 이용하여 플러그인을 활성화
`plugins` 속성을 `<webview>` 태그에 추가합니다. `plugins` 속성을 `<webview>` 태그에 추가합니다.