From 387dd67b6021ff4a4f80157c305f032d50cecf37 Mon Sep 17 00:00:00 2001 From: x-yao Date: Thu, 22 Dec 2016 17:10:27 +0800 Subject: [PATCH 1/4] [ci skip]fix chinese incorrect words --- docs-translations/zh-CN/README.md | 2 +- docs-translations/zh-CN/api/dialog.md | 2 +- docs-translations/zh-CN/api/environment-variables.md | 2 +- docs-translations/zh-CN/api/net.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs-translations/zh-CN/README.md b/docs-translations/zh-CN/README.md index 8c1921f8fd2..ce26eca3d3c 100644 --- a/docs-translations/zh-CN/README.md +++ b/docs-translations/zh-CN/README.md @@ -4,7 +4,7 @@ ## 常见问题 -这里是一些被经常问到的问题，再提 issue 之前请先看一下这里。 +这里是一些被经常问到的问题，在提 issue 之前请先看一下这里。 + [Electron 常见问题](faq/electron-faq.md) diff --git a/docs-translations/zh-CN/api/dialog.md b/docs-translations/zh-CN/api/dialog.md index 34016c52497..366d7b8ff3c 100644 --- a/docs-translations/zh-CN/api/dialog.md +++ b/docs-translations/zh-CN/api/dialog.md @@ -79,7 +79,7 @@ console.log(dialog.showOpenDialog({properties: ['openFile', 'openDirectory', 'mu * `detail` String - 额外信息. * `icon` [NativeImage](native-image.md) * `cancelId` Integer - 当用户关闭对话框的时候，不是通过点击对话框的button，就返回值.默认值为对应 "cancel" 或 "no" 标签button 的索引值, 或者如果没有这种button，就返回0. 在 macOS 和 Windows 上， "Cancel" button 的索引值将一直是 `cancelId`, 不管之前是不是特别指出的. - * `noLink` Boolean - 在 Windows ，Electron 将尝试识别哪个button 是普通 button (如 "Cancel" 或 "Yes"), 然后再对话框中以链接命令(command links)方式展现其它的 button . 这能让对话框展示得很炫酷.如果你不喜欢这种效果，你可以设置 `noLink` 为 `true`. + * `noLink` Boolean - 在 Windows ，Electron 将尝试识别哪个button 是普通 button (如 "Cancel" 或 "Yes"), 然后在对话框中以链接命令(command links)方式展现其它的 button . 这能让对话框展示得很炫酷.如果你不喜欢这种效果，你可以设置 `noLink` 为 `true`. * `callback` Function 展示 message box, 它会阻塞进程，直到 message box 关闭为止.返回点击按钮的索引值. diff --git a/docs-translations/zh-CN/api/environment-variables.md b/docs-translations/zh-CN/api/environment-variables.md index 0a35eb59dfd..706e340245f 100644 --- a/docs-translations/zh-CN/api/environment-variables.md +++ b/docs-translations/zh-CN/api/environment-variables.md @@ -46,7 +46,7 @@ Windows 控制台: ## `ELECTRON_FORCE_WINDOW_MENU_BAR` _Linux_ -不可再 Linux 上使用全局菜单栏. +不可在 Linux 上使用全局菜单栏. ## `ELECTRON_HIDE_INTERNAL_MODULES` diff --git a/docs-translations/zh-CN/api/net.md b/docs-translations/zh-CN/api/net.md index a7575086f8d..7daecfe1692 100644 --- a/docs-translations/zh-CN/api/net.md +++ b/docs-translations/zh-CN/api/net.md @@ -39,7 +39,7 @@ app.on('ready', () => { 也就是说，它对于你使用过 Node.js 的 [HTTP](https://nodejs.org/api/http.html)/[HTTPS](https://nodejs.org/api/https.html) 模块来说是非常的相似的。 -`net` API 只有在应用触发 `ready` 事件后才可以使用。如果再 `ready` 事件前尝试使用会抛出一个错误。 +`net` API 只有在应用触发 `ready` 事件后才可以使用。如果在 `ready` 事件前尝试使用会抛出一个错误。 ## 方法 From 738c8c047eb85f754f84705e35d22b46158705be Mon Sep 17 00:00:00 2001 From: x-yao Date: Mon, 26 Dec 2016 12:02:24 +0800 Subject: [PATCH 2/4] [ci skip]add glossary.md in Simplified Chinese docs --- docs-translations/zh-CN/glossary.md | 96 +++++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 docs-translations/zh-CN/glossary.md diff --git a/docs-translations/zh-CN/glossary.md b/docs-translations/zh-CN/glossary.md new file mode 100644 index 00000000000..e1c33712cdd --- /dev/null +++ b/docs-translations/zh-CN/glossary.md @@ -0,0 +1,96 @@ +# Glossary + +这篇文档说明了一些经常在 Electron 开发中使用的专业术语。 + +### ASAR + +ASAR 代表了 Atom Shell Archive Format。一个 [asar][asar] 压缩包就是一个简单的 `tar` 文件-就像将那些有联系的文件格式化至一个单独的文件中。Electron 能够任意读取其中的文件并且不需要解压缩整个文件。 + +ASAR 格式主要是为了提升 Windows 平台上的性能。TODO + +### Brightray + +Brightray 是能够简单的将 [libchromiumcontent] 应用到应用中的一个静态库。它是专门开发给 Electron 使用，但是也能够使用在那些没有基于 Electron 的原生应用来启用 Chromium 的渲染引擎。 + +Brightray 是 Electron 中的一个低级别的依赖，大部分的 Electron 用户不用关心它。 + +### DMG + +是指在 macOS 上使用的苹果系统的磁盘镜像打包格式。DMG 文件通常被用来分发应用的 "installers"（安装包）。[electron-builder] 支持使用 `dmg` 来作为编译目标。 + +### IPC + +IPC 代表 Inter-Process Communication。Electron 使用 IPC 来在 [主进程] 和 [渲染进程] 进件传递 JSON 信息。 + +### libchromiumcontent + +一个单独的开源库，包含了 Chromium 的模块以及全部依赖（比如 Blink, [V8] 等）。 + +### main process + +主进程，通常是值 `main.js` 文件，是每个 Electron 应用的入口文件。它控制着整个 APP 的生命周期，从打开到关闭。它也管理着原生元素比如菜单，菜单栏，Dock 栏，托盘等。主进程负责创建 APP 的每个渲染进程。而且整个 Node API 都集成在里面。 + +每个 app 的主进程文件都定义在 `package.json` 中的 `main` 属性当中，这也是为什么 `electron .` 能够知道应该使用哪个文件来启动。 + +参见： [process](#process), [renderer-process](#renderer-process) + +### MAS + +是指苹果系统上的 Mac App Store 的缩略词。有关于如何提交你的 app 至 MAS ，详见 [Mac App Store Submission Guide] 。 + +### native modules + +原生模块 （在 Node.js 里也叫 [addons]），是一些使用 C or C++ 编写的能够在 Node.js 中加载或者在 Electron 中使用 require() 方法来加载的模块，它使用起来就如同 Node.js 的模块。它主要用于桥接在 JavaScript 上运行 Node.js 和 C/C++ 的库。 + +Electron 支持了原生的 Node 模块，但是 Electron 非常可能安装一个不一样的 V8 引擎通过 Node 二进制编码，所以在打包原生模块的时候你需要在 指定具体的 Electron 本地头文件。 + +参见： [Using Native Node Modules]. + +## NSIS + +Nullsoft Scriptable Install System 是一个微软 Windows 平台上的脚本驱动的安装制作工具。它发布在免费软件许可证书下，是一个被广泛使用的替代商业专利产品类似于 InstallShield。[electron-builder] 支持使用 NSIS 作为编译目标。 + +### process + +一个进程是计算机程序执行中的一个实例。Electron 应用同时使用了 [main] (主进程) 和一个或者多个 [renderer] （渲染进程）来运行多个程序。 + +在 Node.js 和 Electron 里面，每个运行的进程包含一个 `process` 对象。这个对象作为一个全局的提供当前进程的相关信息，操作方法。作为一个全局变量，它在应用内能够不用 require() 来随时取到。 + +参见： [main process](#main-process), [renderer process](#renderer-process) + +### renderer process + +渲染进程是你的应用内的一个浏览器窗口。与主进程不同的是，它能够同时存在多个而且运行在不一样的进程。而且它们也能够被隐藏。 + +在通常的浏览器内，网页通常运行在一个沙盒的环境挡住并且不能够使用原生的资源。然而 Electron 的用户在 Node.js 的 API 支持下可以在页面中和操作系统进行一些低级别的交互。 + +参见： [process](#process), [main process](#main-process) + +### Squirrel + +Squirrel 是一个开源的框架来让 Electron 的应用能够自动的更新到发布的新的版本。详见 [autoUpdater] API 了解如何开始使用 Squirrel。 + +### userland + +"userland" 或者 "userspace" 术语起源于 Unix 社区，当程序运行在操作系统内核之外。最近这个术语被推广在 Node 和 npm 社区用于区分 "Node core" 与发布的包的功能，对于在 npm 上注册的广大 "user（用户）" 们。 + +就像 Node ，Electron 致力于使用一些少量的设置和 API 来提供所有的必须的支持给开发中的跨平台应用。这个设计理念让 Electron 能够保持灵活而不被过多的规定有关于如何应该被使用。Userland 让用户能够创造和分享一些工具来提额外的功能在这个能够使用的 "core（核心）"之上。 + +### V8 + +V8 是谷歌公司的开源的 JavaScript 引擎。他使用 C++ 编写并使用在谷歌公司开源的的浏览器 Google Chrome 上。V8 能够单独运行或者集成在任何一个 C++ 应用内。 + +### webview + +`webview` 标签用于集成 'guest（访客）' 内容（比如外部的网页）在你的 Electron 应用内。它们类似于 `iframe`，但是不同的是每个 webview 运行在独立的进程中。 作为页面它拥有不一样的权限并且所有的嵌入的内容和你应用之间的交互都将是异步的。这将保证你的应用对于嵌入的内容的安全性。 + +[addons]: https://nodejs.org/api/addons.html +[autoUpdater]: api/auto-updater.md +[electron-builder]: https://github.com/electron-userland/electron-builder +[libchromiumcontent]: #libchromiumcontent +[Mac App Store Submission Guide]: tutorials/mac-app-store-submission-guide.md +[main]: #main-process +[renderer]: #renderer-process +[Using Native Node Modules]: tutorial/using-native-node-modules.md +[userland]: #userland +[V8]: #v8 From 5ee3915c400ab38d8264500b7e538ae8f470ec95 Mon Sep 17 00:00:00 2001 From: x-yao Date: Mon, 26 Dec 2016 17:57:20 +0800 Subject: [PATCH 3/4] [ci skip]fixed glossary.md incorrect words --- docs-translations/zh-CN/glossary.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs-translations/zh-CN/glossary.md b/docs-translations/zh-CN/glossary.md index e1c33712cdd..6791a4faf05 100644 --- a/docs-translations/zh-CN/glossary.md +++ b/docs-translations/zh-CN/glossary.md @@ -4,7 +4,7 @@ ### ASAR -ASAR 代表了 Atom Shell Archive Format。一个 [asar][asar] 压缩包就是一个简单的 `tar` 文件-就像将那些有联系的文件格式化至一个单独的文件中。Electron 能够任意读取其中的文件并且不需要解压缩整个文件。 +ASAR 代表了 Atom Shell Archive Format。一个 asar 压缩包就是一个简单的 `tar` 文件-就像将那些有联系的文件格式化至一个单独的文件中。Electron 能够任意读取其中的文件并且不需要解压缩整个文件。 ASAR 格式主要是为了提升 Windows 平台上的性能。TODO @@ -20,7 +20,7 @@ Brightray 是 Electron 中的一个低级别的依赖，大部分的 Electron ### IPC -IPC 代表 Inter-Process Communication。Electron 使用 IPC 来在 [主进程] 和 [渲染进程] 进件传递 JSON 信息。 +IPC 代表 Inter-Process Communication。Electron 使用 IPC 来在 [主进程] 和 [渲染进程] 之间传递 JSON 信息。 ### libchromiumcontent @@ -32,7 +32,7 @@ IPC 代表 Inter-Process Communication。Electron 使用 IPC 来在 [主进程] 每个 app 的主进程文件都定义在 `package.json` 中的 `main` 属性当中，这也是为什么 `electron .` 能够知道应该使用哪个文件来启动。 -参见： [process](#process), [renderer-process](#renderer-process) +参见： [process](#process), [renderer process](#renderer-process) ### MAS @@ -78,7 +78,7 @@ Squirrel 是一个开源的框架来让 Electron 的应用能够自动的更新 ### V8 -V8 是谷歌公司的开源的 JavaScript 引擎。他使用 C++ 编写并使用在谷歌公司开源的的浏览器 Google Chrome 上。V8 能够单独运行或者集成在任何一个 C++ 应用内。 +V8 是谷歌公司的开源的 JavaScript 引擎。它使用 C++ 编写并使用在谷歌公司开源的的浏览器 Google Chrome 上。V8 能够单独运行或者集成在任何一个 C++ 应用内。 ### webview From 5a54d90d72a6381deccf7a94c667eb48d4253c72 Mon Sep 17 00:00:00 2001 From: x-yao Date: Wed, 28 Dec 2016 15:54:51 +0800 Subject: [PATCH 4/4] [ci skip]update glossary.md translation changes --- docs-translations/zh-CN/glossary.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs-translations/zh-CN/glossary.md b/docs-translations/zh-CN/glossary.md index 6791a4faf05..37ca43d9fb4 100644 --- a/docs-translations/zh-CN/glossary.md +++ b/docs-translations/zh-CN/glossary.md @@ -4,13 +4,13 @@ ### ASAR -ASAR 代表了 Atom Shell Archive Format。一个 asar 压缩包就是一个简单的 `tar` 文件-就像将那些有联系的文件格式化至一个单独的文件中。Electron 能够任意读取其中的文件并且不需要解压缩整个文件。 +ASAR 代表了 Atom Shell Archive Format。一个 [asar][asar] 压缩包就是一个简单的 `tar` 文件-就像将那些有联系的文件格式化至一个单独的文件中。Electron 能够任意读取其中的文件并且不需要解压缩整个文件。 ASAR 格式主要是为了提升 Windows 平台上的性能。TODO ### Brightray -Brightray 是能够简单的将 [libchromiumcontent] 应用到应用中的一个静态库。它是专门开发给 Electron 使用，但是也能够使用在那些没有基于 Electron 的原生应用来启用 Chromium 的渲染引擎。 +[Brightray][brightray] 是能够简单的将 [libchromiumcontent] 应用到应用中的一个静态库。它是专门开发给 Electron 使用，但是也能够使用在那些没有基于 Electron 的原生应用来启用 Chromium 的渲染引擎。 Brightray 是 Electron 中的一个低级别的依赖，大部分的 Electron 用户不用关心它。 @@ -85,7 +85,9 @@ V8 是谷歌公司的开源的 JavaScript 引擎。它使用 C++ 编写并使用 `webview` 标签用于集成 'guest（访客）' 内容（比如外部的网页）在你的 Electron 应用内。它们类似于 `iframe`，但是不同的是每个 webview 运行在独立的进程中。 作为页面它拥有不一样的权限并且所有的嵌入的内容和你应用之间的交互都将是异步的。这将保证你的应用对于嵌入的内容的安全性。 [addons]: https://nodejs.org/api/addons.html +[asar]: https://github.com/electron/asar [autoUpdater]: api/auto-updater.md +[brightray]: https://github.com/electron/brightray [electron-builder]: https://github.com/electron-userland/electron-builder [libchromiumcontent]: #libchromiumcontent [Mac App Store Submission Guide]: tutorials/mac-app-store-submission-guide.md