Browse Source

Translate some apis

Plusb Preco 9 years ago
parent
commit
783e4bc591

+ 1 - 1
README-ko.md

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

+ 1 - 1
docs/api/auto-updater-ko.md

@@ -2,7 +2,7 @@
 
 **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.
 
 The `auto-updater` module is a simple wrap around the

+ 2 - 2
docs/api/browser-window-ko.md

@@ -1113,9 +1113,9 @@ win.webContents.on('did-finish-load', function() {
       *  `secure` Boolean - Whether the cookie is marked as Secure (typically HTTPS)
       *  `http_only` Boolean - Whether the cookie is marked as HttpOnly
       *  `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
-           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)

+ 14 - 16
docs/api/clipboard-ko.md

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

+ 4 - 6
docs/api/file-object-ko.md

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

+ 23 - 32
docs/api/native-image-ko.md

@@ -23,16 +23,11 @@ var appIcon = new Tray(image);
 
 ## 고해상도 이미지
 
-On platforms that have high-DPI support, you can append `@2x` after image's
-file name's base name to mark it as a high resolution image.
+플랫폼이 high-DPI를 지원하는 경우 `@2x`와 같이 이미지의 파일명 뒤에 접미사를 추가하여 고해상도 이미지로 지정할 수 있습니다.
 
-For example if `icon.png` is a normal image that has standard resolution, the
-`[email protected]` would be treated as a high resolution image that has double DPI
-density.
+예를 들어 `icon.png` 라는 기본 해상도의 이미지를 기준으로 크기를 두 배로 늘린 이미지를 `[email protected]`와 같이 이름을 지정하면 고해상도 이미지로 처리됩니다.
 
-If you want to support displays with different DPI density at the same time, you
-can put images with different sizes in the same folder, and use the filename
-without DPI suffixes, like this:
+서로 다른 해상도(DPI)의 이미지를 지원하고 싶다면 다중 해상도의 이미지를 접미사를 붙여 한 폴더에 넣으면 됩니다. 이 이미지를 사용(로드)할 땐 접미사를 붙이지 않습니다:
 
 ```text
 images/
@@ -46,7 +41,7 @@ images/
 var appIcon = new Tray('/Users/somebody/images/icon.png');
 ```
 
-Following suffixes as DPI denses are also supported:
+지원하는 DPI 접미사는 다음과 같습니다:
 
 * `@1x`
 * `@1.25x`
@@ -60,77 +55,73 @@ Following suffixes as DPI denses are also supported:
 * `@4x`
 * `@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`, examples are:
+템플릿 이미지를 지정하려면 다음 예제와 같이 파일명에 `Template` 문자열을 추가해야 합니다:
 
 * `xxxTemplate.png`
 * `[email protected]`
 
 ## nativeImage.createEmpty()
 
-Creates an empty `NativeImage` instance.
+빈 `NativeImage` 인스턴스를 만듭니다.
 
 ## nativeImage.createFromPath(path)
 
 * `path` String
 
-Creates a new `NativeImage` instance from a file located at `path`.
+`path`로부터 이미지를 로드하여 새로운 `NativeImage` 인스턴스를 만듭니다.
 
 ## nativeImage.createFromBuffer(buffer[, scaleFactor])
 
 * `buffer` [Buffer][buffer]
 * `scaleFactor` Double
 
-Creates a new `NativeImage` instance from `buffer`. The `scaleFactor` is 1.0 by
-default.
+`buffer`로부터 이미지를 로드하여 새로운 `NativeImage` 인스턴스를 만듭니다. `scaleFactor`는 1.0이 기본입니다.
 
 ## nativeImage.createFromDataUrl(dataUrl)
 
 * `dataUrl` String
 
-Creates a new `NativeImage` instance from `dataUrl`.
+`dataUrl`로부터 이미지를 로드하여 새로운 `NativeImage` 인스턴스를 만듭니다.
 
 ## Class: NativeImage
 
-This class is used to represent an image.
+이미지를 표현한 클래스입니다.
 
 ### NativeImage.toPng()
 
-Returns a [Buffer][buffer] that contains image's `PNG` encoded data.
+`PNG` 이미지를 인코딩한 데이터를 [Buffer][buffer]로 반환합니다.
 
 ### NativeImage.toJpeg(quality)
 
 * `quality` Integer
 
-Returns a [Buffer][buffer] that contains image's `JPEG` encoded data.
+`JPEG` 이미지를 인코딩한 데이터를 [Buffer][buffer]로 반환합니다.
 
 ### NativeImage.toDataUrl()
 
-Returns the data URL of image.
+이미지의 data URL을 반환합니다.
 
 ### NativeImage.isEmpty()
 
-Returns whether the image is empty.
+이미지가 비었는지를 체크합니다.
 
 ### NativeImage.getSize()
 
-Returns the size of the image.
-
-[buffer]: https://iojs.org/api/buffer.html#buffer_class_buffer
+이미지의 사이즈를 반환합니다.
 
 ### NativeImage.setTemplateImage(option)
 
 * `option` Boolean
 
-Marks the image as template image.
+해당 이미지를 템플릿 이미지로 설정합니다.
+
+[buffer]: https://iojs.org/api/buffer.html#buffer_class_buffer

+ 7 - 8
docs/api/process-ko.md

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

+ 9 - 7
docs/api/shell-ko.md

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