From 247a0a8ae2c5ce6a7c257112d87ad869dd9a2078 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 02:12:40 +0900 Subject: [PATCH 1/9] Add BrowserWindow translation --- docs-translations/ko-KR/README.md | 4 +- docs-translations/ko-KR/api/browser-window.md | 704 ++++++++++++++++++ 2 files changed, 706 insertions(+), 2 deletions(-) create mode 100644 docs-translations/ko-KR/api/browser-window.md diff --git a/docs-translations/ko-KR/README.md b/docs-translations/ko-KR/README.md index b2082b0d2e7..34826f9d340 100644 --- a/docs-translations/ko-KR/README.md +++ b/docs-translations/ko-KR/README.md @@ -32,7 +32,7 @@ * [app](api/app.md) * [autoUpdater](api/auto-updater.md) -* [BrowserWindow (0% 번역됨)](api/browser-window.md) +* [BrowserWindow (20% 번역됨 - 작업중)](api/browser-window.md) * [contentTracing](api/content-tracing.md) * [dialog](api/dialog.md) * [globalShortcut](api/global-shortcut.md) @@ -43,7 +43,7 @@ * [powerSaveBlocker](api/power-save-blocker.md) * [protocol](api/protocol.md) * [session](api/session.md) -* [webContents (0% 번역됨)](api/web-contents.md) +* [webContents](api/web-contents.md) * [Tray](api/tray.md) ### 랜더러 프로세스에서 사용할 수 있는 모듈 (웹 페이지): diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md new file mode 100644 index 00000000000..30165e85851 --- /dev/null +++ b/docs-translations/ko-KR/api/browser-window.md @@ -0,0 +1,704 @@ +# BrowserWindow + +`BrowserWindow` 클래스는 브라우저 창(윈도우 창)을 만드는 역할을 담당합니다. + +다음 예제는 윈도우 창을 생성합니다: + +```javascript +const BrowserWindow = require('electron').BrowserWindow; + +var win = new BrowserWindow({ width: 800, height: 600, show: false }); +win.on('closed', function() { + win = null; +}); + +win.loadURL('https://github.com'); +win.show(); +``` + +또한 [Frameless Window](frameless-window.md) API를 사용하여 창 테두리가 없는 윈도우 창을 생성할 수 있습니다. + +## Class: BrowserWindow + +`BrowserWindow`는 [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter)를 상속받은 클래스 입니다. + +`BrowserWindow`는 `options`를 통해 네이티브 속성을 포함한 새로운 윈도우 창을 생성합니다. + +### `new BrowserWindow(options)` + +`options` 객체에서 사용할 수 있는 속성들: + +* `width` Integer - 윈도우 창의 가로 너비. +* `height` Integer - 윈도우 창의 세로 높이. +* `x` Integer - 화면을 기준으로 창 좌측을 오프셋 한 위치. +* `y` Integer - 화면을 기준으로 창 상단을 오프셋 한 위치. +* `useContentSize` Boolean - `width`와 `height`를 웹 페이지의 크기로 사용합니다. + 이 속성을 사용하면 웹 페이지의 크기에 윈도우 프레임 크기가 추가되므로 실제 창은 조금 더 커질 수 있습니다. +* `center` Boolean - 윈도우 창을 화면 정 중앙에 위치시킵니다. +* `minWidth` Integer - 윈도우 창의 최소 가로 너비. +* `minHeight` Integer - 윈도우 창의 최소 세로 높이. +* `maxWidth` Integer - 윈도우 창의 최대 가로 너비. +* `maxHeight` Integer - 윈도우 창의 최대 세로 높이. +* `resizable` Boolean - 윈도우 창의 크기를 재조정 할 수 있는지 여부. +* `alwaysOnTop` Boolean - 윈도우 창이 언제나 다른 창들 위에 유지되는지 여부. +* `fullscreen` Boolean - 윈도우 창의 전체화면 활성화 여부. + `false`로 지정했을 경우 OS X에선 전체화면 버튼이 숨겨지거나 비활성화됩니다. +* `skipTaskbar` Boolean - 작업 표시줄 어플리케이션 아이콘 표시 여부. +* `kiosk` Boolean - Kiosk(키오스크) 모드. +* `title` String - 기본 윈도우 창 제목. +* `icon` [NativeImage](native-image.md) - 윈도우 아이콘, 생략하면 실행 파일의 아이콘이 대신 사용됩니다. +* `show` Boolean - 윈도우가 생성되면 보여줄지 여부. +* `frame` Boolean - `false`로 지정하면 창을 [Frameless Window](frameless-window.md) 형태로 생성합니다. +* `acceptFirstMouse` Boolean - 윈도우가 비활성화 상태일 때 내부 컨텐츠 클릭 시 활성화 되는 동시에 단일 mouse-down 이벤트를 발생시킬지 여부. +* `disableAutoHideCursor` Boolean - 파이핑중 자동으로 커서를 숨길지 여부. +* `autoHideMenuBar` Boolean - `Alt`를 누르지 않는 한 어플리케이션 메뉴바를 숨길지 여부. +* `enableLargerThanScreen` Boolean - 윈도우 창 크기가 화면 크기보다 크게 재조정 될 수 있는지 여부. +* `backgroundColor` String - 16진수로 표현된 윈도우의 배경 색. `#66CD00` 또는 `#FFF`가 사용될 수 있습니다. + 이 속성은 Linux와 Windows에만 구현되어 있습니다. +* `darkTheme` Boolean - 설정에 상관 없이 무조건 어두운 윈도우 테마를 사용합니다. 몇몇 GTK+3 데스크톱 환경에서만 작동합니다. +* `transparent` Boolean - 윈도우 창을 [투명화](frameless-window.md)합니다. +* `type` String - 윈도우 창 종류를 지정합니다. + 사용할 수 있는 창 종류는 `desktop`, `dock`, `toolbar`, `splash`, `notification`와 같습니다. + 이 속성은 Linux에서만 작동합니다. +* `standardWindow` Boolean - OS X의 표준 윈도우를 텍스쳐 윈도우 대신 사용합니다. 기본 값은 `true`입니다. +* `titleBarStyle` String, OS X - 윈도우 타이틀 바 스타일을 지정합니다. 이 속성은 OS X 10.10 Yosemite 이후 버전만 지원합니다. + 다음 3가지 종류의 값을 사용할 수 있습니다: + * `default` 또는 미지정: 표준 Mac 회색 불투명 스타일을 사용합니다. + * `hidden`: 타이틀 바를 숨기고 컨텐츠 전체를 윈도우 크기에 맞춥니다. + 타이틀 바는 없어지지만 표준 창 컨트롤 ("신호등 버튼")은 왼쪽 상단에 유지됩니다. + * `hidden-inset`: `hidden` 타이틀 바 속성과 함께 신호등 버튼이 윈도우 모서리로부터 약간 더 안쪽으로 들어가도록합니다. +* `webPreferences` Object - 웹 페이지 기능을 설정합니다. 사용할 수 있는 속성은 다음과 같습니다: + * `nodeIntegration` Boolean - node(node.js) 통합 여부. 기본값은 `true`입니다. + * `preload` String - 스크립트를 지정하면 페이지 내의 다른 스크립트가 작동하기 전에 로드됩니다. + 여기서 지정한 스크립트는 페이지의 node 통합 활성화 여부에 상관없이 언제나 모든 node API에 접근할 수 있습니다. + 그리고 `preload` 스크립트의 경로는 절대 경로로 지정해야 합니다. + * `partition` String - 페이지에서 사용할 세션을 지정합니다. 만약 `partition`이 + `persist:`로 시작하면 페이지는 지속성 세션을 사용하며 다른 모든 앱 내의 페이지에서 같은 `partition`을 사용할 수 있습니다. + 만약 `persist:` 접두어로 시작하지 않으면 페이지는 인-메모리 세션을 사용합니다. 여러 페이지에서 같은 `partition`을 지정하면 + 같은 세션을 공유할 수 있습니다. `partition`을 지정하지 않으면 어플리케이션의 기본 세션이 사용됩니다. + * `zoomFactor` Number - 페이지의 기본 줌 값을 지정합니다. 예를 들어 `300%`를 표현하려면 `3.0`으로 지정합니다. + * `javascript` Boolean + * `webSecurity` Boolean - `false`로 지정하면 same-origin 정책을 비활성화합니다. (이 속성은 보통 사람에 의해 웹 사이트를 테스트할 때 사용합니다) + 그리고 `allowDisplayingInsecureContent`와 `allowRunningInsecureContent`이 사용자로부터 `true`로 지정되지 않은 경우 `true`로 지정합니다. + * `allowDisplayingInsecureContent` Boolean - https 페이지에서 http URL에서 로드한 이미지 같은 리소스를 표시할 수 있도록 허용합니다. + * `allowRunningInsecureContent` Boolean - https 페이지에서 http URL에서 로드한 JavaScript와 CSS 또는 플러그인을 실행시킬 수 있도록 허용합니다. + * `images` Boolean + * `java` Boolean + * `textAreasAreResizable` Boolean + * `webgl` Boolean + * `webaudio` Boolean + * `plugins` Boolean - 어떤 플러그인이 활성화되어야 하는지 지정합니다. + * `experimentalFeatures` Boolean + * `experimentalCanvasFeatures` Boolean + * `overlayScrollbars` Boolean + * `overlayFullscreenVideo` Boolean + * `sharedWorker` Boolean + * `directWrite` Boolean - Windows에서 폰트 랜더링을 위해 DirectWrite를 사용하는지를 지정합니다. + * `pageVisibility` Boolean - 현재 윈도우의 가시성을 반영하는 대신 페이지가 visible 또는 hidden 중 지정된 상태를 계속 유지하도록 합니다. + 이 속성을 `true`로 지정하면 DOM 타이머의 스로틀링을 방지할 수 있습니다. + +## Events + +`BrowserWindow` 객체는 다음과 같은 이벤트를 발생시킵니다: + +**참고:** 몇몇 이벤트는 라벨에 특정한 OS에서만 작동합니다. + +### Event: 'page-title-updated' + +Returns: + +* `event` Event + +문서의 제목이 변경될 때 발생하는 이벤트 입니다. +`event.preventDefault()`를 호출하여 네이티브 윈도우의 제목이 변경되는 것을 방지할 수 있습니다. + +### Event: 'close' + +Returns: + +* `event` Event + +Emitted when the window is going to be closed. It's emitted before the +`beforeunload` and `unload` event of the DOM. Calling `event.preventDefault()` +will cancel the close. + +Usually you would want to use the `beforeunload` handler to decide whether the +window should be closed, which will also be called when the window is +reloaded. In Electron, returning an empty string or `false` would cancel the +close. For example: + +```javascript +window.onbeforeunload = function(e) { + console.log('I do not want to be closed'); + + // Unlike usual browsers, in which a string should be returned and the user is + // prompted to confirm the page unload, Electron gives developers more options. + // Returning empty string or false would prevent the unloading now. + // You can also use the dialog API to let the user confirm closing the application. + e.returnValue = false; +}; +``` + +### Event: 'closed' + +Emitted when the window is closed. After you have received this event you should +remove the reference to the window and avoid using it anymore. + +### Event: 'unresponsive' + +Emitted when the web page becomes unresponsive. + +### Event: 'responsive' + +Emitted when the unresponsive web page becomes responsive again. + +### Event: 'blur' + +Emitted when the window loses focus. + +### Event: 'focus' + +Emitted when the window gains focus. + +### Event: 'maximize' + +Emitted when window is maximized. + +### Event: 'unmaximize' + +Emitted when the window exits from maximized state. + +### Event: 'minimize' + +Emitted when the window is minimized. + +### Event: 'restore' + +Emitted when the window is restored from minimized state. + +### Event: 'resize' + +Emitted when the window is getting resized. + +### Event: 'move' + +Emitted when the window is getting moved to a new position. + +__Note__: On OS X this event is just an alias of `moved`. + +### Event: 'moved' _OS X_ + +Emitted once when the window is moved to a new position. + +### Event: 'enter-full-screen' + +Emitted when the window enters full screen state. + +### Event: 'leave-full-screen' + +Emitted when the window leaves full screen state. + +### Event: 'enter-html-full-screen' + +Emitted when the window enters full screen state triggered by html api. + +### Event: 'leave-html-full-screen' + +Emitted when the window leaves full screen state triggered by html api. + +### Event: 'app-command': + +Emitted when an [App Command](https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx) +is invoked. These are typically related to keyboard media keys or browser +commands, as well as the "Back" button built into some mice on Windows. + +```js +someWindow.on('app-command', function(e, cmd) { + // Navigate the window back when the user hits their mouse back button + if (cmd === 'browser-backward' && someWindow.webContents.canGoBack()) { + someWindow.webContents.goBack(); + } +}); +``` + +## Methods + +`BrowserWindow` 객체는 다음과 같은 메서드를 가지고 있습니다: + +### `BrowserWindow.getAllWindows()` + +Returns an array of all opened browser windows. + +### `BrowserWindow.getFocusedWindow()` + +Returns the window that is focused in this application. + +### `BrowserWindow.fromWebContents(webContents)` + +* `webContents` [WebContents](web-contents.md) + +Find a window according to the `webContents` it owns. + +### `BrowserWindow.fromId(id)` + +* `id` Integer + +Find a window according to its ID. + +### `BrowserWindow.addDevToolsExtension(path)` + +* `path` String + +Adds DevTools extension located at `path`, and returns extension's name. + +The extension will be remembered so you only need to call this API once, this +API is not for programming use. + +### `BrowserWindow.removeDevToolsExtension(name)` + +* `name` String + +Remove the DevTools extension whose name is `name`. + +## Instance Properties + +Objects created with `new BrowserWindow` have the following properties: + +```javascript +// In this example `win` is our instance +var win = new BrowserWindow({ width: 800, height: 600 }); +``` + +### `win.webContents` + +The `WebContents` object this window owns, all web page related events and +operations will be done via it. + +See the [`webContents` documentation](web-contents.md) for its methods and +events. + +### `win.id` + +The unique ID of this window. + +## Instance Methods + +Objects created with `new BrowserWindow` have the following instance methods: + +**Note:** Some methods are only available on specific operating systems and are labeled as such. + +### `win.destroy()` + +Force closing the window, the `unload` and `beforeunload` event won't be emitted +for the web page, and `close` event will also not be emitted +for this window, but it guarantees the `closed` event will be emitted. + +You should only use this method when the renderer process (web page) has +crashed. + +### `win.close()` + +Try to close the window, this has the same effect with user manually clicking +the close button of the window. The web page may cancel the close though, see +the [close event](#event-close). + +### `win.focus()` + +Focus on the window. + +### `win.isFocused()` + +Returns a boolean, whether the window is focused. + +### `win.show()` + +Shows and gives focus to the window. + +### `win.showInactive()` + +Shows the window but doesn't focus on it. + +### `win.hide()` + +Hides the window. + +### `win.isVisible()` + +Returns a boolean, whether the window is visible to the user. + +### `win.maximize()` + +Maximizes the window. + +### `win.unmaximize()` + +Unmaximizes the window. + +### `win.isMaximized()` + +Returns a boolean, whether the window is maximized. + +### `win.minimize()` + +Minimizes the window. On some platforms the minimized window will be shown in +the Dock. + +### `win.restore()` + +Restores the window from minimized state to its previous state. + +### `win.isMinimized()` + +Returns a boolean, whether the window is minimized. + +### `win.setFullScreen(flag)` + +* `flag` Boolean + +Sets whether the window should be in fullscreen mode. + +### `win.isFullScreen()` + +Returns a boolean, whether the window is in fullscreen mode. + +### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_ + +* `aspectRatio` The aspect ratio we want to maintain for some portion of the +content view. +* `extraSize` Object (optional) - The extra size not to be included while +maintaining the aspect ratio. Properties: + * `width` Integer + * `height` Integer + +This will have a window maintain an aspect ratio. The extra size allows a +developer to have space, specified in pixels, not included within the aspect +ratio calculations. This API already takes into account the difference between a +window's size and its content size. + +Consider a normal window with an HD video player and associated controls. +Perhaps there are 15 pixels of controls on the left edge, 25 pixels of controls +on the right edge and 50 pixels of controls below the player. In order to +maintain a 16:9 aspect ratio (standard aspect ratio for HD @1920x1080) within +the player itself we would call this function with arguments of 16/9 and +[ 40, 50 ]. The second argument doesn't care where the extra width and height +are within the content view--only that they exist. Just sum any extra width and +height areas you have within the overall content view. + +### `win.setBounds(options)` + +`options` Object, properties: + +* `x` Integer +* `y` Integer +* `width` Integer +* `height` Integer + +Resizes and moves the window to `width`, `height`, `x`, `y`. + +### `win.getBounds()` + +Returns an object that contains window's width, height, x and y values. + +### `win.setSize(width, height)` + +* `width` Integer +* `height` Integer + +Resizes the window to `width` and `height`. + +### `win.getSize()` + +Returns an array that contains window's width and height. + +### `win.setContentSize(width, height)` + +* `width` Integer +* `height` Integer + +Resizes the window's client area (e.g. the web page) to `width` and `height`. + +### `win.getContentSize()` + +Returns an array that contains window's client area's width and height. + +### `win.setMinimumSize(width, height)` + +* `width` Integer +* `height` Integer + +Sets the minimum size of window to `width` and `height`. + +### `win.getMinimumSize()` + +Returns an array that contains window's minimum width and height. + +### `win.setMaximumSize(width, height)` + +* `width` Integer +* `height` Integer + +Sets the maximum size of window to `width` and `height`. + +### `win.getMaximumSize()` + +Returns an array that contains window's maximum width and height. + +### `win.setResizable(resizable)` + +* `resizable` Boolean + +Sets whether the window can be manually resized by user. + +### `win.isResizable()` + +Returns whether the window can be manually resized by user. + +### `win.setAlwaysOnTop(flag)` + +* `flag` Boolean + +Sets whether the window should show always on top of other windows. After +setting this, the window is still a normal window, not a toolbox window which +can not be focused on. + +### `win.isAlwaysOnTop()` + +Returns whether the window is always on top of other windows. + +### `win.center()` + +Moves window to the center of the screen. + +### `win.setPosition(x, y)` + +* `x` Integer +* `y` Integer + +Moves window to `x` and `y`. + +### `win.getPosition()` + +Returns an array that contains window's current position. + +### `win.setTitle(title)` + +* `title` String + +Changes the title of native window to `title`. + +### `win.getTitle()` + +Returns the title of the native window. + +**Note:** The title of web page can be different from the title of the native +window. + +### `win.flashFrame(flag)` + +* `flag` Boolean + +Starts or stops flashing the window to attract user's attention. + +### `win.setSkipTaskbar(skip)` + +* `skip` Boolean + +Makes the window not show in the taskbar. + +### `win.setKiosk(flag)` + +* `flag` Boolean + +Enters or leaves the kiosk mode. + +### `win.isKiosk()` + +Returns whether the window is in kiosk mode. + +### `win.hookWindowMessage(message, callback)` _WINDOWS_ + +* `message` Integer +* `callback` Function + +Hooks a windows message. The `callback` is called when +the message is received in the WndProc. + +### `win.isWindowMessageHooked(message)` _WINDOWS_ + +* `message` Integer + +Returns `true` or `false` depending on whether the message is hooked. + +### `win.unhookWindowMessage(message)` _WINDOWS_ + +* `message` Integer + +Unhook the window message. + +### `win.unhookAllWindowMessages()` _WINDOWS_ + +Unhooks all of the window messages. + +### `win.setRepresentedFilename(filename)` _OS X_ + +* `filename` String + +Sets the pathname of the file the window represents, and the icon of the file +will show in window's title bar. + +### `win.getRepresentedFilename()` _OS X_ + +Returns the pathname of the file the window represents. + +### `win.setDocumentEdited(edited)` _OS X_ + +* `edited` Boolean + +Specifies whether the window’s document has been edited, and the icon in title +bar will become grey when set to `true`. + +### `win.isDocumentEdited()` _OS X_ + +Whether the window's document has been edited. + +### `win.focusOnWebView()` + +### `win.blurWebView()` + +### `win.capturePage([rect, ]callback)` + +* `rect` Object (optional)- The area of page to be captured, properties: + * `x` Integer + * `y` Integer + * `width` Integer + * `height` Integer +* `callback` Function + +Captures a snapshot of the page within `rect`. Upon completion `callback` will +be called with `callback(image)`. The `image` is an instance of +[NativeImage](native-image.md) that stores data of the snapshot. Omitting +`rect` will capture the whole visible page. + +### `win.print([options])` + +Same as `webContents.print([options])` + +### `win.printToPDF(options, callback)` + +Same as `webContents.printToPDF(options, callback)` + +### `win.loadURL(url[, options])` + +Same as `webContents.loadURL(url[, options])`. + +### `win.reload()` + +Same as `webContents.reload`. + +### `win.setMenu(menu)` _Linux_ _Windows_ + +* `menu` Menu + +Sets the `menu` as the window's menu bar, setting it to `null` will remove the +menu bar. + +### `win.setProgressBar(progress)` + +* `progress` Double + +Sets progress value in progress bar. Valid range is [0, 1.0]. + +Remove progress bar when progress < 0; +Change to indeterminate mode when progress > 1. + +On Linux platform, only supports Unity desktop environment, you need to specify +the `*.desktop` file name to `desktopName` field in `package.json`. By default, +it will assume `app.getName().desktop`. + +### `win.setOverlayIcon(overlay, description)` _Windows 7+_ + +* `overlay` [NativeImage](native-image.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 +screen readers + +Sets a 16px overlay onto the current taskbar icon, usually used to convey some +sort of application status or to passively notify the user. + + +### `win.setThumbarButtons(buttons)` _Windows 7+_ + +`buttons` Array of `button` Objects: + +`button` Object, properties: + +* `icon` [NativeImage](native-image.md) - The icon showing in thumbnail + toolbar. +* `tooltip` String (optional) - The text of the button's tooltip. +* `flags` Array (optional) - Control specific states and behaviors + of the button. By default, it uses `enabled`. It can include following + Strings: + * `enabled` - The button is active and available to the user. + * `disabled` - The button is disabled. It is present, but has a visual + state indicating it will not respond to user action. + * `dismissonclick` - When the button is clicked, the taskbar button's + flyout closes immediately. + * `nobackground` - Do not draw a button border, use only the image. + * `hidden` - The button is not shown to the user. + * `noninteractive` - The button is enabled but not interactive; no + pressed button state is drawn. This value is intended for instances + where the button is used in a notification. +* `click` - Function + +Add a thumbnail toolbar with a specified set of buttons to the thumbnail image +of a window in a taskbar button layout. Returns a `Boolean` object indicates +whether the thumbnail has been added successfully. + +The number of buttons in thumbnail toolbar should be no greater than 7 due to +the limited room. Once you setup the thumbnail toolbar, the toolbar cannot be +removed due to the platform's limitation. But you can call the API with an empty +array to clean the buttons. + +### `win.showDefinitionForSelection()` _OS X_ + +Shows pop-up dictionary that searches the selected word on the page. + +### `win.setAutoHideMenuBar(hide)` + +* `hide` Boolean + +Sets whether the window menu bar should hide itself automatically. Once set the +menu bar will only show when users press the single `Alt` key. + +If the menu bar is already visible, calling `setAutoHideMenuBar(true)` won't +hide it immediately. + +### `win.isMenuBarAutoHide()` + +Returns whether menu bar automatically hides itself. + +### `win.setMenuBarVisibility(visible)` + +* `visible` Boolean + +Sets whether the menu bar should be visible. If the menu bar is auto-hide, users +can still bring up the menu bar by pressing the single `Alt` key. + +### `win.isMenuBarVisible()` + +Returns whether the menu bar is visible. + +### `win.setVisibleOnAllWorkspaces(visible)` + +* `visible` Boolean + +Sets whether the window should be visible on all workspaces. + +**Note:** This API does nothing on Windows. + +### `win.isVisibleOnAllWorkspaces()` + +Returns whether the window is visible on all workspaces. + +**Note:** This API always returns false on Windows. From b4eca40d07fbbe7165c8623b268144349e159814 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 03:09:51 +0900 Subject: [PATCH 2/9] Improve grammar * Improve grammar * Standardize docs * Fix typos --- docs-translations/ko-KR/README.md | 2 +- .../ko-KR/api/chrome-command-line-switches.md | 2 +- docs-translations/ko-KR/api/menu-item.md | 29 ++-- docs-translations/ko-KR/api/web-contents.md | 136 +++++++++--------- docs-translations/ko-KR/api/web-view-tag.md | 8 +- .../ko-KR/tutorial/debugging-main-process.md | 2 +- .../ko-KR/tutorial/devtools-extension.md | 10 +- .../ko-KR/tutorial/quick-start.md | 2 +- 8 files changed, 95 insertions(+), 96 deletions(-) diff --git a/docs-translations/ko-KR/README.md b/docs-translations/ko-KR/README.md index 34826f9d340..39b9367d0ec 100644 --- a/docs-translations/ko-KR/README.md +++ b/docs-translations/ko-KR/README.md @@ -7,7 +7,7 @@ * [네이티브 Node 모듈 사용하기](tutorial/using-native-node-modules.md) * [메인 프로세스 디버깅하기](tutorial/debugging-main-process.md) * [Selenium 과 WebDriver 사용하기](tutorial/using-selenium-and-webdriver.md) -* [개발자 콘솔 확장기능](tutorial/devtools-extension.md) +* [개발자 도구 확장 기능](tutorial/devtools-extension.md) * [Pepper 플래시 플러그인 사용하기](tutorial/using-pepper-flash-plugin.md) ## 튜토리얼 diff --git a/docs-translations/ko-KR/api/chrome-command-line-switches.md b/docs-translations/ko-KR/api/chrome-command-line-switches.md index 216d402c41e..d3aa5dd6411 100644 --- a/docs-translations/ko-KR/api/chrome-command-line-switches.md +++ b/docs-translations/ko-KR/api/chrome-command-line-switches.md @@ -28,7 +28,7 @@ HTTP 요청 캐시를 비활성화 합니다. ## --remote-debugging-port=`port` -지정한 `port`에 HTTP 기반의 리모트 디버거를 활성화 시킵니다. (개발자 콘솔) +지정한 `port`에 HTTP 기반의 리모트 디버거를 활성화 시킵니다. (개발자 도구) ## --js-flags=`flags` diff --git a/docs-translations/ko-KR/api/menu-item.md b/docs-translations/ko-KR/api/menu-item.md index fc5539c8cdf..b17d3b9ec39 100644 --- a/docs-translations/ko-KR/api/menu-item.md +++ b/docs-translations/ko-KR/api/menu-item.md @@ -1,6 +1,6 @@ # MenuItem -`menu-item` 모듈은 어플리케이션 또는 컨텍스트 [`menu`](menu.md)에 아이템을 추가할 수 있도록 관련 클래스를 제공합니다. +`menu-item` 모듈은 어플리케이션 또는 컨텍스트 [`menu`](menu.md)에 항목 아이템을 추가할 수 있도록 관련 클래스를 제공합니다. [`menu`](menu.md)에서 예제를 확인할 수 있습니다. @@ -25,10 +25,9 @@ * `id` String - 현재 메뉴 아이템에 대해 유일키를 지정합니다. 이 키는 이후 `position` 옵션에서 사용할 수 있습니다. * `position` String - 미리 지정한 `id`를 이용하여 메뉴 아이템의 위치를 세밀하게 조정합니다. -메뉴 아이템을 생성할 때, 매칭되는 액션이 있다면 수동으로 직접 구현하는 대신 `role`을 설정하여, -고유 OS 경험을 최대한 살릴 것을 권장합니다. +메뉴 아이템을 생성할 때, 다음 목록과 일치하는 표준 동작은 수동으로 직접 구현하는 대신 `role` 속성을 지정하여 고유 OS 경험을 최대한 살릴 수 있습니다. -`role` 속성은 다음 값을 가질 수 있습니다.: +`role` 속성은 다음 값을 가질 수 있습니다: * `undo` * `redo` @@ -36,16 +35,16 @@ * `copy` * `paste` * `selectall` -* `minimize` - 현재 윈도우를 최소화 합니다. -* `close` - 현재 윈도우를 닫습니다. +* `minimize` - 현재 윈도우를 최소화합니다 +* `close` - 현재 윈도우를 닫습니다 -OS X에서 `role`은 다음 값을 추가로 가질 수 있습니다. +OS X에서의 `role`은 다음 값을 추가로 가질 수 있습니다: -* `about` - `orderFrontStandardAboutPanel` 액션에 매핑합니다. -* `hide` - `hide` 액션에 매핑합니다. -* `hideothers` - `hideOtherApplications` 액션에 매핑합니다. -* `unhide` - `unhideAllApplications` 액션에 매핑합니다. -* `front` - `arrangeInFront` 액션에 매핑합니다. -* `window` - 부메뉴가 "Window" 메뉴입니다. -* `help` - 부메뉴가 "Help" 메뉴입니다. -* `services` - 부메뉴가 "Services" 메뉴입니다. +* `about` - 매핑된 `orderFrontStandardAboutPanel` 액션 +* `hide` - 매핑된 `hide` 액션 +* `hideothers` - 매핑된 `hideOtherApplications` 액션 +* `unhide` - 매핑된 `unhideAllApplications` 액션 +* `front` - 매핑된 `arrangeInFront` 액션 +* `window` - 부 메뉴를 가지는 "Window" 메뉴 +* `help` - 부 메뉴를 가지는 "Help" 메뉴 +* `services` - 부 메뉴를 가지는 "Services" 메뉴 diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index 355e019e9c9..89c5a4a767f 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -1,9 +1,8 @@ # webContents -`webContents`는 -[EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter)입니다. +`webContents`는 [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter)를 상속받았습니다. -웹페이지의 렌더링과 관리를 책임지며 [`BrowserWindow`](browser-window.md)의 속성입니다. 다음은 `webContents` 객체를 접근하는 예입니다: +웹 페이지의 렌더링과 관리를 책임지며 [`BrowserWindow`](browser-window.md)의 속성입니다. 다음은 `webContents` 객체에 접근하는 예제입니다: ```javascript const BrowserWindow = require('electron').BrowserWindow; @@ -20,7 +19,7 @@ var webContents = win.webContents; ### Event: 'did-finish-load' -네비게이션이 끝났을 때 발생하는 이벤트입니다. 즉, 탭의 스피너가 멈추고 `onload` 이벤트가 발생했을 때를 얘기합니다. +탐색 작업이 끝났을 때 발생하는 이벤트입니다. 브라우저의 탭의 스피너가 멈추고 `onload` 이벤트가 발생했을 때를 말합니다. ### Event: 'did-fail-load' @@ -31,8 +30,8 @@ Returns: * `errorDescription` String * `validatedURL` String -이 이벤트는 `did-finish-load`와 비슷하나, 로드가 실패했거나 취소되었을 때도 발생합니다. 예를들면 `window.stop()`이 실행되었을 때 발생합니다. -모든 에러 코드들의 목록과 설명은 [여기](https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h)서 확인 가능합니다. +이 이벤트는 `did-finish-load`와 비슷하나, 로드가 실패했거나 취소되었을 때 발생합니다. 예를 들면 `window.stop()`이 실행되었을 때 발생합니다. +발생할 수 있는 전체 에러 코드의 목록과 설명은 [여기](https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h)서 확인할 수 있습니다. ### Event: 'did-frame-finish-load' @@ -41,15 +40,15 @@ Returns: * `event` Event * `isMainFrame` Boolean -프레임(Frame)이 네비게이션을 끝냈을 때 발생하는 이벤트입니다. +프레임(Frame)이 탐색을 끝냈을 때 발생하는 이벤트입니다. ### Event: 'did-start-loading' -탭의 스피너가 회전을 시작한 시점과 같습니다. +브라우저 탭의 스피너가 회전을 시작한 때와 같은 시점에 대응하는 이벤트입니다. ### Event: 'did-stop-loading' -탭의 스피너가 회전을 멈추었을 떄의 시점과 같습니다. +브라우저 탭의 스피너가 회전을 멈추었을 때와 같은 시점에 대응하는 이벤트입니다. ### Event: 'did-get-response-details' @@ -64,7 +63,7 @@ Returns: * `referrer` String * `headers` Object -요청한 리소스의 정보가 존재할 때 발생하는 이벤트입니다. +요청한 리소스에 관련된 자세한 정보를 사용할 수 있을 때 발생하는 이벤트입니다. `status`는 리소스를 다운로드하기 위한 소켓 연결을 나타냅니다. ### Event: 'did-get-redirect-request' @@ -80,7 +79,7 @@ Returns: * `referrer` String * `headers` Object -리소스를 요청할 때 리다이렉트 응답을 받았을 때 발생하는 이벤트입니다. +리소스를 요청하는 동안에 리다이렉트 응답을 받았을 때 발생하는 이벤트입니다. ### Event: 'dom-ready' @@ -95,9 +94,9 @@ Returns: Returns: * `event` Event -* `favicons` Array - Array of URLs +* `favicons` Array - URL 배열 -페이지가 favicon을 받았을 때 발생하는 이벤트입니다. +페이지가 favicon(파비콘) URL을 받았을 때 발생하는 이벤트입니다. ### Event: 'new-window' @@ -108,14 +107,14 @@ Returns: * `frameName` String * `disposition` String - `default`, `foreground-tab`, `background-tab`, `new-window`, `other`중 하나일 수 있습니다. -* `options` Object - 새로운 `BrowserWindow`를 만들 때 사용되는 옵션들입니다. +* `options` Object - 새로운 `BrowserWindow` 객체를 만들 때 사용되는 옵션 객체입니다. 페이지가 `url`에 대하여 새로운 윈도우를 열기위해 요청한 경우 발생하는 이벤트입니다. -`window.open`이나 ``과 같은 외부 링크 등에 의해 요청될 수 있습니다. +`window.open`이나 ``과 같은 외부 링크에 의해 요청될 수 있습니다. -기본값으로 `BrowserWindow`는 `url`로 생성됩니다. +기본값으로 `BrowserWindow`는 `url`을 기반으로 생성됩니다. -`event.preventDefault()`를 호출하면 새로운 창을 만드는 것을 방지할 수 있습니다. +`event.preventDefault()`를 호출하면 새로운 창이 생성되는 것을 방지할 수 있습니다. ### Event: 'will-navigate' @@ -124,13 +123,13 @@ Returns: * `event` Event * `url` String -사용자 또는 페이지가 새로운 네비게이션을 원할 때 발생하는 이벤트입니다. +사용자 또는 페이지가 새로운 페이지로 이동할 때 발생하는 이벤트입니다. `window.location` 객체가 변경되거나 사용자가 페이지의 링크를 클릭했을 때 발생합니다. 이 이벤트는 `webContents.loadURL`과 `webContents.back` 같은 API를 이용하여 프로그램적으로 -시작된 네비게이션에 대해서는 발생하지 않습니다. +시작된 탐색에 대해서는 발생하지 않습니다. -`event.preventDefault()`를 호출하면 네비게이션을 방지할 수 있습니다. +`event.preventDefault()`를 호출하면 탐색을 방지할 수 있습니다. ### Event: 'crashed' @@ -152,15 +151,15 @@ Returns: ### Event: 'devtools-opened' -DevTools가 열렸을 때 발생되는 이벤트입니다. +개발자 도구가 열렸을 때 발생되는 이벤트입니다. ### Event: 'devtools-closed' -DevTools가 닫혔을 때 발생되는 이벤트입니다. +개발자 도구가 닫혔을 때 발생되는 이벤트입니다. ### Event: 'devtools-focused' -DevTools에 포커스가 가거나 DevTools가 열렸을 때 발생되는 이벤트입니다. +개발자 도구에 포커스가 가거나 개발자 도구가 열렸을 때 발생되는 이벤트입니다. ### Event: 'login' @@ -185,13 +184,13 @@ Returns: ## Instance Methods -`webContents`객체는 다음과 같은 인스턴스 메소드들을 가지고 있습니다. +`webContents`객체는 다음과 같은 인스턴스 메서드들을 가지고 있습니다. ### `webContents.session` webContents에서 사용되는 `session`객체를 반환합니다. -[session 문서](session.md)에서 이 객체의 메소드들을 확인할 수 있습니다. +[session](session.md) 문서에서 이 객체의 메서드들을 확인할 수 있습니다. ### `webContents.loadURL(url[, options])` @@ -229,7 +228,7 @@ var currentURL = win.webContents.getURL(); ### `webContents.stop()` -대기중인 네비게이션들을 모두 멈춥니다. +대기중인 탐색 작업을 모두 멈춥니다. ### `webContents.reload()` @@ -237,11 +236,11 @@ var currentURL = win.webContents.getURL(); ### `webContents.reloadIgnoringCache()` -현재 페이지를 캐시를 무시한채로 새로고침합니다. +현재 웹 페이지의 캐시를 무시한 채로 새로고침합니다. ### `webContents.canGoBack()` -브라우저가 이전의 웹 페이지로 돌아갈 수 있는지 여부를 반환합니다. +브라우저가 이전 웹 페이지로 돌아갈 수 있는지 여부를 반환합니다. ### `webContents.canGoForward()` @@ -255,7 +254,7 @@ var currentURL = win.webContents.getURL(); ### `webContents.clearHistory()` -네비게이션 기록을 삭제합니다. +탐색 기록을 삭제합니다. ### `webContents.goBack()` @@ -269,13 +268,13 @@ var currentURL = win.webContents.getURL(); * `index` Integer -브라우저가 지정된 절대 웹 페이지 인덱스로 네비게이트하게 합니다. +브라우저가 지정된 절대 웹 페이지 인덱스로 탐색하게 합니다. ### `webContents.goToOffset(offset)` * `offset` Integer -"current entry"에서 지정된 offset으로 네비게이트 합니다. +"current entry"에서 지정된 offset으로 탐색합니다. ### `webContents.isCrashed()` @@ -285,27 +284,27 @@ var currentURL = win.webContents.getURL(); * `userAgent` String -현재의 웹 페이지의 유저 에이전트를 오버라이드 합니다. +현재 웹 페이지의 유저 에이전트를 덮어씌웁니다. ### `webContents.getUserAgent()` -현재 웹 페이지의 유저 에이전트 `String`을 반환합니다. +현재 웹 페이지의 유저 에이전트 문자열을 반환합니다. ### `webContents.insertCSS(css)` * `css` String -Injects CSS into the current web page. +CSS 코드를 현재 웹 페이지에 삽입합니다. ### `webContents.executeJavaScript(code[, userGesture])` * `code` String * `userGesture` Boolean (optional) -페이지에서 코드를 실행합니다. +페이지에서 자바스크립트 코드를 실행합니다. -브라우저 윈도우에서 `requestFullScreen`와 같은 몇몇 HTML API들은 사용자의 행동으로만 호출될 수 -있습니다. `userGesture`를 `true`로 설정하면 이런 제약을 무시할 수 있습니다. +기본적으로 `requestFullScreen`와 같은 몇몇 HTML API들은 사용자의 조작에 의해서만 호출될 수 있습니다. +`userGesture`를 `true`로 설정하면 이러한 제약을 무시할 수 있습니다. ### `webContents.setAudioMuted(muted)` @@ -319,64 +318,64 @@ Injects CSS into the current web page. ### `webContents.undo()` -웹 페이지에서 `undo` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `undo` 편집 커맨드를 실행합니다. ### `webContents.redo()` -웹 페이지에서 `redo` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `redo` 편집 커맨드를 실행합니다. ### `webContents.cut()` -웹 페이지에서 `cut` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `cut` 편집 커맨드를 실행합니다. ### `webContents.copy()` -웹 페이지에서 `copy` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `copy` 편집 커맨드를 실행합니다. ### `webContents.paste()` -웹 페이지에서 `paste` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `paste` 편집 커맨드를 실행합니다. ### `webContents.pasteAndMatchStyle()` -웹 페이지에서 `pasteAndMatchStyle` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `pasteAndMatchStyle` 편집 커맨드를 실행합니다. ### `webContents.delete()` -웹 페이지에서 `delete` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `delete` 편집 커맨드를 실행합니다. ### `webContents.selectAll()` -웹 페이지에서 `selectAll` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `selectAll` 편집 커맨드를 실행합니다. ### `webContents.unselect()` -웹 페이지에서 `unselect` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `unselect` 편집 커맨드를 실행합니다. ### `webContents.replace(text)` * `text` String -웹 페이지에서 `replace` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `replace` 편집 커맨드를 실행합니다. ### `webContents.replaceMisspelling(text)` * `text` String -웹 페이지에서 `replaceMisspelling` 에디팅 커맨드를 실행합니다. +웹 페이지에서 `replaceMisspelling` 편집 커맨드를 실행합니다. ### `webContents.hasServiceWorker(callback)` * `callback` Function -ServiceWorker가 등록되어있는지 확인하고 `callback`에 대한 응답으로 boolean을 반환합니다. +ServiceWorker가 등록되어있는지 확인하고 `callback`에 대한 응답으로 boolean 값을 반환합니다. ### `webContents.unregisterServiceWorker(callback)` * `callback` Function -ServiceWorker가 존재하면 모두 등록을 해제하고 JS promise가 만족될 때 `callback`에 대한 -응답으로 boolean을 반환하거나 JS promise가 만족되지 않을 때 false를 반환합니다. +ServiceWorker가 존재하면 모두 등록을 해제하고 JS Promise가 만족될 때 `callback`에 대한 +응답으로 boolean을 반환하거나 JS Promise가 만족되지 않을 때 `false`를 반환합니다. ### `webContents.print([options])` @@ -392,8 +391,8 @@ ServiceWorker가 존재하면 모두 등록을 해제하고 JS promise가 만족 웹 페이지에서 `window.print()`를 호출하는 것은 `webContents.print({silent: false, printBackground: false})`를 호출하는 것과 같습니다. -**Note:** 윈도우즈에서 print API는 `pdf.dll`에 의존합니다. 당신의 어플리케이션이 print 기능을 -필요로 하지 않는다면 바이너리 크기를 줄이기 위해 `pdf.dll`을 삭제하셔도 안전합니다. +**Note:** Windows에서의 프린터 API는 `pdf.dll`에 의존합니다. +어플리케이션이 print 기능을 사용하지 않는 경우 전체 바이너리 크기를 줄이기 위해 `pdf.dll`을 삭제해도 됩니다. ### `webContents.printToPDF(options, callback)` @@ -456,18 +455,18 @@ win.webContents.on("did-finish-load", function() { * `path` String -특정 경로를 DevTools의 워크스페이스에 추가합니다. +특정 경로를 개발자 도구의 워크스페이스에 추가합니다. ### `webContents.removeWorkSpace(path)` * `path` String -특정 경로를 DevTools의 워크스페이스에서 제거합니다. +특정 경로를 개발자 도구의 워크스페이스에서 제거합니다. ### `webContents.openDevTools([options])` * `options` Object (optional). Properties: - * `detach` Boolean - 새 창에서 DevTools를 엽니다. + * `detach` Boolean - 새 창에서 개발자 도구를 엽니다. 개발자 도구를 엽니다. @@ -538,18 +537,18 @@ app.on('ready', function() { `parameters` Object, properties: * `screenPosition` String - 에뮬레이트 할 화면 종료를 지정합니다 - (default: `desktop`) + (기본값: `desktop`) * `desktop` * `mobile` * `screenSize` Object - 에뮬레이트 화면의 크기를 지정합니다 (screenPosition == mobile) * `width` Integer - 에뮬레이트 화면의 너비를 지정합니다 * `height` Integer - 에뮬레이트 화면의 높이를 지정합니다 * `viewPosition` Object - 화면에서 뷰의 위치 - (screenPosition == mobile) (default: `{x: 0, y: 0}`) + (screenPosition == mobile) (기본값: `{x: 0, y: 0}`) * `x` Integer - 좌상단 모서리로부터의 x 축의 오프셋 * `y` Integer - 좌상단 모서리로부터의 y 축의 오프셋 * `deviceScaleFactor` Integer - 디바이스의 스케일 팩터(scale factor)를 지정합니다. - (0일 경우 기본 디바이스 스케일 팩터를 기본으로 사용합니다) (default: `0`) + (0일 경우 기본 디바이스 스케일 팩터를 기본으로 사용합니다) (기본값: `0`) * `viewSize` Object - 에뮬레이트 된 뷰의 크기를 지정합니다 (빈 값은 오버라이드 하지 않는 다는 것을 의미합니다) * `width` Integer - 에뮬레이트 된 뷰의 너비를 지정합니다 @@ -572,20 +571,22 @@ app.on('ready', function() { ### `webContents.sendInputEvent(event)` * `event` Object - * `type` String (**required**) - 이벤트의 타입. 다음 값들이 가능합니다. `mouseDown`, + * `type` String (**required**) - 이벤트의 타입. 다음 값들을 사용할 수 있습니다: `mouseDown`, `mouseUp`, `mouseEnter`, `mouseLeave`, `contextMenu`, `mouseWheel`, `keyDown`, `keyUp`, `char`. * `modifiers` Array - 이벤트의 수정자(modifier)들에 대한 배열. 다음 값들을 포함 할 수 - 있습니다. `shift`, `control`, `alt`, `meta`, `isKeypad`, `isAutoRepeat`, + 있습니다: `shift`, `control`, `alt`, `meta`, `isKeypad`, `isAutoRepeat`, `leftButtonDown`, `middleButtonDown`, `rightButtonDown`, `capsLock`, `numLock`, `left`, `right`. -input `event`를 페이지로 보냅니다. +Input `event`를 웹 페이지로 전송합니다. -키보드 이벤트들에 대해서는 `event` 객체는 다음 속성들을 추가적으로 가지고 있습니다: +키보드 이벤트들에 대해서는 `event` 객체는 다음 속성들을 추가로 가지고 있습니다: -* `keyCode` String (**required**) - 키보드 이벤트로 보낼 수 있는 단일 캐릭터. 모든 UTF-8가 - 사용 가능합니다. +* `keyCode` String (**required**) - 키보드 이벤트로 보내지는 문자. + 단일 UTF-8 문자를 사용할 수 있고 이벤트를 발생시키는 다음 키 중 하나를 포함할 수 있습니다: + `enter`, `backspace`, `delete`, `tab`, `escape`, `control`, `alt`, `shift`, `end`, + `home`, `insert`, `left`, `up`, `right`, `down`, `pageUp`, `pageDown`, `printScreen` 마우스 이벤트들에 대해서는 `event` 객체는 다음 속성들을 추가적으로 가지고 있습니다: @@ -631,10 +632,9 @@ BGRA 포맷으로 효율적으로 저장됩니다. 하지만 실제 재프리젠 ### `webContents.devToolsWebContents` -이 `WebContents`에 대한 DevTools의 `WebContents`를 가져옵니다. +이 `WebContents`에 대한 개발자 도구의 `WebContents`를 가져옵니다. -**Note:** 사용자가 절대로 이 객체를 저장해서는 안됩니다. 그럴경우 DevTools가 닫혔을 때, `null`이 -될 수도 있습니다. +**Note:** 사용자가 절대로 이 객체를 저장해서는 안 됩니다. 개발자 도구가 닫혔을 때, `null`이 반환될 수 있습니다. ### `webContents.savePage(fullPath, saveType, callback)` diff --git a/docs-translations/ko-KR/api/web-view-tag.md b/docs-translations/ko-KR/api/web-view-tag.md index eb40151a234..7b3d259fdfc 100644 --- a/docs-translations/ko-KR/api/web-view-tag.md +++ b/docs-translations/ko-KR/api/web-view-tag.md @@ -256,15 +256,15 @@ webview.addEventListener("dom-ready", function() { ### `.openDevTools()` -페이지에 대한 개발자 콘솔을 엽니다. +페이지에 대한 개발자 도구를 엽니다. ### `.closeDevTools()` -페이지에 대한 개발자 콘솔을 닫습니다. +페이지에 대한 개발자 도구를 닫습니다. ### `.isDevToolsOpened()` -페이지에 대한 개발자 콘솔이 열려있는지 확인합니다. 불린 값을 반환합니다. +페이지에 대한 개발자 도구가 열려있는지 확인합니다. 불린 값을 반환합니다. ### `.inspectElement(x, y)` @@ -275,7 +275,7 @@ webview.addEventListener("dom-ready", function() { ### `.inspectServiceWorker()` -Service worker에 대한 개발자 콘솔을 엽니다. +Service worker에 대한 개발자 도구를 엽니다. ### `.undo()` diff --git a/docs-translations/ko-KR/tutorial/debugging-main-process.md b/docs-translations/ko-KR/tutorial/debugging-main-process.md index c11f3db04f3..b03e2542dcd 100644 --- a/docs-translations/ko-KR/tutorial/debugging-main-process.md +++ b/docs-translations/ko-KR/tutorial/debugging-main-process.md @@ -1,6 +1,6 @@ # 메인 프로세스 디버깅하기 -브라우저 창의 개발자 콘솔은 웹 페이지 같은 랜더러 프로세스의 스크립트만 디버깅이 가능합니다. +브라우저 창의 개발자 도구는 웹 페이지 같은 랜더러 프로세스의 스크립트만 디버깅이 가능합니다. 대신 Electron은 메인 프로세스의 디버깅을 위해 `--debug` 과 `--debug-brk` 스위치들을 제공합니다. ## 커맨드 라인 스위치(command line switches) diff --git a/docs-translations/ko-KR/tutorial/devtools-extension.md b/docs-translations/ko-KR/tutorial/devtools-extension.md index 04b592955cd..05ec3893ead 100644 --- a/docs-translations/ko-KR/tutorial/devtools-extension.md +++ b/docs-translations/ko-KR/tutorial/devtools-extension.md @@ -1,8 +1,8 @@ -# 개발자 콘솔 확장 +# 개발자 도구 확장 기능 어플리케이션의 디버깅을 쉽게 하기 위해 Electron은 기본적으로 [Chrome DevTools Extension][devtools-extension]을 지원합니다. -개발자 콘솔 확장 기능은 간단하게 사용할 확장 기능 플러그인의 소스 코드를 다운로드한 후 `BrowserWindow.addDevToolsExtension` API를 이용하여 +개발자 도구 확장 기능은 간단하게 사용할 확장 기능 플러그인의 소스 코드를 다운로드한 후 `BrowserWindow.addDevToolsExtension` API를 이용하여 어플리케이션 내에 로드할 수 있습니다. 한가지 주의할 점은 확장 기능 사용시 창이 생성될 때 마다 일일이 해당 API를 호출할 필요는 없습니다. ** 주의: 현재 React DevTools은 작동하지 않습니다. https://github.com/atom/electron/issues/915 이슈를 참고하세요! ** @@ -19,7 +19,7 @@ $ git clone --recursive https://github.com/facebook/react-devtools.git [`react-devtools/shells/chrome/Readme.md`](https://github.com/facebook/react-devtools/blob/master/shells/chrome/Readme.md) 를 통해 확장 기능을 개발하는 방법을 알아볼 수 있습니다. -그리고 개발자 콘솔에서 다음 코드를 입력하면 확장 기능을 로드할 수 있습니다: +그리고 개발자 도구에서 다음 코드를 입력하면 확장 기능을 로드할 수 있습니다: ```javascript const BrowserWindow = require('electron').remote.BrowserWindow; @@ -32,9 +32,9 @@ BrowserWindow.addDevToolsExtension('/some-directory/react-devtools/shells/chrome BrowserWindow.removeDevToolsExtension('React Developer Tools'); ``` -## 개발자 콘솔 확장 기능의 구성 형식 +## 개발자 도구 확장 기능의 구성 형식 -모든 개발자 콘솔 확장은 완벽히 Chrome 브라우저를 위해 작성되었기 때문에 Electron에서도 로드할 수 있습니다. +모든 개발자 도구 확장은 완벽히 Chrome 브라우저를 위해 작성되었기 때문에 Electron에서도 로드할 수 있습니다. 하지만 반드시 확장 기능은 소스 코드 디렉터리(폴더) 형태여야 합니다. 그래서 `crx` 등의 포맷으로 패키징된 확장 기능의 경우 사용자가 직접 해당 패키지의 압축을 풀어서 로드하지 않는 이상 Electron에서 해당 확장 기능의 압축을 풀 방법이 없습니다. diff --git a/docs-translations/ko-KR/tutorial/quick-start.md b/docs-translations/ko-KR/tutorial/quick-start.md index 2c1aa5f9837..dea6a343e6b 100644 --- a/docs-translations/ko-KR/tutorial/quick-start.md +++ b/docs-translations/ko-KR/tutorial/quick-start.md @@ -93,7 +93,7 @@ app.on('ready', function() { // 그리고 현재 디렉터리의 index.html을 로드합니다. mainWindow.loadURL('file://' + __dirname + '/index.html'); - // 개발자 콘솔을 엽니다. + // 개발자 도구를 엽니다. mainWindow.webContents.openDevTools(); // 창이 닫히면 호출됩니다. From c21d7b537a9621b93dc2e42e1102a258d02613ff Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 03:40:58 +0900 Subject: [PATCH 3/9] Update as upstream --- docs-translations/ko-KR/api/app.md | 4 ++-- docs-translations/ko-KR/api/session.md | 24 +++++++++++++++++++++ docs-translations/ko-KR/api/web-contents.md | 19 ++++++++++------ 3 files changed, 38 insertions(+), 9 deletions(-) diff --git a/docs-translations/ko-KR/api/app.md b/docs-translations/ko-KR/api/app.md index d5fa007618a..51e88c534ff 100644 --- a/docs-translations/ko-KR/api/app.md +++ b/docs-translations/ko-KR/api/app.md @@ -140,8 +140,8 @@ Returns: * `webContents` [WebContents](web-contents.md) * `url` URL * `certificateList` [Objects] - * `data` PEM으로 인코딩된 데이터 - * `issuerName` 발급자의 공통 이름 + * `data` Buffer - PEM으로 인코딩된 데이터 + * `issuerName` String - 발급자의 공통 이름 * `callback` Function 사용자 인증이 요청되었을 때 발생하는 이벤트 입니다. diff --git a/docs-translations/ko-KR/api/session.md b/docs-translations/ko-KR/api/session.md index ad7ceaced4f..749ca6efbb0 100644 --- a/docs-translations/ko-KR/api/session.md +++ b/docs-translations/ko-KR/api/session.md @@ -33,6 +33,30 @@ session.on('will-download', function(event, item, webContents) { }); ``` +### Event: 'untrusted-certificate' + +* `event` Event +* `hostname` String +* `certificate` Object + * `data` Buffer - PEM encoded data + * `issuerName` String +* `callback` Function + +`hostname`에 대한 `certificate`의 유효성 검증이 실패했을 때 발생하는 이벤트 입니다. +인증서를 신뢰한다면 `event.preventDefault()` 와 `callback(true)`를 호출하여 기본 동작을 방지해야 합니다. + +```javascript +session.on('verify-certificate', function(event, hostname, certificate, callback) { + if (hostname == "github.com") { + // verification logic. + event.preventDefault(); + callback(true); + } else { + callback(false); + } +}); +``` + ## Methods `session` 객체는 다음과 같은 메서드와 속성을 가지고 있습니다: diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index 89c5a4a767f..3193527f9c7 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -200,8 +200,13 @@ webContents에서 사용되는 `session`객체를 반환합니다. * `userAgent` String - 요청을 시작한 유저 에이전트. * `extraHeaders` String - "\n"로 구분된 Extra 헤더들. -윈도우에 `url`을 로드합니다. `url`은 `http://` or `file://`과 같은 프로토콜 접두사를 -가지고 있어야 합니다. +윈도우에 웹 페이지 `url`을 로드합니다. `url`은 `http://` or `file://`과 같은 프로토콜 접두사를 가지고 있어야 합니다. +만약 반드시 http 캐시를 사용하지 않고 로드해야 하는 경우 `pragma` 헤더를 사용할 수 있습니다. + +```javascript +const options = {"extraHeaders" : "pragma: no-cache\n"} +webContents.loadURL(url, options) +``` ### `webContents.getURL()` @@ -573,7 +578,7 @@ app.on('ready', function() { * `event` Object * `type` String (**required**) - 이벤트의 타입. 다음 값들을 사용할 수 있습니다: `mouseDown`, `mouseUp`, `mouseEnter`, `mouseLeave`, `contextMenu`, `mouseWheel`, - `keyDown`, `keyUp`, `char`. + `mouseMove`, `keyDown`, `keyUp`, `char`. * `modifiers` Array - 이벤트의 수정자(modifier)들에 대한 배열. 다음 값들을 포함 할 수 있습니다: `shift`, `control`, `alt`, `meta`, `isKeypad`, `isAutoRepeat`, `leftButtonDown`, `middleButtonDown`, `rightButtonDown`, `capsLock`, @@ -581,14 +586,14 @@ app.on('ready', function() { Input `event`를 웹 페이지로 전송합니다. -키보드 이벤트들에 대해서는 `event` 객체는 다음 속성들을 추가로 가지고 있습니다: +키보드 이벤트들에 대해서는 `event` 객체는 다음 속성들을 사용할 수 있습니다: -* `keyCode` String (**required**) - 키보드 이벤트로 보내지는 문자. +* `keyCode` Char or String (**required**) - 키보드 이벤트로 보내지는 문자. 단일 UTF-8 문자를 사용할 수 있고 이벤트를 발생시키는 다음 키 중 하나를 포함할 수 있습니다: `enter`, `backspace`, `delete`, `tab`, `escape`, `control`, `alt`, `shift`, `end`, `home`, `insert`, `left`, `up`, `right`, `down`, `pageUp`, `pageDown`, `printScreen` -마우스 이벤트들에 대해서는 `event` 객체는 다음 속성들을 추가적으로 가지고 있습니다: +마우스 이벤트들에 대해서는 `event` 객체는 다음 속성들을 사용할 수 있습니다: * `x` Integer (**required**) * `y` Integer (**required**) @@ -599,7 +604,7 @@ Input `event`를 웹 페이지로 전송합니다. * `movementY` Integer * `clickCount` Integer -`mouseWheel` 이벤트에 대해서는 `event` 객체는 다음 속성들을 추가적으로 가지고 있습니다: +`mouseWheel` 이벤트에 대해서는 `event` 객체는 다음 속성들을 사용할 수 있습니다: * `deltaX` Integer * `deltaY` Integer From 57aecbc415bb19c07f31802e0913c809e5c7e1a3 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 07:09:10 +0900 Subject: [PATCH 4/9] Small changes --- docs-translations/ko-KR/api/menu-item.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs-translations/ko-KR/api/menu-item.md b/docs-translations/ko-KR/api/menu-item.md index b17d3b9ec39..dfcc4fcb241 100644 --- a/docs-translations/ko-KR/api/menu-item.md +++ b/docs-translations/ko-KR/api/menu-item.md @@ -40,11 +40,11 @@ OS X에서의 `role`은 다음 값을 추가로 가질 수 있습니다: -* `about` - 매핑된 `orderFrontStandardAboutPanel` 액션 -* `hide` - 매핑된 `hide` 액션 -* `hideothers` - 매핑된 `hideOtherApplications` 액션 -* `unhide` - 매핑된 `unhideAllApplications` 액션 -* `front` - 매핑된 `arrangeInFront` 액션 +* `about` - `orderFrontStandardAboutPanel` 액션에 대응 +* `hide` - `hide` 액션에 대응 +* `hideothers` - `hideOtherApplications` 액션에 대응 +* `unhide` - `unhideAllApplications` 액션에 대응 +* `front` - `arrangeInFront` 액션에 대응 * `window` - 부 메뉴를 가지는 "Window" 메뉴 * `help` - 부 메뉴를 가지는 "Help" 메뉴 * `services` - 부 메뉴를 가지는 "Services" 메뉴 From 7cc965b178c44b6e0e7117032f04549bb25ec718 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 09:21:38 +0900 Subject: [PATCH 5/9] Translate docs --- docs-translations/ko-KR/README.md | 2 +- docs-translations/ko-KR/api/browser-window.md | 69 ++++++++++--------- 2 files changed, 36 insertions(+), 35 deletions(-) diff --git a/docs-translations/ko-KR/README.md b/docs-translations/ko-KR/README.md index 39b9367d0ec..a6328586b5d 100644 --- a/docs-translations/ko-KR/README.md +++ b/docs-translations/ko-KR/README.md @@ -32,7 +32,7 @@ * [app](api/app.md) * [autoUpdater](api/auto-updater.md) -* [BrowserWindow (20% 번역됨 - 작업중)](api/browser-window.md) +* [BrowserWindow (30% 번역됨 - 작업중)](api/browser-window.md) * [contentTracing](api/content-tracing.md) * [dialog](api/dialog.md) * [globalShortcut](api/global-shortcut.md) diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index 30165e85851..10dc0a8ff10 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -118,103 +118,104 @@ Returns: * `event` Event -Emitted when the window is going to be closed. It's emitted before the -`beforeunload` and `unload` event of the DOM. Calling `event.preventDefault()` -will cancel the close. +윈도우가 닫히기 시작할 때 발생하는 이벤트입니다. +이 이벤트는 DOM의 `beforeunload` 와 `unload` 이벤트가 호출되기 전에 발생합니다. +`event.preventDefault()`를 호출하여 윈도우 종료를 취소할 수 있습니다. -Usually you would want to use the `beforeunload` handler to decide whether the -window should be closed, which will also be called when the window is -reloaded. In Electron, returning an empty string or `false` would cancel the -close. For example: +보통 창을 닫아야 할지 결정하기 위해 `beforeunload` 이벤트를 사용하려고 할 것입니다. +이 이벤트는 윈도우 컨텐츠를 새로고칠 때도 발생합니다. +Electron에선 빈 문자열 또는 `false`를 전달할 경우 윈도우 종료를 취소합니다. + +예시는 다음과 같습니다: ```javascript window.onbeforeunload = function(e) { console.log('I do not want to be closed'); - // Unlike usual browsers, in which a string should be returned and the user is - // prompted to confirm the page unload, Electron gives developers more options. - // Returning empty string or false would prevent the unloading now. - // You can also use the dialog API to let the user confirm closing the application. + // 반드시 문자열을 반환해야 하고 사용자에게 페이지 언로드에 대한 확인 창을 보여주는 보통의 브라우저와는 달리 + // Electron은 개발자에게 더 많은 옵션을 제공합니다. + // 빈 문자열을 반환하거나 false를 반환하면 페이지 언로드를 방지합니다. + // 또한 dialog API를 통해 사용자에게 어플리케이션을 종료할지에 대한 확인 창을 보여줄 수도 있습니다. e.returnValue = false; }; ``` ### Event: 'closed' -Emitted when the window is closed. After you have received this event you should -remove the reference to the window and avoid using it anymore. +윈도우 종료가 완료된 경우 발생하는 이벤트입니다. +이 이벤트가 발생했을 경우 반드시 윈도우 창의 레퍼런스가 더 이상 사용되지 않도록 제거해야 합니다. ### Event: 'unresponsive' -Emitted when the web page becomes unresponsive. +웹 페이지가 응답하지 않을 때 발생하는 이벤트입니다. ### Event: 'responsive' -Emitted when the unresponsive web page becomes responsive again. +응답하지 않는 웹 페이지가 다시 응답하기 시작했을 때 발생하는 이벤트입니다. ### Event: 'blur' -Emitted when the window loses focus. +윈도우가 포커스를 잃었을 떄 발생하는 이벤트입니다. ### Event: 'focus' -Emitted when the window gains focus. +윈도우가 포커스를 가졌을 때 발생하는 이벤트입니다. ### Event: 'maximize' -Emitted when window is maximized. +윈도우가 최대화됐을 때 발생하는 이벤트입니다. ### Event: 'unmaximize' -Emitted when the window exits from maximized state. +윈도우의 최대화 상태가 해제되었을 때 발생하는 이벤트입니다. ### Event: 'minimize' -Emitted when the window is minimized. +윈도우가 최소화됐을 때 발생하는 이벤트입니다. ### Event: 'restore' -Emitted when the window is restored from minimized state. +윈도우가 최소화 상태에서 복구되었을 때 발생하는 이벤트입니다. ### Event: 'resize' -Emitted when the window is getting resized. +윈도우의 크기가 재조정될 때 발생하는 이벤트입니다. ### Event: 'move' -Emitted when the window is getting moved to a new position. +윈도우가 새로운 위치로 이동될 때 발생하는 이벤트입니다. -__Note__: On OS X this event is just an alias of `moved`. +__참고__: OS X에선 이 이벤트가 그저 `moved` 이벤트의 별칭(alias)으로 사용됩니다. ### Event: 'moved' _OS X_ -Emitted once when the window is moved to a new position. +윈도우가 새로운 위치로 이동되었을 때 발생하는 이벤트입니다. (한 번만) ### Event: 'enter-full-screen' -Emitted when the window enters full screen state. +윈도우가 풀 스크린 모드로 진입할 때 발생하는 이벤트입니다. ### Event: 'leave-full-screen' -Emitted when the window leaves full screen state. +윈도우가 풀 스크린 모드에서 해제될 때 발생하는 이벤트입니다. ### Event: 'enter-html-full-screen' -Emitted when the window enters full screen state triggered by html api. +윈도우가 HTML API에 의해 풀 스크린 모드로 진입할 때 발생하는 이벤트입니다. ### Event: 'leave-html-full-screen' -Emitted when the window leaves full screen state triggered by html api. +윈도우가 HTML API에 의해 풀 스크린 모드에서 해제될 때 발생하는 이벤트입니다. ### Event: 'app-command': -Emitted when an [App Command](https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx) -is invoked. These are typically related to keyboard media keys or browser -commands, as well as the "Back" button built into some mice on Windows. +[App Command](https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx)가 호출됐을 때 발생하는 이벤트입니다. +이 이벤트는 일반적으로 키보드 미디어 키 또는 브라우저 커맨드(기본 동작 키)에 관련되어 있습니다. +예를 들어 Windows에서 작동하는 몇몇 마우스는 "뒤로가기" 같은 동작을 포함하고 있습니다. -```js +```javascript someWindow.on('app-command', function(e, cmd) { - // Navigate the window back when the user hits their mouse back button + // 마우스의 뒤로가기 버튼을 눌렀을 때 뒤로가기 탐색을 실행합니다 if (cmd === 'browser-backward' && someWindow.webContents.canGoBack()) { someWindow.webContents.goBack(); } From d129aa9085ce71e8de21abd489f0e218c18891fe Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 09:50:14 +0900 Subject: [PATCH 6/9] Update as upstream --- docs-translations/ko-KR/api/browser-window.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index 10dc0a8ff10..1046f8bd5ca 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -207,7 +207,7 @@ __참고__: OS X에선 이 이벤트가 그저 `moved` 이벤트의 별칭(alias 윈도우가 HTML API에 의해 풀 스크린 모드에서 해제될 때 발생하는 이벤트입니다. -### Event: 'app-command': +### Event: 'app-command' _Windows_ [App Command](https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx)가 호출됐을 때 발생하는 이벤트입니다. 이 이벤트는 일반적으로 키보드 미디어 키 또는 브라우저 커맨드(기본 동작 키)에 관련되어 있습니다. From 74e8c8d6a59503c9cf9319bf8aa8249e85fd1d68 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 11:28:03 +0900 Subject: [PATCH 7/9] Translate docs, small changes --- docs-translations/ko-KR/README.md | 2 +- docs-translations/ko-KR/api/browser-window.md | 74 +++++++++---------- docs-translations/ko-KR/api/web-contents.md | 4 +- 3 files changed, 37 insertions(+), 43 deletions(-) diff --git a/docs-translations/ko-KR/README.md b/docs-translations/ko-KR/README.md index a6328586b5d..6899c91c32f 100644 --- a/docs-translations/ko-KR/README.md +++ b/docs-translations/ko-KR/README.md @@ -32,7 +32,7 @@ * [app](api/app.md) * [autoUpdater](api/auto-updater.md) -* [BrowserWindow (30% 번역됨 - 작업중)](api/browser-window.md) +* [BrowserWindow (50% 번역됨 - 작업중)](api/browser-window.md) * [contentTracing](api/content-tracing.md) * [dialog](api/dialog.md) * [globalShortcut](api/global-shortcut.md) diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index 1046f8bd5ca..df2d8b4572e 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -228,139 +228,133 @@ someWindow.on('app-command', function(e, cmd) { ### `BrowserWindow.getAllWindows()` -Returns an array of all opened browser windows. +열려있는 모든 브라우저 윈도우의 배열을 반환합니다. ### `BrowserWindow.getFocusedWindow()` -Returns the window that is focused in this application. +어플리케이션에서 포커스된 윈도우를 반환합니다. ### `BrowserWindow.fromWebContents(webContents)` * `webContents` [WebContents](web-contents.md) -Find a window according to the `webContents` it owns. +`webContents`를 소유하고 있는 윈도우를 찾습니다. ### `BrowserWindow.fromId(id)` * `id` Integer -Find a window according to its ID. +ID에 해당하는 윈도우를 찾습니다. ### `BrowserWindow.addDevToolsExtension(path)` * `path` String -Adds DevTools extension located at `path`, and returns extension's name. +`path`에 있는 개발자 도구 확장 기능을 추가합니다. 그리고 확장 기능의 이름을 반환합니다. -The extension will be remembered so you only need to call this API once, this -API is not for programming use. +확장 기능은 기억됩니다. 따라서 API는 단 한 번만 호출되어야 합니다. +이 API는 실제 프로그램 작성에 사용할 수 없습니다. ### `BrowserWindow.removeDevToolsExtension(name)` * `name` String -Remove the DevTools extension whose name is `name`. +`name`에 해당하는 개발자 도구 확장 기능을 제거합니다. ## Instance Properties -Objects created with `new BrowserWindow` have the following properties: +`new BrowserWindow`로 생성한 객체는 다음과 같은 속성을 가지고 있습니다: ```javascript -// In this example `win` is our instance +// `win`은 BrowserWindow의 인스턴스입니다 var win = new BrowserWindow({ width: 800, height: 600 }); ``` ### `win.webContents` -The `WebContents` object this window owns, all web page related events and -operations will be done via it. +윈도우의 `WebContents` 객체입니다. 모든 웹 페이지와 관련된 이벤트와 작업이 이 객체를 통해 수행됩니다. -See the [`webContents` documentation](web-contents.md) for its methods and -events. +메서드나 이벤트에 대한 자세한 내용은 [`webContents` 문서](web-contents.md)를 참고하세요. ### `win.id` -The unique ID of this window. +윈도우의 유일 ID입니다. ## Instance Methods -Objects created with `new BrowserWindow` have the following instance methods: +`new BrowserWindow`로 생성한 객체는 다음과 같은 메서드들을 가지고 있습니다: -**Note:** Some methods are only available on specific operating systems and are labeled as such. +**참고:** 몇몇 메서드들은 라벨에서 특정한 운영체제 시스템에서만 작동합니다. ### `win.destroy()` -Force closing the window, the `unload` and `beforeunload` event won't be emitted -for the web page, and `close` event will also not be emitted -for this window, but it guarantees the `closed` event will be emitted. +윈도우를 강제로 닫습니다. 웹 페이지의 `unload` 와 `beforeunload` 이벤트는 일어나지 않습니다. +또한 이 윈도우의 `close`도 일어나지 않습니다. 하지만 `closed` 이벤트는 반드시 발생함을 보장합니다. -You should only use this method when the renderer process (web page) has -crashed. +이 메서드는 렌더러 프로세스가 예기치 않게 크래시가 일어났을 경우에만 사용해야 합니다. ### `win.close()` -Try to close the window, this has the same effect with user manually clicking -the close button of the window. The web page may cancel the close though, see -the [close event](#event-close). +윈도우의 종료를 시도합니다. 이 메서드는 사용자가 윈도우의 닫기 버튼을 클릭했을 때와 같은 효과를 냅니다. +웹 페이지는 로드가 취소되고 종료됩니다. 자세한 내용은 [close 이벤트](#event-close)를 참고하세요. ### `win.focus()` -Focus on the window. +윈도우에 포커스를 맞춥니다. ### `win.isFocused()` -Returns a boolean, whether the window is focused. +윈도우가 포커스 되었는지 여부를 반환합니다. ### `win.show()` -Shows and gives focus to the window. +윈도우를 표시하고 포커스합니다. ### `win.showInactive()` -Shows the window but doesn't focus on it. +윈도우를 표시만 하고 포커스하지 않습니다. ### `win.hide()` -Hides the window. +윈도우를 숨깁니다. ### `win.isVisible()` -Returns a boolean, whether the window is visible to the user. +윈도우가 사용자에게 표시되고 있는지 여부를 반환합니다. ### `win.maximize()` -Maximizes the window. +윈도우를 최대화 시킵니다. ### `win.unmaximize()` -Unmaximizes the window. +윈도우 최대화를 취소합니다. ### `win.isMaximized()` -Returns a boolean, whether the window is maximized. +윈도우가 최대화 되어있는지 여부를 반환합니다. ### `win.minimize()` -Minimizes the window. On some platforms the minimized window will be shown in -the Dock. +윈도우를 최소화 시킵니다. 어떤 플랫폼은 최소화된 윈도우가 Dock에 표시됩니다. ### `win.restore()` -Restores the window from minimized state to its previous state. +최소화된 윈도우를 이전 상태로 되돌립니다. ### `win.isMinimized()` -Returns a boolean, whether the window is minimized. +윈도우가 최소화 되었는지 여부를 반환합니다. ### `win.setFullScreen(flag)` * `flag` Boolean -Sets whether the window should be in fullscreen mode. +윈도우의 전체화면 상태를 지정합니다. ### `win.isFullScreen()` -Returns a boolean, whether the window is in fullscreen mode. +윈도우가 전체화면 모드 상태인지 여부를 반환합니다. ### `win.setAspectRatio(aspectRatio[, extraSize])` _OS X_ diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index 3193527f9c7..c1452f06379 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -190,7 +190,7 @@ Returns: webContents에서 사용되는 `session`객체를 반환합니다. -[session](session.md) 문서에서 이 객체의 메서드들을 확인할 수 있습니다. +[session 문서](session.md)에서 이 객체의 메서드들을 확인할 수 있습니다. ### `webContents.loadURL(url[, options])` @@ -283,7 +283,7 @@ var currentURL = win.webContents.getURL(); ### `webContents.isCrashed()` -렌더러 프로세스가 예기치 않게 종료되었는지 여부를 반환합니다. +렌더러 프로세스가 예기치 않게 종료 되었는지 여부를 반환합니다. ### `webContents.setUserAgent(userAgent)` From 3af4a40860a2c048a07712a5b692bd9655efaac9 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 11:43:16 +0900 Subject: [PATCH 8/9] Translation docs --- docs-translations/ko-KR/api/browser-window.md | 37 +++++++++---------- 1 file changed, 18 insertions(+), 19 deletions(-) diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index df2d8b4572e..95780bc74ed 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -388,92 +388,91 @@ height areas you have within the overall content view. * `width` Integer * `height` Integer -Resizes and moves the window to `width`, `height`, `x`, `y`. +윈도우를 지정한 `width`, `height`, `x`, `y`로 크기 재조정 및 이동합니다. ### `win.getBounds()` -Returns an object that contains window's width, height, x and y values. +윈도우의 width, height, x, y 값을 가지는 객체를 반환합니다. ### `win.setSize(width, height)` * `width` Integer * `height` Integer -Resizes the window to `width` and `height`. +`width`와 `height` 값으로 윈도우 크기를 재조정합니다. (너비, 높이) ### `win.getSize()` -Returns an array that contains window's width and height. +윈도우의 너비, 높이값을 가지는 배열을 반환합니다. ### `win.setContentSize(width, height)` * `width` Integer * `height` Integer -Resizes the window's client area (e.g. the web page) to `width` and `height`. +윈도우 클라이언트 영역(웹 페이지)의 크기를 `width`, `height`로 재조정합니다. ### `win.getContentSize()` -Returns an array that contains window's client area's width and height. +윈도우 클라이언트 영역의 너비, 높이 크기를 배열로 반환합니다. ### `win.setMinimumSize(width, height)` * `width` Integer * `height` Integer -Sets the minimum size of window to `width` and `height`. +윈도우의 최소 `width`, `height` 크기를 지정합니다. ### `win.getMinimumSize()` -Returns an array that contains window's minimum width and height. +윈도우의 최소 너비, 높이 크기를 배열로 반환합니다. ### `win.setMaximumSize(width, height)` * `width` Integer * `height` Integer -Sets the maximum size of window to `width` and `height`. +윈도우의 최대 `width`, `height` 크기를 지정합니다. ### `win.getMaximumSize()` -Returns an array that contains window's maximum width and height. +윈도우의 최대 너비, 높이 크기를 배열로 반환합니다. ### `win.setResizable(resizable)` * `resizable` Boolean -Sets whether the window can be manually resized by user. +윈도우의 크기가 사용자에 의해 재조정될 수 있는지를 지정합니다. ### `win.isResizable()` -Returns whether the window can be manually resized by user. +윈도우의 크기가 사용자에 의해 재조정될 수 있는지 여부를 반환합니다. ### `win.setAlwaysOnTop(flag)` * `flag` Boolean -Sets whether the window should show always on top of other windows. After -setting this, the window is still a normal window, not a toolbox window which -can not be focused on. +윈도우가 언제나 다른 윈도우들 위에 표시되는지 여부를 지정합니다. +이 설정을 활성화 하면 윈도우는 포커스 될 수 없는 툴박스 윈도우가 아닌 일반 윈도우로 유지됩니다. ### `win.isAlwaysOnTop()` -Returns whether the window is always on top of other windows. +윈도우가 언제나 다른 윈도우들 위에 표시되는지 여부를 반환합니다. ### `win.center()` -Moves window to the center of the screen. +윈도우를 화면 정 중앙으로 이동합니다. ### `win.setPosition(x, y)` * `x` Integer * `y` Integer -Moves window to `x` and `y`. +윈도우의 위치를 `x`, `y`로 이동합니다. ### `win.getPosition()` -Returns an array that contains window's current position. +윈도우의 현재 위치를 배열로 반환합니다. ### `win.setTitle(title)` From 25e5c385561e7ebf625f7534c024b78239f41b26 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 18 Nov 2015 12:45:33 +0900 Subject: [PATCH 9/9] Small changes --- docs-translations/ko-KR/api/browser-window.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index 95780bc74ed..f34830bede3 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -472,19 +472,19 @@ height areas you have within the overall content view. ### `win.getPosition()` -윈도우의 현재 위치를 배열로 반환합니다. +윈도우의 위치를 배열로 반환합니다. ### `win.setTitle(title)` * `title` String -Changes the title of native window to `title`. +`title`을 네이티브 윈도우의 제목으로 지정합니다. ### `win.getTitle()` -Returns the title of the native window. +윈도우의 제목을 반환합니다. -**Note:** The title of web page can be different from the title of the native +**참고:** The title of web page can be different from the title of the native window. ### `win.flashFrame(flag)` @@ -689,10 +689,10 @@ Returns whether the menu bar is visible. Sets whether the window should be visible on all workspaces. -**Note:** This API does nothing on Windows. +**참고:** 이 API는 Windows에서 아무 일도 하지 않습니다. ### `win.isVisibleOnAllWorkspaces()` Returns whether the window is visible on all workspaces. -**Note:** This API always returns false on Windows. +**참고:** 이 API는 Windows에서 언제나 false를 반환합니다.