:memo: Update Korean docs as upstream
authorPlusb Preco <plusb21@gmail.com>
Wed, 18 May 2016 03:15:29 +0000 (12:15 +0900)
committerPlusb Preco <plusb21@gmail.com>
Wed, 18 May 2016 03:15:29 +0000 (12:15 +0900)
[ci skip]

docs-translations/ko-KR/README.md
docs-translations/ko-KR/api/app.md
docs-translations/ko-KR/api/auto-updater.md
docs-translations/ko-KR/api/environment-variables.md
docs-translations/ko-KR/api/remote.md
docs-translations/ko-KR/api/synopsis.md
docs-translations/ko-KR/api/web-view-tag.md
docs-translations/ko-KR/development/source-code-directory-structure.md
docs-translations/ko-KR/tutorial/electron-versioning.md [new file with mode: 0644]

index ecb79c0..b484d6d 100644 (file)
@@ -21,6 +21,7 @@ Electron에 대해 자주 묻는 질문이 있습니다. 이슈를 생성하기
 
 * [지원하는 플랫폼](tutorial/supported-platforms.md)
 * [보안](tutorial/security.md)
+* [Electron 버전 관리](tutorial/electron-versioning.md)
 * [어플리케이션 배포](tutorial/application-distribution.md)
 * [Mac 앱스토어 어플리케이션 제출 가이드](tutorial/mac-app-store-submission-guide.md)
 * [Windows 스토어 가이드](tutorial/windows-store-guide.md)
index b0bf4d7..fbf1fcd 100644 (file)
@@ -24,7 +24,7 @@ Windows, Linux 운영체제에서의 `will-finish-launching` 이벤트는 `ready
 `open-file`과 `open-url` 이벤트 리스너를 설정하고 crash reporter와 auto updater를
 시작합니다.
 
-대부분의 경우, 모든 것을 `ready` 이벤트 핸들러ë¡\9c í\95´ê²°í\95´ì\95¼ í\95©ë\8b\88ë\8b¤.
+대부분의 경우, 모든 것을 `ready` 이벤트 핸들러 ì\95\88ì\97\90ì\84\9c í\95´ê²°í\95´ì\95¼ í\95©ë\8b\88ë\8b¤.
 
 ### Event: 'ready'
 
@@ -34,8 +34,9 @@ Electron이 초기화를 끝냈을 때 발생하는 이벤트입니다.
 
 모든 윈도우가 종료되었을 때 발생하는 이벤트입니다.
 
-이 이벤트는 어플리케이션이 완전히 종료되지 않았을 때만 발생합니다.
-만약 사용자가 `Cmd + Q`를 입력했거나 개발자가 `app.quit()`를 호출했다면,
+만약 이 이벤트를 구독하지 않은 상태로 모든 윈도우가 닫혔을 때의 기본 동작은 앱을
+종료하는 것입니다. 하지만, 이 이벤트를 구독하면, 앱을 종료할지 다른 일을 할지 제어할
+수 있습니다. 만약 사용자가 `Cmd + Q`를 입력했거나 개발자가 `app.quit()`를 호출했다면,
 Electron은 먼저 모든 윈도우의 종료를 시도하고 `will-quit` 이벤트를 발생시킵니다.
 그리고 `will-quit` 이벤트가 발생했을 땐 `window-all-closed` 이벤트가 발생하지
 않습니다.
@@ -63,7 +64,7 @@ Returns:
 모든 윈도우들이 종료되고 어플리케이션이 종료되기 시작할 때 발생하는 이벤트입니다.
 `event.preventDefault()` 호출을 통해 어플리케이션의 종료를 방지할 수 있습니다.
 
-`will-quit` 와 `window-all-closed` 이벤트의 차이점을 확인하려면 `window-all-close`
+`will-quit` 와 `window-all-closed` 이벤트의 차이점을 확인하려면 `window-all-closed`
 이벤트의 설명을 참고하세요.
 
 ### Event: 'quit'
index a551459..86ec453 100644 (file)
@@ -34,6 +34,11 @@ Windows에선 `auto-updater` 모듈을 사용하기 전에 어플리케이션을
 설치해야 합니다. [grunt-electron-installer][installer]를 사용하여 어플리케이션
 인스톨러를 만드는 것을 권장합니다.
 
+Windows에선 `autoUpdater` 모듈을 사용하기 전에 사용자의 장치에 어플리케이션을
+설치해야 합니다. 따라서 [electron-winstaller][installer-lib] 모듈이나
+[grunt-electron-installer][installer] 패키지를 사용하여 어플리케이션 인스톨러를
+만드는 것을 권장합니다.
+
 Squirrel로 생성된 인스톨러는 [Application User Model ID][app-user-model-id]와 함께
 `com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`으로 형식화된 바로가기 아이콘을
 생성합니다. `com.squirrel.slack.Slack` 과 `com.squirrel.code.Code`가 그 예시입니다.
@@ -108,6 +113,7 @@ Returns:
 [server-support]: https://github.com/Squirrel/Squirrel.Mac#server-support
 [squirrel-windows]: https://github.com/Squirrel/Squirrel.Windows
 [installer]: https://github.com/electron/grunt-electron-installer
+[installer-lib]: https://github.com/electron/windows-installer
 [app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx
 [electron-release-server]: https://github.com/ArekSredzki/electron-release-server
 [squirrel-updates-server]: https://github.com/Aluxian/squirrel-updates-server
index 55a5ac5..f24532a 100644 (file)
@@ -50,8 +50,4 @@ Electron이 크래시되면, 크래시 정보 창을 표시합니다.
 
 ## `ELECTRON_FORCE_WINDOW_MENU_BAR` _Linux_
 
-Linux의 글로벌 메뉴 막대를 사용하지 않습니다.
-
-## `ELECTRON_HIDE_INTERNAL_MODULES`
-
-`require('ipc')`같은 예전 방식의 빌트인 모듈을 비활성화합니다.
+Linux의 전역 메뉴바를 사용하지 않습니다.
index da8a544..e626780 100644 (file)
@@ -107,7 +107,7 @@ remote.getCurrentWindow().on('close', () => {
 창을 새로고침 할 때마다 콜백을 새로 설치합니다. 게다가 이전 콜백이 제거되지 않고
 계속해서 쌓이면서 메모리 누수가 발생합니다.
 
\84¤ì\83\81ê°\80ì\83\81ì\9c¼ë¡\9c ì\9d´ì \84ì\97\90 ë\93±ë¡\9dë\90\9c ì½\9cë°±ì\9d\98 ì½\98텍스트가 릴리즈 되고 난 후 (e.g. 페이지 새로고침)
\84¤ì\83\81ê°\80ì\83\81ì\9c¼ë¡\9c ì\9d´ì \84ì\97\90 ë\93±ë¡\9dë\90\9c ì½\9cë°±ì\9d\98 ì»¨텍스트가 릴리즈 되고 난 후 (e.g. 페이지 새로고침)
 `close` 이벤트가 발생하면 예외가 발생하고 메인 프로세스가 작동 중지됩니다.
 
 이러한 문제를 피하려면 렌더러 프로세스에서 메인 프로세스로 넘긴 함수의 참조를 사용 후
index 0413468..cb2ea01 100644 (file)
@@ -71,25 +71,5 @@ const app = electron.app;
 const BrowserWindow = electron.BrowserWindow;
 ```
 
-## 이전 스타일의 빌트인 모듈 비활성화
-
-v0.35.0 이전 버전에선 빌트인 모듈이 모두 `require('module-name')`같은 형식으로
-사용되었습니다. 하지만 [많은 단점][issue-387]이 있기 때문에 현재 API가 변경되었습니다.
-하지만 오래된 앱의 호환성 유지를 위해 아직 구 버전 API를 지원하고 있습니다.
-
-완벽하게 모든 구 버전 API를 비활성화하려면 `ELECTRON_HIDE_INTERNAL_MODULES` 환경
-변수를 설정하면 됩니다:
-
-```javascript
-process.env.ELECTRON_HIDE_INTERNAL_MODULES = 'true'
-```
-
-또는 `hideInternalModules` API를 사용해도 됩니다:
-
-```javascript
-require('electron').hideInternalModules();
-```
-
 [gui]: https://en.wikipedia.org/wiki/Graphical_user_interface
 [destructuring-assignment]: https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment
-[issue-387]: https://github.com/electron/electron/issues/387
index 3191db7..7adbe5c 100644 (file)
@@ -11,6 +11,8 @@
 상호작용이 비동기로 작동한다는 것을 의미합니다. 따라서 임베디드 콘텐츠로부터
 어플리케이션을 안전하게 유지할 수 있습니다.
 
+보안상의 이유로, `webview`는 `nodeIntegration`이 활성화된 `BrowserWindow`에서만 사용할 수 있습니다.
+
 ## 예시
 
 웹 페이지를 어플리케이션에 삽입하려면 `webview` 태그를 사용해 원하는 타겟 페이지에
index 98a3fd2..003eca5 100644 (file)
@@ -60,7 +60,7 @@ Electron
 
 ## Git 서브 모듈 최신 버전으로 유지
 
-Electron 저장소는 몇 가지 외부 벤더 종속성을 가지고 있으며 [/vendor](/vendor)
+Electron 저장소는 몇 가지 외부 벤더 종속성을 가지고 있으며 [/vendor][vendor]
 디렉터리에서 확인할 수 있습니다. 때때로 `git status`를 실행했을 때 아마 다음과 같은
 메시지를 흔히 목격할 것입니다:
 
@@ -84,3 +84,5 @@ git submodule update --init --recursive
 [alias]
        su = submodule update --init --recursive
 ```
+
+[vendor]: https://github.com/electron/electron/tree/master/vendor
diff --git a/docs-translations/ko-KR/tutorial/electron-versioning.md b/docs-translations/ko-KR/tutorial/electron-versioning.md
new file mode 100644 (file)
index 0000000..13d8356
--- /dev/null
@@ -0,0 +1,20 @@
+# Electron 버전 관리
+
+노련한 Node 개발자라면, `semver` (유의적 버전)에 대해 확실히 알고 있을 것입니다 -
+그리고 제공된 의존성 관리 시스템은 고정된 버전 숫자 대신 견고한 가이드라인을 따릅니다.
+Electron은 Node와 Chromium에 큰 의존성을 지니고 있는 만큼, 유의적 버전을 그대로
+따르지 않습니다. 따라서 항상 Electron의 특정 버전을 참조해야 합니다.
+
+버전 숫자는 다음과 같은 규칙으로 올라갑니다:
+
+* Major: Electron API의 주요 변경 사항을 반영합니다 - 만약 `0.37.0`에서 `1.0.0`로
+  업그레이드하는 경우, 어플리케이션을 업데이트해야 합니다.
+* Minor: 주요 Chrome과 Node 버전의 업그레이드를 반영하거나; Electron의 중요한 변경
+  사항을 반영합니다 - 만약 `1.0.0`에서 `1.1.0`로 업그레이드하는 경우, 어플리케이션은
+  여전히 작동하겠지만, 약간의 업데이트가 필요할 수 있습니다.
+* Patch: 새로운 기능과 버그 수정을 반영합니다 - 만약 `1.0.0`에서 `1.0.1`로
+  업그레이드하는 경우, 어플리케이션은 잘 작동할 것입니다.
+
+`electron-prebuilt`를 사용하고 있다면, Electron의 변경 사항을 확실하게 인지하고
+개발자 스스로 업그레이드를 적용하기 위해 고정된 버전 숫자를 사용하는 것을 권장합니다.
+(`^1.1.0` 대신 `1.1.0` 사용)