From dcd10d1e4b4dda6a71734bceca629a0dccf98aee Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 1 Jul 2015 14:36:27 +0900 Subject: [PATCH] Translated API docs, added power-save-blocker API to README --- docs/README-ko.md | 3 +- docs/README.md | 1 + docs/api/app-ko.md | 6 +-- docs/api/browser-window-ko.md | 14 +++--- docs/api/chrome-command-line-switches-ko.md | 8 ++-- docs/api/clipboard-ko.md | 4 +- docs/api/dialog-ko.md | 2 +- docs/api/frameless-window-ko.md | 2 +- docs/api/global-shortcut-ko.md | 28 ++++++------ docs/api/ipc-main-process-ko.md | 23 +++++----- docs/api/ipc-renderer-ko.md | 26 +++++------ docs/api/menu-item-ko.md | 4 +- docs/api/menu-ko.md | 4 +- docs/api/power-save-blocker-ko.md | 39 +++++++--------- docs/api/protocol-ko.md | 49 +++++++++------------ docs/api/remote-ko.md | 4 +- docs/api/synopsis-ko.md | 25 +++++------ docs/api/web-frame-ko.md | 33 ++++++-------- docs/api/window-open-ko.md | 33 +++++++------- 19 files changed, 138 insertions(+), 170 deletions(-) diff --git a/docs/README-ko.md b/docs/README-ko.md index 1dd260c7cce..50c4b2c9c9c 100644 --- a/docs/README-ko.md +++ b/docs/README-ko.md @@ -18,7 +18,7 @@ * [개요](api/synopsis-ko.md) * [프로세스 객체](api/process-ko.md) -* [크롬 Command-Line 스위치에 대한 지원](api/chrome-command-line-switches-ko.md) +* [크롬 Command-Line 스위치 지원](api/chrome-command-line-switches-ko.md) 커스텀 DOM Element: @@ -38,6 +38,7 @@ * [menu](api/menu-ko.md) * [menu-item](api/menu-item-ko.md) * [power-monitor](api/power-monitor-ko.md) +* [power-save-blocker](api/power-save-blocker-ko.md) * [protocol](api/protocol-ko.md) * [tray](api/tray-ko.md) diff --git a/docs/README.md b/docs/README.md index 98b4219d343..d61df787c9d 100644 --- a/docs/README.md +++ b/docs/README.md @@ -38,6 +38,7 @@ Modules for the main process: * [menu](api/menu.md) * [menu-item](api/menu-item.md) * [power-monitor](api/power-monitor.md) +* [power-save-blocker](api/power-save-blocker.md) * [protocol](api/protocol.md) * [tray](api/tray.md) diff --git a/docs/api/app-ko.md b/docs/api/app-ko.md index ff175538176..293cfd965a3 100644 --- a/docs/api/app-ko.md +++ b/docs/api/app-ko.md @@ -92,21 +92,21 @@ click on the application's dock icon. * `event` Event * `window` BrowserWindow -Emitted when a [browserWindow](browser-window.md) gets blurred. +Emitted when a [browserWindow](browser-window-ko.md) gets blurred. ## Event: browser-window-focus * `event` Event * `window` BrowserWindow -Emitted when a [browserWindow](browser-window.md) gets focused. +Emitted when a [browserWindow](browser-window-ko.md) gets focused. ### Event: 'select-certificate' Emitted when client certificate is requested. * `event` Event -* `webContents` [WebContents](browser-window.md#class-webcontents) +* `webContents` [WebContents](browser-window-ko.md#class-webcontents) * `url` String * `certificateList` [Objects] * `data` PEM encoded data diff --git a/docs/api/browser-window-ko.md b/docs/api/browser-window-ko.md index 3e59aad0398..5a793d080aa 100644 --- a/docs/api/browser-window-ko.md +++ b/docs/api/browser-window-ko.md @@ -16,7 +16,7 @@ win.show(); ``` You can also create a window without chrome by using -[Frameless Window](frameless-window.md) API. +[Frameless Window](frameless-window-ko.md) API. ## Class: BrowserWindow @@ -48,11 +48,11 @@ You can also create a window without chrome by using zoom percent / 100, so `3.0` represents `300%` * `kiosk` Boolean - The kiosk mode * `title` String - Default window title - * `icon` [NativeImage](native-image.md) - The window icon, when omitted on + * `icon` [NativeImage](native-image-ko.md) - The window icon, when omitted on Windows the executable's icon would be used as window icon * `show` Boolean - Whether window should be shown when created * `frame` Boolean - Specify `false` to create a - [Frameless Window](frameless-window.md) + [Frameless Window](frameless-window-ko.md) * `node-integration` Boolean - Whether node integration is enabled, default is `true` * `accept-first-mouse` Boolean - Whether the web view accepts a single @@ -68,7 +68,7 @@ You can also create a window without chrome by using scripts run in the window. This script will always have access to node APIs no matter whether node integration is turned on for the window, and the path of `preload` script has to be absolute path. - * `transparent` Boolean - Makes the window [transparent](frameless-window.md) + * `transparent` Boolean - Makes the window [transparent](frameless-window-ko.md) * `type` String - Specifies the type of the window, possible types are `desktop`, `dock`, `toolbar`, `splash`, `notification`. This only works on Linux. @@ -566,11 +566,11 @@ Opens the developer tools for the service worker context present in the web cont Captures the snapshot of page within `rect`, upon completion `callback` would be called with `callback(image)`, the `image` is an instance of -[NativeImage](native-image.md) that stores data of the snapshot. Omitting the +[NativeImage](native-image-ko.md) that stores data of the snapshot. Omitting the `rect` would capture the whole visible page. **Note:** Be sure to read documents on remote buffer in -[remote](remote.md) if you are going to use this API in renderer +[remote](remote-ko.md) if you are going to use this API in renderer process. ### BrowserWindow.print([options]) @@ -613,7 +613,7 @@ it will assume `app.getName().desktop`. ### BrowserWindow.setOverlayIcon(overlay, description) -* `overlay` [NativeImage](native-image.md) - the icon to display on the bottom +* `overlay` [NativeImage](native-image-ko.md) - the icon to display on the bottom right corner of the taskbar icon. If this parameter is `null`, the overlay is cleared * `description` String - a description that will be provided to Accessibility diff --git a/docs/api/chrome-command-line-switches-ko.md b/docs/api/chrome-command-line-switches-ko.md index 49e5424e5e6..ca519ec6a2b 100644 --- a/docs/api/chrome-command-line-switches-ko.md +++ b/docs/api/chrome-command-line-switches-ko.md @@ -1,4 +1,4 @@ -# Supported Chrome command line switches +# 크롬 Command-Line 스위치 지원 The following command lines switches in Chrome browser are also supported in Electron, you can use [app.commandLine.appendSwitch][append-switch] to append @@ -63,9 +63,9 @@ connection, and the endpoint host in a `SOCKS` proxy connection). Like `--host-rules` but these `rules` only apply to the host resolver. -[app]: app.md -[append-switch]: app.md#appcommandlineappendswitchswitch-value -[ready]: app.md#event-ready +[app]: app-ko.md +[append-switch]: app-ko.md#appcommandlineappendswitchswitch-value +[ready]: app-ko.md#event-ready ## --ignore-certificate-errors diff --git a/docs/api/clipboard-ko.md b/docs/api/clipboard-ko.md index 3fdb8f39445..3ee0164e975 100644 --- a/docs/api/clipboard-ko.md +++ b/docs/api/clipboard-ko.md @@ -45,11 +45,11 @@ console.log(clipboard.readText('selection')); * `type` String -클립보드로부터 [NativeImage](native-image.md)로 이미지를 읽어들입니다. +클립보드로부터 [NativeImage](native-image-ko.md)로 이미지를 읽어들입니다. ## clipboard.writeImage(image[, type]) -* `image` [NativeImage](native-image.md) +* `image` [NativeImage](native-image-ko.md) * `type` String 클립보드에 `image`를 씁니다. diff --git a/docs/api/dialog-ko.md b/docs/api/dialog-ko.md index 04ed3fe0797..25c4abfa763 100644 --- a/docs/api/dialog-ko.md +++ b/docs/api/dialog-ko.md @@ -75,7 +75,7 @@ will be passed via `callback(filename)` * `title` String - Title of the message box, some platforms will not show it * `message` String - Content of the message box * `detail` String - Extra information of the message - * `icon` [NativeImage](native-image.md) + * `icon` [NativeImage](native-image-ko.md) * `callback` Function Shows a message box, it will block until the message box is closed. It returns diff --git a/docs/api/frameless-window-ko.md b/docs/api/frameless-window-ko.md index fb3c6f5a824..31982c07e67 100644 --- a/docs/api/frameless-window-ko.md +++ b/docs/api/frameless-window-ko.md @@ -5,7 +5,7 @@ A frameless window is a window that has no chrome. ## Create a frameless window To create a frameless window, you only need to specify `frame` to `false` in -[BrowserWindow](browser-window.md)'s `options`: +[BrowserWindow](browser-window-ko.md)'s `options`: ```javascript diff --git a/docs/api/global-shortcut-ko.md b/docs/api/global-shortcut-ko.md index a8f3ac183df..6626882368b 100644 --- a/docs/api/global-shortcut-ko.md +++ b/docs/api/global-shortcut-ko.md @@ -1,49 +1,47 @@ # global-shortcut -The `global-shortcut` module can register/unregister a global keyboard shortcut -in operating system, so that you can customize the operations for various shortcuts. -Note that the shortcut is global, even if the app does not get focused, it will still work. +`global-shortcut` 모듈은 사용자가 다양한 단축키 작업을 정의 할 수 있도록 운영체제의 전역 키보드 단축키를 설정 등록/해제 하는 방법을 제공합니다. +참고로 설정된 단축키는 어플리케이션이 백그라운드로 작동(창이 포커스 되지 않음) 할 때도 여전히 계속 작동합니다. ```javascript var globalShortcut = require('global-shortcut'); -// Register a 'ctrl+x' shortcut listener. +// 'ctrl+x' 단축키를 리스너에 등록합니다. var ret = globalShortcut.register('ctrl+x', function() { console.log('ctrl+x is pressed'); }) if (!ret) { console.log('registration failed'); } -// Check whether a shortcut is registered. +// 단축키가 등록되었는지 확인합니다. console.log(globalShortcut.isRegistered('ctrl+x')); -// Unregister a shortcut. +// 단축키의 등록을 해제합니다. globalShortcut.unregister('ctrl+x'); -// Unregister all shortcuts. +// 모든 단축키의 등록을 해제합니다. globalShortcut.unregisterAll(); ``` ## globalShortcut.register(accelerator, callback) -* `accelerator` [Accelerator](accelerator.md) +* `accelerator` [Accelerator](accelerator-ko.md) * `callback` Function -Registers a global shortcut of `accelerator`, the `callback` would be called when -the registered shortcut is pressed by user. +`accelerator`로 표현된 전역 단축키를 등록합니다. 유저로부터 등록된 단축키가 눌렸을 경우 `callback` 함수가 호출됩니다. ## globalShortcut.isRegistered(accelerator) -* `accelerator` [Accelerator](accelerator.md) +* `accelerator` [Accelerator](accelerator-ko.md) -Returns `true` or `false` depending on if the shortcut `accelerator` is registered. +지정된 `accelerator` 단축키가 등록되었는지 여부를 확인합니다. 반환값은 boolean(true, false) 입니다. ## globalShortcut.unregister(accelerator) -* `accelerator` [Accelerator](accelerator.md) +* `accelerator` [Accelerator](accelerator-ko.md) -Unregisters the global shortcut of `keycode`. +`키코드`에 해당하는 전역 단축키를 등록 해제합니다. ## globalShortcut.unregisterAll() -Unregisters all the global shortcuts. +모든 전역 단축키 등록을 해제합니다. diff --git a/docs/api/ipc-main-process-ko.md b/docs/api/ipc-main-process-ko.md index 2487737baf5..7d0aba08efa 100644 --- a/docs/api/ipc-main-process-ko.md +++ b/docs/api/ipc-main-process-ko.md @@ -1,20 +1,17 @@ # ipc (main process) -Handles asynchronous and synchronous message sent from a renderer process (web -page). +랜더러 프로세스(웹 페이지)로 부터 동기 또는 비동기로 메시지를 받아 처리합니다. -The messages sent from a renderer would be emitted to this module, the event name -is the `channel` when sending message. To reply a synchronous message, you need -to set `event.returnValue`, to send an asynchronous back to the sender, you can -use `event.sender.send(...)`. +랜더러로부터 발신된 메시지들은 모두 이 모듈에서 `channel` 이라는 특정 이벤트 이름을 통해 수신할 수 있습니다. +동기 메시지는 `event.returnValue`를 이용하여 반환값(답장)을 설정할 수 있습니다. 비동기 메시지라면 `event.sender.send(...)`를 사용하면 됩니다. -It's also possible to send messages from main process to the renderer process, -see [WebContents.send](browser-window.md#webcontentssendchannel-args) for more. +또한 메인 프로세스에서 랜더러 프로세스로 메시지를 보내는 것도 가능합니다. +자세한 내용은 [WebContents.send](browser-window-ko.md#webcontentssendchannel-args)를 참고 하세요. -An example of sending and handling messages: +보내진 메시지들을 처리하는 예제입니다: ```javascript -// In main process. +// 메인 프로세스에서 처리. var ipc = require('ipc'); ipc.on('asynchronous-message', function(event, arg) { console.log(arg); // prints "ping" @@ -28,7 +25,7 @@ ipc.on('synchronous-message', function(event, arg) { ``` ```javascript -// In renderer process (web page). +// 랜더러 프로세스에서의 처리 (web page). var ipc = require('ipc'); console.log(ipc.sendSync('synchronous-message', 'ping')); // prints "pong" @@ -42,8 +39,8 @@ ipc.send('asynchronous-message', 'ping'); ### Event.returnValue -Assign to this to return an value to synchronous messages. +동기 메시지를 설정합니다. ### Event.sender -The `WebContents` that sent the message. +메시지를 보내온 sender `WebContents` 객체입니다. diff --git a/docs/api/ipc-renderer-ko.md b/docs/api/ipc-renderer-ko.md index 75d26ce5438..e4664480447 100644 --- a/docs/api/ipc-renderer-ko.md +++ b/docs/api/ipc-renderer-ko.md @@ -1,29 +1,25 @@ # ipc (renderer) -The `ipc` module provides a few methods so you can send synchronous and -asynchronous messages to the main process, and also receive messages sent from -main process. If you want to make use of modules of main process from renderer -process, you might consider using the [remote](remote.md) module. +`ipc` 모듈은 메인 프로세스로 메시지를 동기 또는 비동기로 보내고 받을 수 있는 몇 가지 방법을 제공합니다. +만약 랜더러 프로세스에서 메인 프로세스의 모듈을 직접적으로 사용하고 싶다면 [remote](remote-ko.md) 모듈을 사용하는 것을 고려해보는 것이 좋습니다. -See [ipc (main process)](ipc-main-process.md) for examples. +[ipc (main process)](ipc-main-process-ko.md)에서 예제를 볼 수 있습니다. ## ipc.send(channel[, args...]) -Send `args..` to the renderer via `channel` in asynchronous message, the main -process can handle it by listening to the `channel` event of `ipc` module. +지정한 `channel`을 통해 `args..`를 비동기로 메시지를 보냅니다. 메인 프로세스는 `ipc` 모듈의 `channel` 이벤트를 통해 메시지를 받을 수 있습니다. ## ipc.sendSync(channel[, args...]) -Send `args..` to the renderer via `channel` in synchronous message, and returns -the result sent from main process. The main process can handle it by listening to -the `channel` event of `ipc` module, and returns by setting `event.returnValue`. +지정한 `channel`을 통해 `args..`를 동기로 메시지를 보냅니다. 그리고 메인 프로세스에서 보낸 결과를 반환합니다. +메인 프로세스는 `ipc` 모듈의 `channel` 이벤트를 통해 메시지를 받을 수 있습니다. 그리고 `event.returnValue`를 통해 반환값을 설정할 수 있습니다. -**Note:** Usually developers should never use this API, since sending -synchronous message would block the whole renderer process. +역자 주: `channel`은 이벤트 이름입니다. + +**알림:** 보통 개발자들은 해당 API를 사용하려 하지 않습니다. 동기 ipc 작업은 랜더러 프로세스의 모든 작업을 중단시킵니다. ## ipc.sendToHost(channel[, args...]) -Like `ipc.send` but the message will be sent to the host page instead of the -main process. +`ipc.send`와 비슷하지만 메시지를 메인 프로세스 대신 호스트 페이지로 보냅니다. -This is mainly used by the page in `` to communicate with host page. +이 메소드는 보통 ``와 호스트 페이지 간의 통신에 사용됩니다. diff --git a/docs/api/menu-item-ko.md b/docs/api/menu-item-ko.md index 519b7fb237a..8477451ff96 100644 --- a/docs/api/menu-item-ko.md +++ b/docs/api/menu-item-ko.md @@ -10,8 +10,8 @@ * `type` String - `MenuItem`의 타입 `normal`, `separator`, `submenu`, `checkbox` 또는 `radio` 사용가능 * `label` String * `sublabel` String - * `accelerator` [Accelerator](accelerator.md) - * `icon` [NativeImage](native-image.md) + * `accelerator` [Accelerator](accelerator-ko.md) + * `icon` [NativeImage](native-image-ko.md) * `enabled` Boolean * `visible` Boolean * `checked` Boolean diff --git a/docs/api/menu-ko.md b/docs/api/menu-ko.md index 62e07530f26..3ac62012f67 100644 --- a/docs/api/menu-ko.md +++ b/docs/api/menu-ko.md @@ -5,7 +5,7 @@ application menus and context menus. Each menu consists of multiple menu items, and each menu item can have a submenu. Below is an example of creating a menu dynamically in a web page by using -the [remote](remote.md) module, and showing it when the user right clicks +the [remote](remote-ko.md) module, and showing it when the user right clicks the page: ```html @@ -191,7 +191,7 @@ emulating default Cocoa menu behaviors, usually you would just use the * `template` Array Generally, the `template` is just an array of `options` for constructing -[MenuItem](menu-item.md), the usage can be referenced above. +[MenuItem](menu-item-ko.md), the usage can be referenced above. You can also attach other fields to element of the `template`, and they will become properties of the constructed menu items. diff --git a/docs/api/power-save-blocker-ko.md b/docs/api/power-save-blocker-ko.md index d5fdfc99e48..e686891a5ca 100644 --- a/docs/api/power-save-blocker-ko.md +++ b/docs/api/power-save-blocker-ko.md @@ -1,9 +1,8 @@ # power-save-blocker -The `power-save-blocker` module is used to block the system from entering -low-power(sleep) mode, allowing app to keep system and screen active. +`power-save-blocker` 모듈은 시스템이 저전력 모드(슬립)로 진입하는 것을 막고 앱 및 화면이 항상 활성화되어 있는 상태를 만들 수 있도록 해줍니다. -An example is: +예제: ```javascript var powerSaveBlocker = require('power-save-blocker'); @@ -16,33 +15,29 @@ powerSaveBlocker.stop(id); ## powerSaveBlocker.start(type) -* `type` String - Power save blocker type - * `prevent-app-suspension` - Prevent the application from being suspended. - Keeps system active, but allows screen to be turned off. Example use cases: - downloading a file, playing audio. - * `prevent-display-sleep`- Prevent the display from going to sleep. Keeps system - and screen active. Example use case: playing video. +* `type` String - Power save blocker 종류 + * `prevent-app-suspension` - 저전력 모드 등으로 인한 어플리케이션 작동 중단을 방지합니다. + 시스템을 항시 활성화 상태로 만듭니다, 하지만 화면은 자동으로 꺼질 수 있습니다. 사용 예시: 파일 다운로드, 음악 재생 등. + * `prevent-display-sleep`- 슬립 모드 등으로 인한 어플리케이션의 작동 중단을 방지합니다. + 시스템을 항시 활성화 상태로 만들고 슬립 모드(화면 꺼짐)를 방지합니다. 사용 예시: 비디오 재생 등. -Starts the power save blocker preventing the system entering lower-power mode. -Returns an integer identified the power save blocker. +Power save blocker를 시작하고 시스템이 저전력 모드(슬립)로 진입하는 것을 막습니다. 정수로 된 식별 ID를 반환합니다. -**Note:** -`prevent-display-sleep` has higher precedence level than `prevent-app-suspension`. -Only the highest precedence type takes effect. In other words, `prevent-display-sleep` -always take precedence over `prevent-app-suspension`. +**알림:** +`prevent-display-sleep` 모드는 `prevent-app-suspension` 보다 우선순위가 높습니다. +가장 높은 우선순위의 모드만 작동합니다. 다시 말해 `prevent-display-sleep` 모드는 언제나 `prevent-app-suspension` 모드의 효과를 덮어씌웁니다. -For example, an API calling A requests for `prevent-app-suspension`, and -another calling B requests for `prevent-display-sleep`. `prevent-display-sleep` -will be used until B stops its request. After that, `prevent-app-suspension` is used. +예를 들어 A-요청이 `prevent-app-suspension` 모드를 사용하고 B-요청이 `prevent-display-sleep`를 사용하는 API 호출이 있었다 치면 +`prevent-display-sleep` 모드를 사용하는 B의 작동이 중단(stop)되기 전까지 작동하다 B가 중단되면 `prevent-app-suspension` 모드를 사용하는 A가 작동하기 시작합니다. ## powerSaveBlocker.stop(id) -* `id` Integer - The power save blocker id returned by `powerSaveBlocker.start`. +* `id` Integer - `powerSaveBlocker.start`로 부터 반환되는 power save blocker 식별 ID. -Stops the specified power save blocker. +설정한 power save blocker를 중지합니다. ## powerSaveBlocker.isStarted(id) -* `id` Integer - The power save blocker id returned by `powerSaveBlocker.start`. +* `id` Integer - `powerSaveBlocker.start`로 부터 반환되는 power save blocker 식별 ID. -Returns whether the corresponding `powerSaveBlocker` starts. +해당하는 id의 `powerSaveBlocker`가 실행중인지 확인합니다. diff --git a/docs/api/protocol-ko.md b/docs/api/protocol-ko.md index a66d2d9fb48..26fc4eb740c 100644 --- a/docs/api/protocol-ko.md +++ b/docs/api/protocol-ko.md @@ -1,10 +1,8 @@ # protocol -The `protocol` module can register a new protocol or intercept an existing -protocol, so you can customize the response to the requests for various protocols. +`protocol` 모듈은 여러 프로토콜의 요청과 응답을 커스터마이즈 할 수 있도록 이미 있는 프로토콜을 변경하거나 새로운 프로토콜을 만드는 방법을 제공합니다. -An example of implementing a protocol that has the same effect with the -`file://` protocol: +다음 예제는 `file://` 프로토콜과 같은 일을 하는 커스텀 프로토콜을 설정합니다: ```javascript var app = require('app'); @@ -19,67 +17,63 @@ app.on('ready', function() { }); ``` -**Note:** This module can only be used after the `ready` event -was emitted. +**알림:** 이 모듈은 app의 `ready` 이벤트가 발생한 이후에만 사용할 수 있습니다. ## protocol.registerProtocol(scheme, handler) * `scheme` String * `handler` Function -Registers a custom protocol of `scheme`, the `handler` would be called with -`handler(request)` when the a request with registered `scheme` is made. +지정한 `scheme`을 기반으로 커스텀 프로토콜을 등록합니다. 등록한 `scheme` 프로토콜에 요청이 들어올 경우 `request` 인자와 함께 `handler` 함수가 호출됩니다. -You need to return a request job in the `handler` to specify which type of -response you would like to send. +호출된 `handler` 함수에선 요청에 대한 해당 프로토콜의 작업 결과를 응답(반환) 해야 할 필요가 있습니다. ## protocol.unregisterProtocol(scheme) * `scheme` String -Unregisters the custom protocol of `scheme`. +지정한 `scheme` 프로토콜을 등록 해제합니다. ## protocol.registerStandardSchemes(value) * `value` Array -`value` is an array of custom schemes to be registered to the standard. +지정한 `value` 배열을 사용하여 미리 지정된 스킴으로 등록합니다. ## protocol.isHandledProtocol(scheme) * `scheme` String -Returns whether the `scheme` can be handled already. +해당 `scheme`에 처리자(handler)가 등록되었는지 확인합니다. ## protocol.interceptProtocol(scheme, handler) * `scheme` String * `handler` Function -Intercepts an existing protocol with `scheme`, returning `null` or `undefined` -in `handler` would use the original protocol handler to handle the request. +지정한 `scheme`의 작업을 `handler`로 변경합니다. +`handler`에서 `null` 또는 `undefined`를 반환 할 경우 해당 프로토콜의 기본 동작(응답)으로 대체 됩니다. ## protocol.uninterceptProtocol(scheme) * `scheme` String -Unintercepts a protocol. +변경된 프로토콜의 작업을 해제합니다. ## Class: protocol.RequestFileJob(path) * `path` String -Create a request job which would query a file of `path` and set corresponding -mime types. +`path` 경로를 기반으로 파일을 반환하는 request 작업을 생성합니다. 그리고 해당 파일에 상응하는 mime type을 지정합니다. ## Class: protocol.RequestStringJob(options) * `options` Object - * `mimeType` String - Default is `text/plain` - * `charset` String - Default is `UTF-8` + * `mimeType` String - `text/plain`이 기본 + * `charset` String - `UTF-8`이 기본 * `data` String -Create a request job which sends a string as response. +문자열을 반환하는 request 작업을 생성합니다. ## Class: protocol.RequestBufferJob(options) @@ -88,7 +82,7 @@ Create a request job which sends a string as response. * `encoding` String - Default is `UTF-8` * `data` Buffer -Create a request job which sends a buffer as response. +버퍼를 반환하는 request 작업을 생성합니다. ## Class: protocol.RequestHttpJob(options) @@ -97,17 +91,16 @@ Create a request job which sends a buffer as response. * `method` String - Default is `GET` * `referrer` String -Send a request to `url` and pipe the response back. +`url`의 요청 결과를 그대로 반환하는 request 작업을 생성합니다. ## Class: protocol.RequestErrorJob(code) * `code` Integer -Create a request job which sets appropriate network error message to console. -Default message is `net::ERR_NOT_IMPLEMENTED`. Code should be in the following -range. +콘솔에 특정한 네트워크 에러 메시지를 설정하는 request 작업을 생성합니다. +기본 메시지는 `net::ERR_NOT_IMPLEMENTED`입니다. 사용할 수 있는 코드의 범위는 다음과 같습니다. -* Ranges: +* 범위: * 0- 99 System related errors * 100-199 Connection related errors * 200-299 Certificate errors @@ -118,4 +111,4 @@ range. * 700-799 Certificate manager errors * 800-899 DNS resolver errors -Check the [network error list](https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h) for code and message relations. +에러 코드와 메시지에 대해 자세하게 알아보려면 [네트워크 에러 리스트](https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h)를 참고하기 바랍니다. diff --git a/docs/api/remote-ko.md b/docs/api/remote-ko.md index b7db7a8edb8..c42c60d35d9 100644 --- a/docs/api/remote-ko.md +++ b/docs/api/remote-ko.md @@ -20,7 +20,7 @@ var win = new BrowserWindow({ width: 800, height: 600 }); win.loadUrl('https://github.com'); ``` -Note: for the reverse (access renderer process from main process), you can use [webContents.executeJavascript](https://github.com/atom/electron/blob/master/docs/api/browser-window.md#browserwindowwebcontents). +Note: for the reverse (access renderer process from main process), you can use [webContents.executeJavascript](https://github.com/atom/electron/blob/master/docs/api/browser-window-ko.md#browserwindowwebcontents). ## Remote objects @@ -139,7 +139,7 @@ Returns the object returned by `require(module)` in the main process. ## remote.getCurrentWindow() -Returns the [BrowserWindow](browser-window.md) object which this web page +Returns the [BrowserWindow](browser-window-ko.md) object which this web page belongs to. ## remote.getCurrentWebContent() diff --git a/docs/api/synopsis-ko.md b/docs/api/synopsis-ko.md index 89c897c3bc4..8754f2f15bf 100644 --- a/docs/api/synopsis-ko.md +++ b/docs/api/synopsis-ko.md @@ -1,18 +1,14 @@ -# Synopsis +# 개요 -All of [node.js's built-in modules](http://nodejs.org/api/) are available in -Electron, and third-party node modules are fully supported too (including the -[native modules](../tutorial/using-native-node-modules.md)). +Electron은 모든 [node.js's built-in 모듈](http://nodejs.org/api/)과 third-party node 모듈을 완벽하게 지원합니다. ([네이티브 모듈](../tutorial/using-native-node-modules-ko.md)을 포함해서) -Electron also provides some extra built-in modules for developing native -desktop applications. Some modules are only available on the main process, some -are only available on the renderer process, and some can be used on both processes. -The basic rule is: if a module is GUI or low-level system related, then it should -be only available on the main process. You need to be familiar with the concept of -[main process vs. renderer process](../tutorial/quick-start.md#the-main-process) -scripts to be able to use those modules. +Electron은 네이티브 데스크톱 어플리케이션을 개발 할 수 있도록 추가적인 built-in 모듈을 제공합니다. +몇몇 모듈은 메인 프로세스에서만 사용할 수 있고 어떤 모듈은 랜더러 프로세스에서만 사용할 수 있습니다. 또한 두 프로세스 모두 사용할 수 있는 모듈도 있습니다. +기본적인 규칙은 다음과 같습니다: GUI와 저 수준 시스템에 관련된 모듈은 오직 메인 프로세스에서만 사용할 수 있습니다. +[메인 프로세스 vs. 랜더러 프로세스](../tutorial/quick-start-ko.md#메인 프로세스) 컨셉에 익숙해야 이 모듈들을 사용하기 쉬우므로 해당 문서를 정독하는 것을 권장합니다. -The main process script is just like a normal `node.js` script: + +메인 프로세스 스크립트는 일반 `node.js` 스크립트와 같습니다: ```javascript var app = require('app'); @@ -26,8 +22,7 @@ app.on('ready', function() { }); ``` -The web page is no different than a normal web page, except for the extra -ability to use node modules: +웹 페이지 역시 예외적인 node module을 사용할 수 있다는 점을 제외하면 일반 웹 페이지와 다를게 없습니다: ```html @@ -41,4 +36,4 @@ ability to use node modules: ``` -To run your app, read [Run your app](../tutorial/quick-start.md#run-your-app). +어플리케이션을 실행하려면 [앱 실행하기](../tutorial/quick-start-ko.md#앱 실행하기) 문서를 참고하기 바랍니다. diff --git a/docs/api/web-frame-ko.md b/docs/api/web-frame-ko.md index 71f61d09ea4..2219de1065c 100644 --- a/docs/api/web-frame-ko.md +++ b/docs/api/web-frame-ko.md @@ -1,8 +1,8 @@ -# web-frame +# web-frame -The `web-frame` module can custom the rendering of current web page. +`web-frame` 모듈은 현재 웹 페이지의 랜더링 상태를 커스터마이즈 할 수 있도록 해줍니다. -An example of zooming current page to 200%. +다음 예제는 현재 페이지를 200% 줌 합니다. ```javascript var webFrame = require('web-frame'); @@ -11,26 +11,24 @@ webFrame.setZoomFactor(2); ## webFrame.setZoomFactor(factor) -* `factor` Number - Zoom factor +* `factor` Number - Zoom 값 -Changes the zoom factor to the specified factor, zoom factor is -zoom percent / 100, so 300% = 3.0. +지정한 값으로 페이지를 줌 합니다. 줌 값은 퍼센트 / 100입니다. (예시: 300% = 3.0) ## webFrame.getZoomFactor() -Returns the current zoom factor. +현재 줌 값을 반환합니다. ## webFrame.setZoomLevel(level) * `level` Number - Zoom level -Changes the zoom level to the specified level, 0 is "original size", and each -increment above or below represents zooming 20% larger or smaller to default -limits of 300% and 50% of original size, respectively. +지정한 레벨로 줌 레벨을 변경합니다. 0은 "기본 크기" 입니다. +그리고 각각 레벨 값을 올리거나 내릴 때마다 20%씩 커지거나 작아지고 기본 크기의 50%부터 300%까지 조절 제한이 있습니다. ## webFrame.getZoomLevel() -Returns the current zoom level. +현재 줌 레벨을 반환합니다. ## webFrame.setSpellCheckProvider(language, autoCorrectWord, provider) @@ -38,12 +36,11 @@ Returns the current zoom level. * `autoCorrectWord` Boolean * `provider` Object -Sets a provider for spell checking in input fields and text areas. +Input field나 text area에 철자 검사(spell checking) 제공자를 설정합니다. -The `provider` must be an object that has a `spellCheck` method that returns -whether the word passed is correctly spelled. +`provider`는 반드시 전달된 단어의 철자가 맞았는지 검사하는 `spellCheck` 메소드를 가지고 있어야 합니다. -An example of using [node-spellchecker][spellchecker] as provider: +[node-spellchecker][spellchecker]를 철자 검사 제공자로 사용하는 예제입니다: ```javascript require('web-frame').setSpellCheckProvider("en-US", true, { @@ -57,10 +54,8 @@ require('web-frame').setSpellCheckProvider("en-US", true, { * `scheme` String -Sets the `scheme` as secure scheme. +지정한 `scheme`을 보안 스킴으로 설정합니다. -Secure schemes do not trigger mixed content warnings. For example, `https` and -`data` are secure schemes because they cannot be corrupted by active network -attackers. +보안 스킴은 혼합된 컨텐츠 경고를 발생시키지 않습니다. 예를 들어 `https` 와 `data`는 네트워크 공격자로부터 손상될 가능성이 없기 때문에 보안 스킴입니다. [spellchecker]: https://github.com/atom/node-spellchecker diff --git a/docs/api/window-open-ko.md b/docs/api/window-open-ko.md index dccba9121bf..a93bfda8417 100644 --- a/docs/api/window-open-ko.md +++ b/docs/api/window-open-ko.md @@ -1,12 +1,10 @@ -# `window.open` function +# `window.open` 함수 -When `window.open` is called to create a new window in web page, a new instance -of `BrowserWindow` will be created for the `url`, and a proxy will be returned -to `window.open` to let the page to have limited control over it. +`window.open` 함수가 호출되면 새 창에서 새로운 페이지를 불러옵니다. +이 창은 `url`로 부터 만들어진 `BrowserWindow`의 새 인스턴스이며 본 객체 대신 페이지의 컨트롤이 제한된 프록시 객체를 반환합니다. -The proxy only has some limited standard functionality implemented to be -compatible with traditional web pages, for full control of the created window -you should create a `BrowserWindow` directly. +프록시 객체는 기존의 웹 페이지와 호환될 수 있도록 일부 제한된 표준 기능만 가지고 있습니다. +창의 모든 컨트롤을 가지려면 `BrowserWindow`를 직접 생성하여 작업해야 합니다. ## window.open(url, [frameName[, features]]) @@ -14,47 +12,46 @@ you should create a `BrowserWindow` directly. * `frameName` String * `features` String -Creates a new window and returns an instance of `BrowserWindowProxy` class. +`BrowserWindowProxy` 클래스의 객체를 반환하는 새로운 윈도우를 생성합니다. ## window.opener.postMessage(message, targetOrigin) * `message` String * `targetOrigin` String -Sends a message to the parent window with the specified origin or `*` for no -origin preference. +부모 윈도우에 메시지를 보냅니다. 특정한 origin을 지정할 수도 있으며 `*`를 지정하면 따로 origin 설정을 사용하지 않습니다. ## Class: BrowserWindowProxy ### BrowserWindowProxy.blur() -Removes focus from the child window. +자식 윈도우의 포커스를 해제합니다. ### BrowserWindowProxy.close() +자식 윈도우를 강제로 닫습니다. unload 이벤트가 발생하지 않습니다. + Forcefully closes the child window without calling its unload event. ### BrowserWindowProxy.closed -Set to true after the child window gets closed. +자식 윈도우가 닫히면 true로 설정됩니다. ### BrowserWindowProxy.eval(code) * `code` String -Evaluates the code in the child window. +자식 윈도우에서 특정 스크립트를 실행합니다. ### BrowserWindowProxy.focus() -Focuses the child window (brings the window to front). +자식 윈도우에 포커스를 맞춥니다. (창을 맨 앞으로 가져옵니다) ### BrowserWindowProxy.postMessage(message, targetOrigin) * `message` String * `targetOrigin` String -Sends a message to the child window with the specified origin or `*` for no -origin preference. +자식 윈도우에 메시지를 보냅니다. 특정한 origin을 지정할 수도 있으며 `*`를 지정하면 따로 origin 설정을 사용하지 않습니다. -In addition to these methods, the child window implements `window.opener` object -with no properties and a single method: +참고로 자식 윈도우의 `window.opener` 객체에는 다른 속성 없이 이 함수 하나만 구현되어 있습니다.