From bab8f6f60f603f53b51ed9aa821fbb3f4a935b52 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Mon, 13 Jun 2016 03:28:11 +0900 Subject: [PATCH] :memo: Update Korean docs as upstream * Small fixes [ci skip] --- docs-translations/ko-KR/README.md | 2 +- docs-translations/ko-KR/api/app.md | 6 ++-- docs-translations/ko-KR/api/browser-window.md | 11 ++++--- docs-translations/ko-KR/api/dialog.md | 2 +- docs-translations/ko-KR/api/frameless-window.md | 20 ++++++++++--- docs-translations/ko-KR/api/native-image.md | 13 +++++---- docs-translations/ko-KR/api/screen.md | 34 ++++++++++------------ docs-translations/ko-KR/api/shell.md | 2 +- docs-translations/ko-KR/api/web-contents.md | 8 +++-- docs-translations/ko-KR/api/web-view-tag.md | 15 +++++++++- .../tutorial/mac-app-store-submission-guide.md | 2 +- docs-translations/ko-KR/tutorial/quick-start.md | 2 +- 12 files changed, 74 insertions(+), 43 deletions(-) diff --git a/docs-translations/ko-KR/README.md b/docs-translations/ko-KR/README.md index f17b378..cd4ccb9 100644 --- a/docs-translations/ko-KR/README.md +++ b/docs-translations/ko-KR/README.md @@ -6,7 +6,7 @@ URL에 포함되어 있습니다. 만약 그렇지 않다면, 아마 현재 보 수 있습니다. 또한 GitHub 인터페이스의 "Switch branches/tags" 드롭다운 메뉴에서도 사용 중인 Electron 버전으로 변경할 수 있습니다. -**역주:** 한국어 번역 문서는 `atom.io`에 반영되어 있지 않습니다. 한국어 번역 문서는 +**역자주:** 한국어 번역 문서는 `atom.io`에 반영되어 있지 않습니다. 한국어 번역 문서는 현재 `upstream` 원본 문서의 변경에 따라 최대한 문서의 버전을 맞추려고 노력하고 있지만 가끔 누락된 번역이 존재할 수 있습니다. diff --git a/docs-translations/ko-KR/api/app.md b/docs-translations/ko-KR/api/app.md index 80d3343..e86e39e 100644 --- a/docs-translations/ko-KR/api/app.md +++ b/docs-translations/ko-KR/api/app.md @@ -41,7 +41,7 @@ Electron은 먼저 모든 윈도우의 종료를 시도하고 `will-quit` 이벤 그리고 `will-quit` 이벤트가 발생했을 땐 `window-all-closed` 이벤트가 발생하지 않습니다. -**역주:** 이 이벤트는 말 그대로 현재 애플리케이션에서 윈도우만 완전히 종료됬을 때 +**역자주:** 이 이벤트는 말 그대로 현재 애플리케이션에서 윈도우만 완전히 종료됬을 때 발생하는 이벤트입니다. 따라서 애플리케이션을 완전히 종료하려면 이 이벤트에서 `app.quit()`를 호출해 주어야 합니다. @@ -154,7 +154,7 @@ Returns: [browserWindow](browser-window.md)에 대한 포커스가 발생했을 때 발생하는 이벤트입니다. -**역주:** _포커스_ 는 창을 클릭해서 활성화 시켰을 때를 말합니다. +**역자주:** _포커스_ 는 창을 클릭해서 활성화 시켰을 때를 말합니다. ### Event: 'browser-window-created' @@ -330,7 +330,7 @@ Linux에선, 첫 번째로 보여지는 윈도우가 포커스됩니다. OS X에 `name`에 관련한 특정 디렉터리 또는 파일의 경로를 반환합니다. 경로를 가져오는 데 실패할 경우 `Error`를 반환합니다. -**역주:** 이 메서드는 운영체제에서 지정한 특수 디렉터리를 가져오는데 사용할 수 있습니다. +**역자주:** 이 메서드는 운영체제에서 지정한 특수 디렉터리를 가져오는데 사용할 수 있습니다. `name`은 다음 목록에 있는 경로 중 하나를 선택해 사용할 수 있습니다: diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index a5e0dde..457b535 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -867,7 +867,7 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고 ### `win.showDefinitionForSelection()` _OS X_ -페이지의 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다. +`webContents.showDefinitionForSelection()`와 같습니다. ### `win.setIcon(icon)` _Windows_ _Linux_ @@ -896,7 +896,7 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고 메뉴 막대의 표시 여부를 설정합니다. 만약 메뉴 막대 자동 숨김 상태라면 여전히 사용자가 `Alt` 키를 입력하여 메뉴 막대를 표시되도록 할 수 있습니다. -**역주:** 기본 메뉴 막대를 완전히 없애려면 `win.setMenu(null)`를 호출해야 합니다. +**역자주:** 기본 메뉴 막대를 완전히 없애려면 `win.setMenu(null)`를 호출해야 합니다. 단순히 이 API를 사용하면 여전히 메뉴에 등록된 핫 키가 작동합니다. ### `win.isMenuBarVisible()` @@ -917,10 +917,13 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고 **참고:** 이 API는 Windows에서 언제나 false를 반환합니다. -### `win.setIgnoreMouseEvents(ignore)` _OS X_ +### `win.setIgnoreMouseEvents(ignore)` * `ignore` Boolean -윈도우에서 일어나는 모든 마우스 이벤트를 무시합니다. +윈도우가 모든 마우스 이벤트를 무시하게 만듭니다. + +이 윈도우에서 일어나는 모든 마우스 이벤트가 이 윈도우 밑의 윈도우로 전달됩니다. 하지만 +이 윈도우가 포커스되어 있다면, 여전히 키보드 이벤트는 받을 수 있습니다. [blink-feature-string]: https://code.google.com/p/chromium/codesearch#chromium/src/out/Debug/gen/blink/platform/RuntimeEnabledFeatures.cpp&sq=package:chromium&type=cs&l=576 diff --git a/docs-translations/ko-KR/api/dialog.md b/docs-translations/ko-KR/api/dialog.md index e5b820b..6b024d9 100644 --- a/docs-translations/ko-KR/api/dialog.md +++ b/docs-translations/ko-KR/api/dialog.md @@ -116,7 +116,7 @@ const {dialog} = require('electron').remote; 대화 상자를 표시합니다. `browserWindow`를 지정하면 대화 상자가 완전히 닫힐 때까지 지정한 창을 사용할 수 없습니다. 완료 시 유저가 선택한 버튼의 인덱스를 반환합니다. -**역주:** 부정을 표현하는 "아니오", "취소"와 같은 한글 단어는 지원되지 않습니다. 만약 +**역자주:** 부정을 표현하는 "아니오", "취소"와 같은 한글 단어는 지원되지 않습니다. 만약 OS X 또는 Windows에서 "확인", "취소"와 같은 순서로 버튼을 지정하게 될 때 Alt + f4로 해당 대화 상자를 끄게 되면 "확인"을 누른 것으로 판단되어 버립니다. 이를 해결하려면 "Cancel"을 대신 사용하거나 BrowserWindow API를 사용하여 대화 상자를 직접 구현해야 diff --git a/docs-translations/ko-KR/api/frameless-window.md b/docs-translations/ko-KR/api/frameless-window.md index a4919ac..87255e7 100644 --- a/docs-translations/ko-KR/api/frameless-window.md +++ b/docs-translations/ko-KR/api/frameless-window.md @@ -13,8 +13,8 @@ Frameless Window를 만드려면 [BrowserWindow](browser-window.md) 객체의 `options` 객체에서 `frame` 옵션을 `false`로 지정하면 됩니다: ```javascript -const {BrowserWindow} = require('electron'); -let win = new BrowserWindow({width: 800, height: 600, frame: false}); +const {BrowserWindow} = require('electron') +let win = new BrowserWindow({width: 800, height: 600, frame: false}) ``` ### 최신 OS X에서 사용할 수 있는 대안 @@ -25,7 +25,7 @@ OS X 10.10 Yosemite 이후의 최신 버전부터는 테두리가 없는 창을 ("신호등 버튼")의 기능과 창 크기를 그대로 유지할 수 있습니다: ```javascript -let win = new BrowserWindow({titleBarStyle: 'hidden'}); +let win = new BrowserWindow({titleBarStyle: 'hidden'}) ``` ## 투명한 창 만들기 @@ -34,7 +34,7 @@ Frameless Window 창의 배경을 투명하게 만들고 싶다면 `transparent` 바꿔주기만 하면됩니다: ```javascript -let win = new BrowserWindow({transparent: true, frame: false}); +let win = new BrowserWindow({transparent: true, frame: false}) ``` ### API의 한계 @@ -54,6 +54,16 @@ let win = new BrowserWindow({transparent: true, frame: false}); 사용을 중단하고 윈도우를 생성하는데 ARGB를 사용할 수 있도록 해줍니다. * OS X(Mac)에선 네이티브 창에서 보여지는 그림자가 투명한 창에선 보이지 않습니다. +## 클릭이 통과될 수 있는 윈도우 + +클릭이 통과될 수 있는 윈도우를 만드려면, i.e. 모든 마우스 이벤트를 무시하는 윈도우를 +만드려면, [win.setIgnoreMouseEvents(ignore)][ignore-mouse-events] API를 사용하여 +구현할 수 있습니다: + +```javascript +win.setIgnoreMouseEvents(true) +``` + ## 드래그 가능 위치 지정 기본적으로 Frameless Window는 드래그 할 수 없습니다. 애플리케이션의 CSS에서 특정 @@ -101,3 +111,5 @@ Frameless Window에서 텍스트가 선택되는 드래그 동작은 혼란을 드래그 가능 영역에서 오른쪽 클릭 할 경우 시스템 메뉴가 팝업 됩니다. 이러한 이유로 컨텍스트 메뉴 지정 시 모든 플랫폼에서 정상적으로 작동하게 하려면 커스텀 컨텍스트 메뉴를 드래그 영역 내에 만들어선 안됩니다. + +[ignore-mouse-events]: browser-window.md#winsetignoremouseeventsignore diff --git a/docs-translations/ko-KR/api/native-image.md b/docs-translations/ko-KR/api/native-image.md index 165e4ad..c84a899 100644 --- a/docs-translations/ko-KR/api/native-image.md +++ b/docs-translations/ko-KR/api/native-image.md @@ -101,6 +101,12 @@ let appIcon = new Tray('/Users/somebody/images/icon.png'); `path`로부터 이미지를 로드하여 새로운 `nativeImage` 인스턴스를 만듭니다. +```javascript +const nativeImage = require('electron').nativeImage; + +let image = nativeImage.createFromPath('/Users/somebody/images/icon.png'); +``` + ### `nativeImage.createFromBuffer(buffer[, scaleFactor])` * `buffer` [Buffer][buffer] @@ -117,12 +123,7 @@ let appIcon = new Tray('/Users/somebody/images/icon.png'); ## Instance Methods -`nativeImage` 인스턴스 객체에서 사용할 수 있는 메서드 입니다: - -```javascript -const nativeImage = require('electron').nativeImage; -let image = nativeImage.createFromPath('/Users/somebody/images/icon.png'); -``` +`nativeImage` 인스턴스 객체에서 사용할 수 있는 메서드입니다. ### `image.toPng()` diff --git a/docs-translations/ko-KR/api/screen.md b/docs-translations/ko-KR/api/screen.md index 7ac3539..ff59230 100644 --- a/docs-translations/ko-KR/api/screen.md +++ b/docs-translations/ko-KR/api/screen.md @@ -9,46 +9,44 @@ 상속 받았습니다. **참고:** 렌더러 / DevTools에선 이미 DOM 속성이 `window.screen`을 가지고 있으므로 -`screen = require('screen')` 형식으로 모듈을 사용할 수 없습니다. 아래의 예시와 같이 -`electronScreen` 같은 이름으로 모듈 이름을 대체하여 사용해야 합니다. +`screen = require('screen')` 형식으로 모듈을 사용할 수 없습니다. 다음 예시는 화면 전체를 채우는 윈도우 창을 생성합니다: + ```javascript -const {app, BrowserWindow, screen: electronScreen} = require('electron'); +const electron = require('electron') +const {app, BrowserWindow} = electron -let win; +let win app.on('ready', () => { - let {width, height} = electronScreen.getPrimaryDisplay().workAreaSize; - win = new BrowserWindow({width, height}); + const {width, height} = electron.screen.getPrimaryDisplay().workAreaSize + win = new BrowserWindow({width, height}) }); ``` 다음 예시는 확장 디스플레이에 윈도우를 생성합니다: ```javascript -const {app, BrowserWindow, screen: electronScreen} = require('electron'); +const electron = require('electron') +const {app, BrowserWindow} = require('electron') -let win; +let win app.on('ready', () => { - let displays = electronScreen.getAllDisplays(); - let externalDisplay = null; - for (let i in displays) { - if (displays[i].bounds.x !== 0 || displays[i].bounds.y !== 0) { - externalDisplay = displays[i]; - break; - } - } + let displays = electron.screen.getAllDisplays() + let externalDisplay = displays.find((display) => { + return display.bounds.x !== 0 || display.bounds.y !== 0 + }) if (externalDisplay) { win = new BrowserWindow({ x: externalDisplay.bounds.x + 50, y: externalDisplay.bounds.y + 50 - }); + }) } -}); +}) ``` ## `Display` 객체 diff --git a/docs-translations/ko-KR/api/shell.md b/docs-translations/ko-KR/api/shell.md index fe80a9c..9cf8b1e 100644 --- a/docs-translations/ko-KR/api/shell.md +++ b/docs-translations/ko-KR/api/shell.md @@ -39,7 +39,7 @@ shell.openExternal('https://github.com'); mailto: URL은 유저의 기본 이메일 에이전트로 URL을 엽니다.) 애플리케이션이 해당 URL을 열 수 있을 때 `true`를 반환합니다. 아니라면 `false`를 반환합니다. -**역주:** 탐색기로 폴더만 표시하려면 `'file://경로'`와 같이 지정하여 열 수 있습니다. +**역자주:** 탐색기로 폴더만 표시하려면 `'file://경로'`와 같이 지정하여 열 수 있습니다. ### `shell.moveItemToTrash(fullPath)` diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index af80255..3066012 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -289,9 +289,9 @@ Returns: Returns: * `event` Event -* `url` URL +* `url` String -마우스나 키보드를 사용해 링크에 포커스를 할 때 발생하는 이벤트입니다. +마우스나 키보드를 사용해 링크에 포커스할 때 발생하는 이벤트입니다. ### Event: 'cursor-changed' @@ -944,6 +944,10 @@ win.webContents.on('did-finish-load', () => { }); ``` +### `webContents.showDefinitionForSelection()` _OS X_ + +페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다. + ## Instance Properties `WebContents`객체들은 다음 속성들을 가지고 있습니다: diff --git a/docs-translations/ko-KR/api/web-view-tag.md b/docs-translations/ko-KR/api/web-view-tag.md index ce69689..27b8916 100644 --- a/docs-translations/ko-KR/api/web-view-tag.md +++ b/docs-translations/ko-KR/api/web-view-tag.md @@ -324,7 +324,7 @@ Webview에 웹 페이지 `url`을 로드합니다. `url`은 `http://`, `file://` 이 옵션을 활성화 시키면 `requestFullScreen`와 같은 HTML API에서 유저의 승인을 무시하고 개발자가 API를 바로 사용할 수 있도록 허용합니다. -**역주:** 기본적으로 브라우저에선 전체화면, 웹캠, 파일 열기등의 API를 사용하려면 유저의 +**역자주:** 기본적으로 브라우저에선 전체화면, 웹캠, 파일 열기등의 API를 사용하려면 유저의 승인(이벤트)이 필요합니다. ### `.openDevTools()` @@ -468,6 +468,10 @@ Service worker에 대한 개발자 도구를 엽니다. `event` 객체에 대해 자세히 알아보려면 [webContents.sendInputEvent](web-contents.md##webcontentssendinputeventevent)를 참고하세요. +### `.showDefinitionForSelection()` _OS X_ + +페이지에서 선택된 단어에 대한 사전 검색 결과 팝업을 표시합니다. + ### `.getWebContents()` 이 `webview`에 해당하는 [WebContents](web-contents.md)를 반환합니다. @@ -768,6 +772,15 @@ Returns: ```html ``` + +### Event: 'update-target-url' + +Returns: + +* `url` String + +마우스나 키보드를 사용해 링크에 포커스할 때 발생하는 이벤트입니다. + ### Event: 'devtools-opened' 개발자 도구가 열렸을 때 발생하는 이벤트입니다. diff --git a/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md b/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md index c641569..bef0875 100644 --- a/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md +++ b/docs-translations/ko-KR/tutorial/mac-app-store-submission-guide.md @@ -198,7 +198,7 @@ Electron은 다음과 같은 암호화 알고리즘을 사용합니다: ERN의 승인을 얻는 방법은, 다음 글을 참고하는 것이 좋습니다: [애플리케이션이 암호화를 사용할 때, 합법적으로 Apple의 앱 스토어에 제출하는 방법 (또는 ERN의 승인을 얻는 방법)][ern-tutorial]. -**역주:** [Mac 앱 배포 가이드 공식 한국어 문서](https://developer.apple.com/osx/distribution/kr/) +**역자주:** [Mac 앱 배포 가이드 공식 한국어 문서](https://developer.apple.com/osx/distribution/kr/) [developer-program]: https://developer.apple.com/support/compare-memberships/ [submitting-your-app]: https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/SubmittingYourApp/SubmittingYourApp.html diff --git a/docs-translations/ko-KR/tutorial/quick-start.md b/docs-translations/ko-KR/tutorial/quick-start.md index 2673bd6..df3fc09 100644 --- a/docs-translations/ko-KR/tutorial/quick-start.md +++ b/docs-translations/ko-KR/tutorial/quick-start.md @@ -219,7 +219,7 @@ $ ./Electron.app/Contents/MacOS/Electron your-app/ [Node.js](https://nodejs.org/en/download/)가 필요합니다. (CLI에서 실행 가능한 [npm](https://npmjs.org)이 있어야 합니다) -**역주**: `npm`은 보통 Node.js를 설치하면 자동으로 같이 설치됩니다. +**역자주**: `npm`은 보통 Node.js를 설치하면 자동으로 같이 설치됩니다. ```bash # 저장소를 클론합니다 -- 2.7.4