Translate some apis

This commit is contained in:
Plusb Preco 2015-07-01 03:42:29 +09:00
parent fcf4da1097
commit 783e4bc591
8 changed files with 61 additions and 73 deletions

View file

@ -34,7 +34,7 @@ npm install electron-prebuilt --save-dev
## 참조문서 ## 참조문서
[docs](https://github.com/atom/electron/tree/master/docs/README-ko.md) 에 프레임워크 사용 가이드와 API 레퍼런스가 있습니다. [docs](https://github.com/atom/electron/tree/master/docs/README-ko.md) 에 프레임워크 사용 가이드와 API 레퍼런스가 있습니다.
또한, Electron을 빌드 하는 방법과 프로젝트에 기여하는 방법 문서에 포함되어 있으니 참고바랍니다. 추가적으로 Electron을 빌드 하는 방법과 프로젝트에 기여하는 방법 문서에 포함되어 있으니 참고하기 바랍니다.
## 커뮤니티 ## 커뮤니티

View file

@ -2,7 +2,7 @@
**This module has only been implemented for OS X.** **This module has only been implemented for OS X.**
Check out [atom/grunt-atom-shell-installer](https://github.com/atom/grunt-atom-shell-installer) Check out [atom/grunt-electron-installer](https://github.com/atom/grunt-electron-installer)
for building a Windows installer for your app. for building a Windows installer for your app.
The `auto-updater` module is a simple wrap around the The `auto-updater` module is a simple wrap around the

View file

@ -1113,9 +1113,9 @@ win.webContents.on('did-finish-load', function() {
* `secure` Boolean - Whether the cookie is marked as Secure (typically HTTPS) * `secure` Boolean - Whether the cookie is marked as Secure (typically HTTPS)
* `http_only` Boolean - Whether the cookie is marked as HttpOnly * `http_only` Boolean - Whether the cookie is marked as HttpOnly
* `session` Boolean - Whether the cookie is a session cookie or a persistent * `session` Boolean - Whether the cookie is a session cookie or a persistent
* cookie with an expiration date. cookie with an expiration date.
* `expirationDate` Double - (Option) The expiration date of the cookie as * `expirationDate` Double - (Option) The expiration date of the cookie as
the number of seconds since the UNIX epoch. Not provided for session cookies. the number of seconds since the UNIX epoch. Not provided for session cookies.
### WebContents.session.cookies.set(details, callback) ### WebContents.session.cookies.set(details, callback)

View file

@ -1,15 +1,13 @@
# clipboard # clipboard
The `clipboard` provides methods to do copy/paste operations. An example of `clipboard`는 복사/붙여넣기 작업을 수행하는 방법을 제공합니다. 다음 예제는 클립보드에 문자열을 씁니다:
writing a string to clipboard:
```javascript ```javascript
var clipboard = require('clipboard'); var clipboard = require('clipboard');
clipboard.writeText('Example String'); clipboard.writeText('Example String');
``` ```
On X Window systems, there is also a selection clipboard, to manipulate in it X Window 시스템에선 selection 클립보드도 존재합니다. 이를 사용하려면 인자 뒤에 `selection` 문자열을 같이 지정해주어야 합니다:
you need to pass `selection` to each method:
```javascript ```javascript
var clipboard = require('clipboard'); var clipboard = require('clipboard');
@ -21,70 +19,70 @@ console.log(clipboard.readText('selection'));
* `type` String * `type` String
Returns the content in clipboard as plain text. 클립보드 컨텐츠를 `plain text`로 반환합니다.
## clipboard.writeText(text[, type]) ## clipboard.writeText(text[, type])
* `text` String * `text` String
* `type` String * `type` String
Writes the `text` into clipboard as plain text. 클립보드에 `plain text`로 문자열을 씁니다.
## clipboard.readHtml([type]) ## clipboard.readHtml([type])
* `type` String * `type` String
Returns the content in clipboard as markup. 클립보드 컨텐츠를 `markup`으로 반환합니다.
## clipboard.writeHtml(markup[, type]) ## clipboard.writeHtml(markup[, type])
* `markup` String * `markup` String
* `type` String * `type` String
Writes the `markup` into clipboard. 클립보드에 `markup`으로 씁니다.
## clipboard.readImage([type]) ## clipboard.readImage([type])
* `type` String * `type` String
Returns the content in clipboard as [NativeImage](native-image.md). 클립보드로부터 [NativeImage](native-image.md)로 이미지를 읽어들입니다.
## clipboard.writeImage(image[, type]) ## clipboard.writeImage(image[, type])
* `image` [NativeImage](native-image.md) * `image` [NativeImage](native-image.md)
* `type` String * `type` String
Writes the `image` into clipboard. 클립보드에 `image`를 씁니다.
## clipboard.clear([type]) ## clipboard.clear([type])
* `type` String * `type` String
Clears everything in clipboard. 클립보드에 저장된 모든 컨텐츠를 삭제합니다.
## clipboard.availableFormats([type]) ## clipboard.availableFormats([type])
Returns an array of supported `format` for the clipboard `type`. 클립보드의 `type`에 해당하는 지원하는 `format`을 문자열로 반환합니다.
## clipboard.has(data[, type]) ## clipboard.has(data[, type])
* `data` String * `data` String
* `type` String * `type` String
Returns whether clipboard supports the format of specified `data`. 클립보드가 지정한 `data`의 형식을 지원하는지 확인합니다.
```javascript ```javascript
var clipboard = require('clipboard'); var clipboard = require('clipboard');
console.log(clipboard.has('<p>selection</p>')); console.log(clipboard.has('<p>selection</p>'));
``` ```
**Note:** This API is experimental and could be removed in future. **알림:** 이 API는 실험적인 기능이며 차후 최신버전에서 제외될 수 있습니다.
## clipboard.read(data[, type]) ## clipboard.read(data[, type])
* `data` String * `data` String
* `type` String * `type` String
Reads the `data` in clipboard. 클립보드로부터 `data`를 읽어들입니다.
**Note:** This API is experimental and could be removed in future. **알림:** 이 API는 실험적인 기능이며 차후 최신버전에서 제외될 수 있습니다.

View file

@ -1,11 +1,9 @@
# `File` object # `File` 객체
The DOM's File interface provides abstraction around native files, in order to DOM의 File 인터페이스는 네이티브 파일을 추상화 합니다. 유저가 직접적으로 HTML5 File API를 사용하여 작업할 때 파일의 경로를
let users work on native files directly with HTML5 file API, Electron has 알 수 있도록 Electron은 파일시스템의 실제 파일 경로를 담은 `path` 속성을 File 인터페이스에 추가하였습니다.
added a `path` attribute to `File` interface which exposes the file's real path
on filesystem.
Example on getting real path of a dragged file: 다음 예제는 drag n drop한 파일의 실제 경로를 가져옵니다:
```html ```html
<div id="holder"> <div id="holder">

View file

@ -23,16 +23,11 @@ var appIcon = new Tray(image);
## 고해상도 이미지 ## 고해상도 이미지
On platforms that have high-DPI support, you can append `@2x` after image's 플랫폼이 high-DPI를 지원하는 경우 `@2x`와 같이 이미지의 파일명 뒤에 접미사를 추가하여 고해상도 이미지로 지정할 수 있습니다.
file name's base name to mark it as a high resolution image.
For example if `icon.png` is a normal image that has standard resolution, the 예를 들어 `icon.png` 라는 기본 해상도의 이미지를 기준으로 크기를 두 배로 늘린 이미지를 `icon@2x.png`와 같이 이름을 지정하면 고해상도 이미지로 처리됩니다.
`icon@2x.png` would be treated as a high resolution image that has double DPI
density.
If you want to support displays with different DPI density at the same time, you 서로 다른 해상도(DPI)의 이미지를 지원하고 싶다면 다중 해상도의 이미지를 접미사를 붙여 한 폴더에 넣으면 됩니다. 이 이미지를 사용(로드)할 땐 접미사를 붙이지 않습니다:
can put images with different sizes in the same folder, and use the filename
without DPI suffixes, like this:
```text ```text
images/ images/
@ -46,7 +41,7 @@ images/
var appIcon = new Tray('/Users/somebody/images/icon.png'); var appIcon = new Tray('/Users/somebody/images/icon.png');
``` ```
Following suffixes as DPI denses are also supported: 지원하는 DPI 접미사는 다음과 같습니다:
* `@1x` * `@1x`
* `@1.25x` * `@1.25x`
@ -60,77 +55,73 @@ Following suffixes as DPI denses are also supported:
* `@4x` * `@4x`
* `@5x` * `@5x`
## Template image ## 템플릿 이미지
Template images consist of black and clear colors (and an alpha channel). 템플릿 이미지는 검은색과 명확한 색상(알파 채널)으로 이루어져 있습니다.
Template images are not intended to be used as standalone images and are usually 템플릿 이미지는 단독 이미지로 사용되지 않고 다른 컨텐츠와 혼합되어 최종 외관 만드는데 사용됩니다.
mixed with other content to create the desired final appearance.
The most common case is to use template image for menu bar icon so it can adapt 가장 일반적으로 템플릿 이미지는 밝고 어두운 테마 색상으로 변경할 수 있는 메뉴 바 아이콘 등에 사용되고 있습니다.
to both light and dark menu bars.
Template image is only supported on Mac. 템플릿 이미지는 Mac 운영체제만 지원합니다.
To mark an image as template image, its filename should end with the word 템플릿 이미지를 지정하려면 다음 예제와 같이 파일명에 `Template` 문자열을 추가해야 합니다:
`Template`, examples are:
* `xxxTemplate.png` * `xxxTemplate.png`
* `xxxTemplate@2x.png` * `xxxTemplate@2x.png`
## nativeImage.createEmpty() ## nativeImage.createEmpty()
Creates an empty `NativeImage` instance. `NativeImage` 인스턴스를 만듭니다.
## nativeImage.createFromPath(path) ## nativeImage.createFromPath(path)
* `path` String * `path` String
Creates a new `NativeImage` instance from a file located at `path`. `path`로부터 이미지를 로드하여 새로운 `NativeImage` 인스턴스를 만듭니다.
## nativeImage.createFromBuffer(buffer[, scaleFactor]) ## nativeImage.createFromBuffer(buffer[, scaleFactor])
* `buffer` [Buffer][buffer] * `buffer` [Buffer][buffer]
* `scaleFactor` Double * `scaleFactor` Double
Creates a new `NativeImage` instance from `buffer`. The `scaleFactor` is 1.0 by `buffer`로부터 이미지를 로드하여 새로운 `NativeImage` 인스턴스를 만듭니다. `scaleFactor`는 1.0이 기본입니다.
default.
## nativeImage.createFromDataUrl(dataUrl) ## nativeImage.createFromDataUrl(dataUrl)
* `dataUrl` String * `dataUrl` String
Creates a new `NativeImage` instance from `dataUrl`. `dataUrl`로부터 이미지를 로드하여 새로운 `NativeImage` 인스턴스를 만듭니다.
## Class: NativeImage ## Class: NativeImage
This class is used to represent an image. 이미지를 표현한 클래스입니다.
### NativeImage.toPng() ### NativeImage.toPng()
Returns a [Buffer][buffer] that contains image's `PNG` encoded data. `PNG` 이미지를 인코딩한 데이터를 [Buffer][buffer]로 반환합니다.
### NativeImage.toJpeg(quality) ### NativeImage.toJpeg(quality)
* `quality` Integer * `quality` Integer
Returns a [Buffer][buffer] that contains image's `JPEG` encoded data. `JPEG` 이미지를 인코딩한 데이터를 [Buffer][buffer]로 반환합니다.
### NativeImage.toDataUrl() ### NativeImage.toDataUrl()
Returns the data URL of image. 이미지의 data URL을 반환합니다.
### NativeImage.isEmpty() ### NativeImage.isEmpty()
Returns whether the image is empty. 이미지가 비었는지를 체크합니다.
### NativeImage.getSize() ### NativeImage.getSize()
Returns the size of the image. 이미지의 사이즈를 반환합니다.
[buffer]: https://iojs.org/api/buffer.html#buffer_class_buffer
### NativeImage.setTemplateImage(option) ### NativeImage.setTemplateImage(option)
* `option` Boolean * `option` Boolean
Marks the image as template image. 해당 이미지를 템플릿 이미지로 설정합니다.
[buffer]: https://iojs.org/api/buffer.html#buffer_class_buffer

View file

@ -1,13 +1,12 @@
# Process object # 프로세스 객체
The `process` object in Electron has the following differences from the one in Electron의 `process` 객체는 기존의 node와는 달리 약간의 차이점이 있습니다:
upstream node:
* `process.type` String - Process's type, can be `browser` (i.e. main process) or `renderer`. * `process.type` String - 프로세스의 타입, `browser` (메인 프로세스) 또는 `renderer`가 됩니다.
* `process.versions['electron']` String - Version of Electron. * `process.versions['electron']` String - Electron의 버전.
* `process.versions['chrome']` String - Version of Chromium. * `process.versions['chrome']` String - Chromium의 버전.
* `process.resourcesPath` String - Path to JavaScript source code. * `process.resourcesPath` String - JavaScript 소스코드의 경로.
## process.hang ## process.hang
Causes the main thread of the current process hang. 현재 프로세스의 주 스레드를 중단시킵니다.

View file

@ -1,8 +1,8 @@
# shell # shell
The `shell` module provides functions related to desktop integration. `shell` 모듈은 데스크톱 환경 통합에 관련하여 제공되는 모듈입니다.
An example of opening a URL in default browser: 다음 예제는 기본 브라우저로 설정된 URL을 엽니다:
```javascript ```javascript
var shell = require('shell'); var shell = require('shell');
@ -13,20 +13,20 @@ shell.openExternal('https://github.com');
* `fullPath` String * `fullPath` String
Show the given file in a file manager. If possible, select the file. 지정한 파일을 탐색기에서 보여줍니다. 가능한 경우 탐색기 내에서 파일을 선택합니다.
## shell.openItem(fullPath) ## shell.openItem(fullPath)
* `fullPath` String * `fullPath` String
Open the given file in the desktop's default manner. 지정한 파일을 데스크톱 기본 프로그램으로 엽니다.
## shell.openExternal(url) ## shell.openExternal(url)
* `url` String * `url` String
Open the given external protocol URL in the desktop's default manner. (For 제공된 외부 프로토콜 URL을 기반으로 데스크톱의 기본 프로그램으로 엽니다. (예를들어 mailto: URL은 해당 URL을 기본 메일 에이전트로 엽니다.)
example, mailto: URLs in the default mail user agent.) 역자주: 폴더는 'file:\\\\C:\\'와 같이 지정하여 열 수 있습니다. (`\\`로 경로를 표현한 이유는 Escape 문자열을 참고하세요.)
## shell.moveItemToTrash(fullPath) ## shell.moveItemToTrash(fullPath)
@ -34,6 +34,8 @@ example, mailto: URLs in the default mail user agent.)
Move the given file to trash and returns boolean status for the operation. Move the given file to trash and returns boolean status for the operation.
지정한 파일을 휴지통으로 이동합니다. 작업의 성공여부를 boolean 형으로 리턴합니다.
## shell.beep() ## shell.beep()
Play the beep sound. 비프음을 재생합니다.