Merge pull request #8355 from oukan/feature/translate-zh-CN

translate to zh-CN

docs-translations/zh-CN/tutorial/using-pepper-flash-plugin.md

@@ -11,34 +11,50 @@ Flash 的插件信息。插件的路径和版本会对 Election 对其的支持
 
 ## 添加插件在 Electron 里的开关
 
-你可以直接在命令行中用 `--ppapi-flash-path` 和 `ppapi-flash-version` 或者
+你可以直接在命令行中用 `--ppapi-flash-path` 和 `--ppapi-flash-version` 或者
 在 app 的准备事件前调用 `app.commandLine.appendSwitch` 这个 method。同时，
-添加 `browser-window` 的插件开关。
+添加 `BrowserWindow` 的插件开关。
 例如：
 
 ```javascript
-// Specify flash path. 设置 flash 路径
-// On Windows, it might be /path/to/pepflashplayer.dll
-// On macOS, /path/to/PepperFlashPlayer.plugin
-// On Linux, /path/to/libpepflashplayer.so
-app.commandLine.appendSwitch('ppapi-flash-path', '/path/to/libpepflashplayer.so')
+const {app, BrowserWindow} = require('electron')
+const path = require('path')
 
-// Specify flash version, for example, v17.0.0.169 设置版本号
+// 指定 flash 路径，假定它与 main.js 放在同一目录中。
+let pluginName
+switch (process.platform) {
+  case 'win32':
+    pluginName = 'pepflashplayer.dll'
+    break
+  case 'darwin':
+    pluginName = 'PepperFlashPlayer.plugin'
+    break
+  case 'linux':
+    pluginName = 'libpepflashplayer.so'
+    break
+}
+app.commandLine.appendSwitch('ppapi-flash-path', path.join(__dirname, pluginName))
+
+// 可选：指定 flash 的版本，例如 v17.0.0.169
 app.commandLine.appendSwitch('ppapi-flash-version', '17.0.0.169')
 
-app.on('ready', function () {
-  mainWindow = new BrowserWindow({
-    'width': 800,
-    'height': 600,
-    'web-preferences': {
-      'plugins': true
+app.on('ready', () => {
+  let win = new BrowserWindow({
+    width: 800,
+    height: 600,
+    webPreferences: {
+      plugins: true
     }
   })
-  mainWindow.loadURL(`file://${__dirname}/index.html`)
-  // Something else
+  win.loadURL(`file://${__dirname}/index.html`)
+  // 还有别的
 })
 ```
 
+您也可以尝试加载系统安装的 Pepper Flash 插件，而不是装运
+插件，其路径可以通过调用
+`app.getPath('pepperFlashSystemPlugin')` 获取。
+
 ## 使用 `<webview>` 标签启用插件
 
 在 `<webview>` 标签里添加 `plugins` 属性。
@@ -46,3 +62,17 @@ app.on('ready', function () {
 ```html
 <webview src="http://www.adobe.com/software/flash/about/" plugins></webview>
 ```
+
+## 错误解决
+
+您可以通过在控制台打印 `navigator.plugins` 来检查 Pepper Flash 插件是否加载
+ （虽然你不知道插件的路径是正确的)。
+
+Pepper Flash 插件的操作系统必须和 Electron 的操作系统匹配。在 Windows 中，
+一个常见的错误是对64位版本的 Electron 使用 32bit 版本的 Flash 插件。
+
+在 Windows 中，传递给 `--ppapi-flash-path` 的路径必须使用 `\` 作为路径
+分隔符，使用 POSIX-style 的路径将无法工作。
+
+对于一些操作，例如使用 RTMP 的流媒体，有必要向播放器的 `.swf` 文件授予更多的权限。
+实现这一点的一种方式是使用 [nw-flash-trust](https://github.com/szwacz/nw-flash-trust)。

docs-translations/zh-CN/tutorial/using-selenium-and-webdriver.md

@@ -4,7 +4,45 @@
 
 > WebDriver 是一款开源的支持多浏览器的自动化测试工具。它提供了操作网页、用户输入、JavaScript 执行等能力。ChromeDriver 是一个实现了 WebDriver 与 Chromium 联接协议的独立服务。它也是由开发了 Chromium 和 WebDriver 的团队开发的。
 
-为了能够使 `chromedriver` 和 Electron 一起正常工作，我们需要告诉它 Electron 在哪，并且让它相信 Electron 就是 Chrome 浏览器。
+## 通过 Spectron 配置
+
+[Spectron][spectron] 是 Electron 官方支持的 ChromeDriver 测试框架。
+它是建立在 [WebdriverIO](http://webdriver.io/) 的顶层，并且
+帮助你在测试中访问 Electron API 和绑定 ChromeDriver。
+
+```bash
+$ npm install --save-dev spectron
+```
+
+```javascript
+// 一个简单的测试验证一个带标题的可见的窗口
+var Application = require('spectron').Application
+var assert = require('assert')
+
+var app = new Application({
+  path: '/Applications/MyApp.app/Contents/MacOS/MyApp'
+})
+
+app.start().then(function () {
+  // 检查浏览器窗口是否可见
+  return app.browserWindow.isVisible()
+}).then(function (isVisible) {
+  // 验证浏览器窗口是否可见
+  assert.equal(isVisible, true)
+}).then(function () {
+  // 获得浏览器窗口的标题
+  return app.client.getTitle()
+}).then(function (title) {
+  // 验证浏览器窗口的标题
+  assert.equal(title, 'My App')
+}).catch(function (error) {
+  // 记录任何错误
+  console.error('Test failed', error.message)
+}).then(function () {
+  // 停止应用程序
+  return app.stop()
+})
+```
 
 ## 通过 WebDriverJs 配置
 
@@ -85,7 +123,7 @@ $ npm install webdriverio
 
 ```javascript
 const webdriverio = require('webdriverio')
-var options = {
+const options = {
   host: 'localhost', // 使用localhost作为ChromeDriver服务器
   port: 9515,        // "9515"是ChromeDriver使用的端口
   desiredCapabilities: {
@@ -97,7 +135,7 @@ var options = {
   }
 }
 
-var client = webdriverio.remote(options)
+let client = webdriverio.remote(options)
 
 client
     .init()
@@ -117,3 +155,4 @@ client
 当然，你也可以在运行 Electron 时传入参数指定你 app 的所在文件夹。这步可以免去你拷贝－粘贴你的 app 到 Electron 的资源目录。
 
 [chrome-driver]: https://sites.google.com/a/chromium.org/chromedriver/
+[spectron]: http://electron.atom.io/spectron

docs-translations/zh-CN/tutorial/using-widevine-cdm-plugin.md

@@ -1,67 +1,70 @@
 # 使用 Widevine CDM 插件
 
-在 Electron ，你可以使用 Widevine CDM 插件装载 Chrome 浏览器 .
+在 Electron，你可以使用 Widevine CDM 插件装载 Chrome 浏览器。
 
 ## 获取插件
 
-Electron 没有为 Widevine CDM 插件 配制许可 reasons, 为了获得它，首先需要安装官方的 chrome 浏览器，这匹配了体系架构和 Electron 构建使用的 chrome 版本 .
+Electron 没有为 Widevine CDM 插件配置许可 reasons，为了获得它，首先需要安装官方的 Chrome 浏览器，这匹配了体系架构和 Electron 构建使用的 Chrome 版本。
 
-__注意:__ Chrome 浏览器的主要版本必须和 Electron 使用的版本一样，否则插件不会有效，虽然 `navigator.plugins` 会显示你已经安装了它 .
+__注意：__ Chrome 浏览器的主要版本必须和 Electron 使用的版本一样，否则插件不会有效，虽然 `navigator.plugins` 会显示你已经安装了它。
 
 ### Windows & macOS
 
-在 Chrome 浏览器中打开 `chrome://components/` ，找到 `WidevineCdm` 并且确定它更新到最新版本，然后你可以从 `APP_DATA/Google/Chrome/WidevineCDM/VERSION/_platform_specific/PLATFORM_ARCH/` 路径找到所有的插件二进制文件 .
+在 Chrome 浏览器中打开 `chrome://components/` ，找到 `WidevineCdm` 并且确定它更新到最新版本，然后你可以从 `APP_DATA/Google/Chrome/WidevineCDM/VERSION/_platform_specific/PLATFORM_ARCH/` 路径找到所有的插件二进制文件。
 
 `APP_DATA` 是系统存放数据的地方，在 Windows 上它是
-`%LOCALAPPDATA%`, 在 macOS 上它是 `~/Library/Application Support`. `VERSION` 是
-Widevine CDM 插件的版本字符串, 类似 `1.4.8.866`. `PLATFORM` 是 `mac` 或
-`win`. `ARCH` 是 `x86` 或 `x64`.
+`%LOCALAPPDATA%`，在 macOS 上它是 `~/Library/Application Support`. `VERSION` 是
+Widevine CDM 插件的版本字符串，类似 `1.4.8.866`. `PLATFORM` 是 `mac` 或
+`win`. `ARCH` 是 `x86` 或 `x64`。
 
 在 Windows，必要的二进制文件是 `widevinecdm.dll` and
-`widevinecdmadapter.dll`, 在 macOS ，它们是 `libwidevinecdm.dylib` 和
-`widevinecdmadapter.plugin`. 你可以将它们复制到任何你喜欢的地方，但是它们必须要放在一起.
+`widevinecdmadapter.dll`，在 macOS，它们是 `libwidevinecdm.dylib` 和
+`widevinecdmadapter.plugin`。你可以将它们复制到任何你喜欢的地方，但是它们必须要放在一起。
 
 ### Linux
 
-在 Linux ，Chrome 浏览器将插件的二进制文件装载在一起 , 你可以在 `/opt/google/chrome` 下找到,文件名是 `libwidevinecdm.so` 和
-`libwidevinecdmadapter.so`.
+在 Linux，Chrome 浏览器将插件的二进制文件装载在一起，你可以在 `/opt/google/chrome` 下找到，文件名是 `libwidevinecdm.so` 和
+`libwidevinecdmadapter.so`。
 
 ## 使用插件
 
-在获得了插件文件后，你可以使用 `--widevine-cdm-path` 命令行开关来将 `widevinecdmadapter` 的路径传递给 Electron , 插件版本使用 `--widevine-cdm-version` 开关.
+在获得了插件文件后，你可以使用 `--widevine-cdm-path` 命令行开关来将 `widevinecdmadapter` 的路径传递给 Electron ，插件版本使用 `--widevine-cdm-version` 开关.
 
-__注意:__ 虽然只有 `widevinecdmadapter` 的二进制文件传递给了  Electron,  `widevinecdm` 二进制文件应当放在它的旁边.
+__注意:__ 虽然只有 `widevinecdmadapter` 的二进制文件传递给了 Electron，`widevinecdm` 二进制文件应当放在它的旁边。
 
-必须在 `app` 模块的 `ready` 事件触发之前使用命令行开关，并且 page 使用的插件必须激活.
+必须在 `app` 模块的 `ready` 事件触发之前使用命令行开关，并且 page 使用的插件必须激活。
 
-示例代码 :
+示例代码：
 
 ```javascript
-// You have to pass the filename of `widevinecdmadapter` here, it is
-// * `widevinecdmadapter.plugin` on macOS,
-// * `libwidevinecdmadapter.so` on Linux,
-// * `widevinecdmadapter.dll` on Windows.
+const {app, BrowserWindow} = require('electron')
+
+// 你必须通过 `widevinecdmadapter` 文件名，它是
+// * `widevinecdmadapter.plugin` on macOS，
+// * `libwidevinecdmadapter.so` on Linux，
+// * `widevinecdmadapter.dll` on Windows。
 app.commandLine.appendSwitch('widevine-cdm-path', '/path/to/widevinecdmadapter.plugin')
-// The version of plugin can be got from `chrome://plugins` page in Chrome.
+// 插件版本可以从 Chrome 浏览器的 `chrome://plugins` 页面获得。
 app.commandLine.appendSwitch('widevine-cdm-version', '1.4.8.866')
 
-var mainWindow = null
-app.on('ready', function () {
-  mainWindow = new BrowserWindow({
+let win = null
+app.on('ready', () => {
+  win = new BrowserWindow({
     webPreferences: {
-      // The `plugins` have to be enabled.
+      // 这个 `plugins` 必须启用。
       plugins: true
     }
   })
+  win.show()
 })
 ```
 
 ## 验证插件
 
-为了验证插件是否工作，你可以使用下面的方法 :
+为了验证插件是否工作，你可以使用下面的方法：
 
-* 打开开发者工具查看是否 `navigator.plugins` 包含了 Widevine
-CDM 插件.
+* 打开开发者工具查看 `navigator.plugins` 是否包含了 Widevine
+CDM 插件。
 * 打开 `https://shaka-player-demo.appspot.com/` 加载一个使用
-`Widevine` 的 manifest.
-* 打开 http://www.dash-player.com/demo/drm-test-area/, 检查是否界面输出 `bitdash uses Widevine in your browser`, 然后播放 video.
+`Widevine` 的 manifest。
+* 打开 http://www.dash-player.com/demo/drm-test-area/，检查是否界面输出 `bitdash uses Widevine in your browser`，然后播放 video。