update Quick Start Page[zh-CN]
authorjf_jiang <jf_jiang@dreamarts.co.jp>
Tue, 7 Jun 2016 09:52:01 +0000 (18:52 +0900)
committerjf_jiang <jf_jiang@dreamarts.co.jp>
Tue, 7 Jun 2016 09:52:01 +0000 (18:52 +0900)
Based on electron ver 1.1.3 update Quick Start Page[Simplified
Chinese].

docs-translations/zh-CN/tutorial/quick-start.md

index d267d31..3156f3d 100644 (file)
@@ -1,7 +1,6 @@
 # 快速入门
 
-## 简介
-Electron 可以让你使用纯 JavaScript 调用丰富的原生 APIs 来创造桌面应用。你可以把它看作是专注于桌面应用而不是 web 服务器的,io.js 的一个变体。
+Electron 可以让你使用纯 JavaScript 调用丰富的原生 APIs 来创造桌面应用。你可以把它看作一个专注于桌面应用的 Node.js 的变体,而不是 Web 服务器。
 
 这不意味着 Electron 是绑定了 GUI 库的 JavaScript。相反,Electron 使用 web 页面作为它的 GUI,所以你能把它看作成一个被 JavaScript 控制的,精简版的 Chromium 浏览器。
 
@@ -14,13 +13,13 @@ Electron 可以让你使用纯 JavaScript 调用丰富的原生 APIs 来创造
 在一般浏览器中,网页通常会在沙盒环境下运行,并且不允许访问原生资源。然而,Electron 用户拥有在网页中调用 io.js 的 APIs 的能力,可以与底层操作系统直接交互。
 
 ## 主进程与渲染进程的区别
-主进程使用 BrowserWindow 实例创建网页。每个 BrowserWindow 实例都在自己的渲染进程里运行着一个网页。当一个 BrowserWindow 实例被销毁后,相应的渲染进程也会被终止。
+主进程使用 `BrowserWindow` 实例创建页面。每个 `BrowserWindow` 实例都在自己的渲染进程里运行页面。当一个 `BrowserWindow` 实例被销毁后,相应的渲染进程也会被终止。
 
-主进程管理所有页面和与之对应的渲染进程。每个渲染进程都是相互独立的,并且只关心他们自己的网页
+主进程管理所有页面和与之对应的渲染进程。每个渲染进程都是相互独立的,并且只关心他们自己的页面
 
-由于在网页里管理原生 GUI 资源是非常危险而且容易造成资源泄露,所以在网页面调用 GUI 相关的 APIs 是不被允许的。如果你想在网页里使用 GUI 操作,其对应的渲染进程必须与主进程进行通讯,请求主进程进行相关的 GUI 操作。
+由于在页面里管理原生 GUI 资源是非常危险而且容易造成资源泄露,所以在页面调用 GUI 相关的 APIs 是不被允许的。如果你想在网页里使用 GUI 操作,其对应的渲染进程必须与主进程进行通讯,请求主进程进行相关的 GUI 操作。
 
-在 Electron,我们提供用于在主进程与渲染进程之间通讯的 [ipc][1] 模块。并且也有一个远程进程调用风格的通讯模块 [remote][2]
+在 Electron,我们提供几种方法用于主进程和渲染进程之间的通讯。像 `[ipcRenderer][1]` 和 `[ipcMain][2]` 模块用于发送消息, `[remote][3]` 模块用于 RPC 方式通讯。这些内容都可以在一个 FAQ 中查看 `[how to share data between web pages][4]`
 
 # 打造你第一个 Electron 应用
 大体上,一个 Electron 应用的目录结构如下:
@@ -42,53 +41,72 @@ your-app/
 
 `main.js` 应该用于创建窗口和处理系统事件,一个典型的例子如下:
 ```javascript
-var app = require('app');  // 控制应用生命周期的模块。
-var BrowserWindow = require('browser-window');  // 创建原生浏览器窗口的模块
-
-// 保持一个对于 window 对象的全局引用,不然,当 JavaScript 被 GC,
-// window 会被自动地关闭
-var mainWindow = null;
-
-// 当所有窗口被关闭了,退出。
-app.on('window-all-closed', function() {
-  // 在 OS X 上,通常用户在明确地按下 Cmd + Q 之前
-  // 应用会保持活动状态
-  if (process.platform != 'darwin') {
-    app.quit();
-  }
-});
+const electron = require('electron');
+// 控制应用生命周期的模块。
+const {app} = electron;
+// 创建原生浏览器窗口的模块。
+const {BrowserWindow} = electron;
+
+// 保持一个对于 window 对象的全局引用,如果你不这样做,
+// 当 JavaScript 对象被垃圾回收, window 会被自动地关闭
+let win;
 
-// 当 Electron 完成了初始化并且准备创建浏览器窗口的时候
-// 这个方法就被调用
-app.on('ready', function() {
+function createWindow() {
   // 创建浏览器窗口。
-  mainWindow = new BrowserWindow({width: 800, height: 600});
+  win = new BrowserWindow({width: 800, height: 600});
 
-  // 加载应用的 index.html
-  mainWindow.loadURL('file://' + __dirname + '/index.html');
+  // 加载应用的 index.html
+  win.loadURL(`file://${__dirname}/index.html`);
 
-  // 打开开发工具
-  mainWindow.openDevTools();
+  // 启用开发工具。
+  win.webContents.openDevTools();
 
-  // 当 window 被关闭,这个事件会被发出
-  mainWindow.on('closed', function() {
+  // 当 window 被关闭,这个事件会被触发。
+  win.on('closed', () => {
     // 取消引用 window 对象,如果你的应用支持多窗口的话,
     // 通常会把多个 window 对象存放在一个数组里面,
-    // ä½\86è¿\99次ä¸\8dæ\98¯
-    mainWindow = null;
+    // ä¸\8eæ­¤å\90\8cæ\97¶ï¼\8cä½ åº\94该å\88 é\99¤ç\9b¸åº\94ç\9a\84å\85\83ç´ 
+    win = null;
   });
+}
+
+// This method will be called when Electron has finished
+// initialization and is ready to create browser windows.
+// Some APIs can only be used after this event occurs.
+app.on('ready', createWindow);
+
+// Quit when all windows are closed.
+app.on('window-all-closed', () => {
+  // On OS X it is common for applications and their menu bar
+  // to stay active until the user quits explicitly with Cmd + Q
+  if (process.platform !== 'darwin') {
+    app.quit();
+  }
+});
+
+app.on('activate', () => {
+  // On OS X it's common to re-create a window in the app when the
+  // dock icon is clicked and there are no other windows open.
+  if (win === null) {
+    createWindow();
+  }
 });
+
+// In this file you can include the rest of your app's specific main process
+// code. You can also put them in separate files and require them here.
 ```
 最后,你想展示的 `index.html` :
 ```html
 <!DOCTYPE html>
 <html>
   <head>
+    <meta charset="UTF-8">
     <title>Hello World!</title>
   </head>
   <body>
     <h1>Hello World!</h1>
-    We are using io.js <script>document.write(process.version)</script>
+    We are using node <script>document.write(process.versions.node)</script>,
+    Chrome <script>document.write(process.versions.chrome)</script>,
     and Electron <script>document.write(process.versions.electron)</script>.
   </body>
 </html>
@@ -97,8 +115,9 @@ app.on('ready', function() {
 # 运行你的应用
 一旦你创建了最初的 `main.js`, `index.html` 和 `package.json` 这几个文件,你可能会想尝试在本地运行并测试,看看是不是和期望的那样正常运行。
 
-## electron-prebuild
-如果你已经用 `npm` 全局安装了 `electron-prebuilt`,你只需要按照如下方式直接运行你的应用:
+## electron-prebuilt
+`[electron-prebuilt][5]` 是一个 `npm` 模块,包含所使用的 Electron 预编译版本。 
+如果你已经用 `npm` 全局安装了它,你只需要按照如下方式直接运行你的应用:
 ```bash
 electron .
 ```
@@ -121,13 +140,32 @@ $ ./electron/electron your-app/
 ```bash
 $ ./Electron.app/Contents/MacOS/Electron your-app/
 ```
-`Electron.app` 里面是 Electron 发布包,你可以在[这里][3]下载到。
+`Electron.app` 里面是 Electron 发布包,你可以在 `[这里][6]` 下载到。
 
 # 以发行版本运行
-在你完成了你的应用后,你可以按照[应用部署][4]指导发布一个版本,并且以已经打包好的形式运行应用。
+在你完成了你的应用后,你可以按照 `[应用部署][7]` 指导发布一个版本,并且以已经打包好的形式运行应用。
+
+# 参照下面例子
+复制并且运行这个库 `[atom/electron-quick-start][8]`。
 
+*注意:*运行时需要你的系统已经安装了 `[Git][9]` 和 `[Node.js][10]`(包含 `[npm][11]`)。
 
-  [1]: https://github.com/electron/electron/blob/master/docs-translations/zh-CN/api/ipc-main-process.md
-  [2]: https://github.com/electron/electron/blob/master/docs-translations/zh-CN/api/remote.md
-  [3]: https://github.com/electron/electron/releases
-  [4]: https://github.com/electron/electron/blob/master/docs-translations/zh-CN/tutorial/application-distribution.md
+```bash
+# Clone the repository
+$ git clone https://github.com/electron/electron-quick-start
+# Go into the repository
+$ cd electron-quick-start
+# Install dependencies and run the app
+$ npm install && npm start
+```
+  [1]: https://github.com/electron/electron/blob/v1.1.3/docs/api/ipc-renderer.md
+  [2]: https://github.com/electron/electron/blob/v1.1.3/docs/api/ipc-main.md
+  [3]: https://github.com/electron/electron/blob/v1.1.3/docs/api/remote.md
+  [4]: https://github.com/electron/electron/blob/v1.1.3/docs/faq/electron-faq.md#how-to-share-data-between-web-pages
+  [5]: https://github.com/electron-userland/electron-prebuilt
+  [6]: https://github.com/electron/electron/releases
+  [7]: https://github.com/electron/electron/blob/v1.1.3/docs/tutorial/application-distribution.md
+  [8]: https://github.com/electron/electron-quick-start
+  [9]: https://git-scm.com/
+  [10]: https://nodejs.org/en/download/
+  [11]: https://www.npmjs.com/
\ No newline at end of file