You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2014/01/30 22:21:01 UTC
[09/57] [abbrv] docs commit: CB-5931 1/28 push latest of edge for
chinese simplified Cordova 3.4
CB-5931 1/28 push latest of edge for chinese simplified Cordova 3.4
Signed-off-by: Shazron Abdullah <sh...@apache.org>
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/909e5fb4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/909e5fb4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/909e5fb4
Branch: refs/heads/master
Commit: 909e5fb4adbc414110070e410646de0f5b24b32c
Parents: 57d0a32
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue Jan 28 17:42:30 2014 -0500
Committer: Shazron Abdullah <sh...@apache.org>
Committed: Thu Jan 30 13:19:53 2014 -0800
----------------------------------------------------------------------
docs/zh/edge/config_ref/images.md | 109 ++-
docs/zh/edge/config_ref/index.md | 87 +--
.../zh/edge/cordova/events/events.backbutton.md | 17 +-
.../edge/cordova/events/events.deviceready.md | 23 +-
.../edge/cordova/events/events.endcallbutton.md | 16 +-
docs/zh/edge/cordova/events/events.md | 70 +-
.../zh/edge/cordova/events/events.menubutton.md | 19 +-
docs/zh/edge/cordova/events/events.pause.md | 27 +-
docs/zh/edge/cordova/events/events.resume.md | 27 +-
.../edge/cordova/events/events.searchbutton.md | 16 +-
.../cordova/events/events.startcallbutton.md | 16 +-
.../cordova/events/events.volumedownbutton.md | 16 +-
.../cordova/events/events.volumeupbutton.md | 16 +-
docs/zh/edge/cordova/plugins/pluginapis.md | 108 +++
docs/zh/edge/cordova/storage/storage.md | 61 +-
docs/zh/edge/guide/appdev/privacy/index.md | 28 +-
docs/zh/edge/guide/appdev/whitelist/index.md | 199 ++---
docs/zh/edge/guide/cli/index.md | 240 ++++--
docs/zh/edge/guide/hybrid/plugins/index.md | 132 +++-
docs/zh/edge/guide/hybrid/webviews/index.md | 5 +-
docs/zh/edge/guide/overview/index.md | 688 +----------------
.../edge/guide/platforms/amazonfireos/config.md | 53 ++
.../edge/guide/platforms/amazonfireos/index.md | 127 ++++
.../edge/guide/platforms/amazonfireos/plugin.md | 100 +++
.../guide/platforms/amazonfireos/webview.md | 116 +++
docs/zh/edge/guide/platforms/android/config.md | 48 +-
docs/zh/edge/guide/platforms/android/index.md | 160 ++--
docs/zh/edge/guide/platforms/android/plugin.md | 199 ++---
docs/zh/edge/guide/platforms/android/tools.md | 30 +-
.../edge/guide/platforms/android/upgrading.md | 387 +++++-----
docs/zh/edge/guide/platforms/android/webview.md | 44 +-
.../edge/guide/platforms/blackberry10/config.md | 10 +-
.../edge/guide/platforms/blackberry10/index.md | 157 ++--
.../edge/guide/platforms/blackberry10/plugin.md | 202 +++--
.../edge/guide/platforms/blackberry10/tools.md | 114 ++-
.../guide/platforms/blackberry10/upgrading.md | 437 +++++------
docs/zh/edge/guide/platforms/index.md | 67 +-
docs/zh/edge/guide/platforms/ios/config.md | 56 +-
docs/zh/edge/guide/platforms/ios/index.md | 108 +--
docs/zh/edge/guide/platforms/ios/plugin.md | 216 +++---
docs/zh/edge/guide/platforms/ios/tools.md | 20 +-
docs/zh/edge/guide/platforms/ios/upgrading.md | 705 ++++++++---------
docs/zh/edge/guide/platforms/ios/webview.md | 111 ++-
docs/zh/edge/guide/platforms/tizen/index.md | 40 +-
docs/zh/edge/guide/platforms/ubuntu/index.md | 89 +++
docs/zh/edge/guide/platforms/win8/index.md | 108 ++-
docs/zh/edge/guide/platforms/win8/tools.md | 18 +-
docs/zh/edge/guide/platforms/win8/upgrading.md | 41 +-
docs/zh/edge/guide/platforms/wp7/index.md | 81 +-
docs/zh/edge/guide/platforms/wp8/index.md | 109 ++-
docs/zh/edge/guide/platforms/wp8/plugin.md | 199 ++---
docs/zh/edge/guide/platforms/wp8/tools.md | 55 +-
docs/zh/edge/guide/platforms/wp8/upgrading.md | 403 +++++-----
docs/zh/edge/guide/support/index.md | 752 +++++++++++++++++++
docs/zh/edge/index.md | 149 +---
docs/zh/edge/plugin_ref/plugman.md | 141 +++-
docs/zh/edge/plugin_ref/spec.md | 241 +++---
57 files changed, 4370 insertions(+), 3443 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/config_ref/images.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/config_ref/images.md b/docs/zh/edge/config_ref/images.md
index 06fe59d..35ff374 100644
--- a/docs/zh/edge/config_ref/images.md
+++ b/docs/zh/edge/config_ref/images.md
@@ -1,6 +1,6 @@
---
-license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. 請參閱分散式與此工作為版權的擁有權有關的其他資訊的通知檔。 ASF 許可證，此檔到你根據 Apache 許可證，2.0 版 （"許可證"） ；您不可能使用此檔除了符合許可證。 You may obtain a copy of the License at
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. 请参阅分布式与此工作为版权的所有权有关的其他信息的通知文件。 ASF 许可证，此文件到你根据 Apache 许可证，2.0 版 （"许可证"） ；您不可能使用此文件除了符合许可证。 You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
@@ -14,15 +14,15 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# 圖示和啟動畫面
+# 图标和启动画面
-這一節演示如何配置應用程式的圖示和可選初始螢幕上的各種平臺上，兩者在科爾多瓦 CLI （描述在命令列介面） 中工作時或使用特定于平臺 SDK 工具 （平臺指南中詳細說明）。
+这一节演示如何配置应用程序的图标和可选初始屏幕上的各种平台上，两者在科尔多瓦 CLI （描述在命令行界面） 中工作时或使用特定于平台 SDK 工具 （平台指南中详细说明）。
-## 在 CLI 中配置圖示
+## 在 CLI 中配置图标
-工作時在 CLI 中，圖示原始檔案位於內各種平臺特定子目錄內專案的 `www/res/icons` 目錄。 新創建的專案來與一組預設的科爾多瓦圖示為您替換為您希望為目標的平臺。
+工作时在 CLI 中，图标源文件位于内各种平台特定子目录内项目的 `www/res/icons` 目录。 新创建的项目来与一组默认的科尔多瓦图标为您替换为您希望为目标的平台。
-Android 系統指定的低、 中、 高、 特高的各項決議的圖示：
+Android 系统指定的低、 中、 高、 特高的各项决议的图标：
android/icon-36-ldpi.png
android/icon-48-mdpi.png
@@ -30,7 +30,7 @@ Android 系統指定的低、 中、 高、 特高的各項決議的圖示：
android/icon-96-xhdpi.png
-IOS 平臺指定 72 圖元正方形圖示為 Ipad，並為 Iphone 和 Ipod，帶有高解析度*2 x*變形為視網膜的 57 圖元圖示顯示：
+IOS 平台指定 72 像素正方形图标为 Ipad，并为 Iphone 和 Ipod，带有高分辨率*2 x*变形为视网膜的 57 像素图标显示：
ios/icon-57-2x.png
ios/icon-57.png
@@ -38,28 +38,32 @@ IOS 平臺指定 72 圖元正方形圖示為 Ipad，並為 Iphone 和 Ipod，帶
ios/icon-72.png
-Windows Phone 指定預設 48 圖元的圖示，以及各種設備背景平鋪在代表應用程式時使用的圖像：
+Windows Phone 指定默认 48 像素的图标，以及各种设备背景平铺在代表应用程序时使用的图像：
windows-phone/icon-48.png
windows-phone/icon-62-tile.png
windows-phone/icon-173-tile.png
-黑莓手機需要 80 圖元的圖示：
+黑莓 10 需要一个在 config.xml 中的图标元素：
- blackberry/icon-80.png
+ <icon src="blackberry10/icon-86.png" />
-Tizen 需要 128 圖元的圖示：
+为多个大小和区域设置，请参阅BlackBerry的文档。
+
+http://developer.blackberry.com/html5/documentation/icon_element.html
+
+Tizen 需要 128 像素的图标：
tizen/icon-128.png
-## 在 CLI 中配置初始螢幕
+## 在 CLI 中配置初始屏幕
-使用閃屏 API 來啟用應用程式的介紹性閃屏在許多平臺上的顯示。 工作時在 CLI 中，初始螢幕原始程式碼檔位於專案的 `www/res/screens` 子目錄。
+使用闪屏 API 来启用应用程序的介绍性闪屏在许多平台上的显示。 在 CLI 中工作时，初始屏幕源代码文件被放置在项目的 `www/res/screens` 子目录中。
-Android 系統指定這兩個面向肖像和風景閃屏圖像為低、 中、 高、 特高的各項決議：
+Android 系统为低、 中、 高、 特高的各项决议 指定横屏和竖屏这两种闪屏图像：
android/screen-hdpi-landscape.png
android/screen-hdpi-portrait.png
@@ -71,7 +75,7 @@ Android 系統指定這兩個面向肖像和風景閃屏圖像為低、 中、
android/screen-xhdpi-portrait.png
-IOS 平臺指定變形為 iPhone 和 iPod 和 iPad，具有變形為視網膜顯示和不同的方向。*568 H*檔是為 iPhone 5 的高螢幕自訂：
+IOS 平台指定变形为 iPhone 和/iPod 和 iPad，具有变形为视网膜显示和不同的方向。*568h* 文件适用于 iPhone 5 的高屏幕：
ios/screen-ipad-landscape-2x.png
ios/screen-ipad-landscape.png
@@ -84,51 +88,82 @@ IOS 平臺指定變形為 iPhone 和 iPod 和 iPad，具有變形為視網膜顯
ios/screen-iphone-portrait-568h-2x.png
-黑莓和 Windows Phone 都指定一個初始螢幕圖像：
+Windows Phone 指定单个初始屏幕图像：
- blackberry/screen-225.png
windows-phone/screen-portrait.jpg
-以下各節詳細說明了如何設置初始螢幕時使用 Sdk 和相關的命令列工具在平臺指南仲介紹。
+以下各节详细说明了如何设置初始屏幕时使用 Sdk 和相关的命令行工具在平台指南中介绍。
-## Android 平臺的初始螢幕
+别忘了在尝试使用 `navigator.splashscreen.hide()` 或 `navigator.splashscreen.show()` 方法之前安装的闪屏插件。
-[9-修補程式的圖像][1]檔放在 Android 專案 `res/drawable` 目錄。為每個大小應為：
+## Android 平台的初始屏幕
+
+在 Android 项目`platforms/android/res/drawable*` 目录中放置[9-patch image][1] 文件。
[1]: https://developer.android.com/tools/help/draw9patch.html
-* xlarge (xhDPI)： 至少 960 × 720
-* 大 (下)： 至少 640 × 480
-* 中期 (mDPI)： 至少 470 × 320
-* 小 (lDPI)： 至少 426 × 320
+为每个大小应为：
+
+* xlarge (xhdpi)： 至少 960 × 720
+* large (hdpi): 至少 640 × 480
+* medium (mdpi): 至少 470 × 320
+* small (ldpi): 至少 426 × 320
+
+如果您想要在Cordova中去使用提供的默认初始屏幕图像，您将要从 `platforms/android/www/res/screen/android` to `platforms/android/res/drawable*/`中去拷贝 png 文件：
+
+ cd platforms/android/res
+ mkdir drawable-port-ldpi
+ cp -p ../assets/www/res/screen/android/screen-ldpi-portrait.png drawable-port-ldpi/screen.png
+ mkdir drawable-land-ldpi
+ cp -p ../assets/www/res/screen/android/screen-ldpi-landscape.png drawable-land-ldpi/screen.png
+ mkdir drawable-port-mdpi
+ cp -p ../assets/www/res/screen/android/screen-mdpi-portrait.png drawable-port-mdpi/screen.png
+ mkdir drawable-land-mdpi
+ cp -p ../assets/www/res/screen/android/screen-mdpi-landscape.png drawable-land-mdpi/screen.png
+ mkdir drawable-port-hdpi
+ cp -p ../assets/www/res/screen/android/screen-hdpi-portrait.png drawable-port-hdpi/screen.png
+ mkdir drawable-land-hdpi
+ cp -p ../assets/www/res/screen/android/screen-hdpi-landscape.png drawable-land-hdpi/screen.png
+ mkdir drawable-port-xhdpi
+ cp -p ../assets/www/res/screen/android/screen-xhdpi-portrait.png drawable-port-xhdpi/screen.png
+ mkdir drawable-land-xhdpi
+ cp -p ../assets/www/res/screen/android/screen-xhdpi-landscape.png drawable-land-xhdpi/screen.png
+
+
+`drawable` 目录名称必须遵循支持[screen sizes][2] and [alternate resources][3]的 Android 约定.
+
+ [2]: http://developer.android.com/guide/practices/screens_support.html
+ [3]: http://developer.android.com/guide/topics/resources/providing-resources.html#AlternativeResources
-在 `config.xml` ，添加下列優惠：
+在 `config.xml`中，添加下列参数：
- <preference name="splashscreen", "splash" />
- <preference name="splashScreenDelay", 10000 />
+ <preference name="SplashScreen" value="splash" />
+ <preference name="SplashScreenDelay" value="10000" />
-第一行設置為初始螢幕顯示的圖像。如果你命名您的圖像什麼除了 `splash.png` ，您需要修改這條線。
+第一行设置为初始屏幕显示的图像。 这是在 `drawable*`目录的 png 的文件名。 如果你命名图像 `splash.png` 之外的任何内容，您需要修改这条行。 不包括文件扩展名 (i.e., `.png`). 如果您想要使用按上面列出的提供Cordova默认初始屏幕，使用值 `screen`.
-第二行設置多久閃屏顯示以毫秒為單位的延遲。 遣散閃屏，一旦接收到 app `deviceready` 事件，調用 `navigator.splashscreen.hide()` 方法。
+第二行设置默认延迟多久闪屏显示以毫秒为单位。这应该是最大的预期的开始时间。SplashScreenDelay 的默认值是 3000 毫秒。
-## IOS 平臺的初始螢幕
+最后，初始屏幕应该是唯一存在的，只要有必要。 当您的应用程序已启动并已加载 web 视图时，您的应用程序应隐藏初始屏幕，以便您的主视图是可见。 因为应用程序开始时间将由多个因素造成差别很大，所以建议您的应用程序显式地调用 `navigator.splashscreen.hide()`，在 `deviceready` 事件作出回应的 Javascript 方法中。 否则，初始屏幕为你上述配置的 SplashScreenDelay 值将是可见的。 这一事件驱动的方法是高度建议与有初始屏幕总是在固定时间可见。
-將您的初始螢幕圖像複製到 iOS 專案 `Resources/splash` 目錄。 僅添加您想要支援的比如 iPad 或者 iPhone 的設備圖像。 每個圖像的大小應為：
+## IOS 平台的初始屏幕
+
+将初始屏幕图像复制到 iOS 项目 `Resources/splash` 目录中。 只添加那些您想要支持的设备的图像，比如 iPad 或者 iPhone 。 每个图像的大小应为：
* Default-568h@2x~iphone.png (640x1136 pixels)
-* Default-Landscape@2x~ipad.png (2048 x 1496 圖元為單位）
+* Default-Landscape@2x~ipad.png (2048 x 1496 像素为单位）
* Default-Landscape~ipad.png (1024x748 pixels)
* Default-Portrait@2x~ipad.png (1536x2008 pixels)
* Default-Portrait~ipad.png (768x1004 pixels)
* Default@2x~iphone.png (640x960 pixels)
* Default~iphone.png (320x480 pixels)
-## 10 黑莓平臺的初始螢幕
+## BlackBerry 10平台的初始屏幕
+
+添加一个 rim： 为每个分辨率和您希望支持的区域设置的初始元素去 config.xml ：
-將您的初始螢幕圖像複製到專案的 `res/screen/blackberry10` 目錄。檔的名稱應該是：
+[http://developer.blackberry.com/html5/documentation/rim\_splash\_element.html][4]
-* splash-1280x768.png (1280x768 pixels)
-* splash-720x720.png (720x720 pixels)
-* splash-768x1280.png (768x1280 pixels)
\ No newline at end of file
+ [4]: http://developer.blackberry.com/html5/documentation/rim_splash_element.html
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/config_ref/index.md b/docs/zh/edge/config_ref/index.md
index 0d7abd3..ff5bf2e 100644
--- a/docs/zh/edge/config_ref/index.md
+++ b/docs/zh/edge/config_ref/index.md
@@ -14,25 +14,37 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# Config.xml 檔
+# Config.xml 文件
-與全域設定檔，可以控制應用程式的行為的許多方面 `config.xml` ，就是放在頂級 web 資產目錄和應用程式的主頁。 這與平臺無關的 XML 檔案格式基於 W3C 的[打包 Web 應用程式 （視窗小部件）][1]規範，並擴展至指定核心科爾多瓦 API 功能、 外掛程式和平臺特定的設置。
+一个应用程序的行为（特性）的许多方面可以用一个全局配置文件config.xml来控制 该平台无关的XML文件是基于W3C的[打包的Web应用程序（窗口小部件）][1]规范安排的，并扩展到指定的核心Cordova API功能、插件和平台特定的设置。
[1]: http://www.w3.org/TR/widgets/
-為專案創建與科爾多瓦 CLI （描述在命令列介面），可以在頂級找到此檔 `www` 目錄。 使用 CLI 生成的專案將重新生成此內的各個子目錄中的檔版本 `platforms` 。 如果您使用 CLI 來創建一個專案，但您的工作流然後轉向一個 SDK，平臺特定的檔可作為源。
+与Cordova CLI创建的项目（在命令行界面中描述），这个文件可以在顶级的目录中找到。
-本節詳細介紹全球和跨平臺的配置選項。請參見以下各節為平臺特定的選項：
+ app/config.xml
+
+
+请注意之前的版本3.3.1-0.2.0, 该文件存在与`app/www/config.xml`中，并且它在这里仍然支持。
+
+当使用CLI来构建一个项目的时候，这个文件的版本是被动的被复制到不同的 `platforms/`子目录中，例如：
+
+ app/platforms/ios/AppName/config.xml
+ app/platforms/blackberry10/www/config.xml
+ app/platforms/android/res/xml/config.xml
+
+
+本节详细介绍了全局和跨平台的配置选项。为平台特定选项请参阅以下部分：
* iOS 配置
-* Android 系統組態
-* 黑莓手機配置
+* Android 系统配置
+* BlackBerry 10 配置
-除了下面詳述的各種配置選項，您還可以配置每個目標平臺的圖像應用程式的核心的集。有關更多資訊，請參見圖示和啟動畫面。
+除了下面描述的各种配置选项，你还可以为每个目标平台的图像配置一个应用程序的核心集。为更多的信息，请查看图标和启动画面。
## 核心配置元素
-此示例顯示了預設的 `config.xml` 生成的 CLI 的 `create` 命令，所述的命令列介面：
+这个例子显示了CLI的`create` 命令生成的默认 `config.xml`文件，在命令行界面中的描述
<widget id="com.example.hello" version="0.0.1">
<name>HelloWorld</name>
@@ -44,89 +56,78 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
</author>
<content src="index.html" />
<access origin="*" />
- <preference name="Fullscreen" value="true" />
- <preference name="WebViewBounce" value="true" />
</widget>
-<!-- QUERY: is WebViewBounce superseded by DisallowOverscroll? -->
+下面的配置元素出现在顶级的`config.xml`文件中，并在所有支持Cordova平台中支持：
-以下的配置元素出現在頂級 `config.xml` 檔，並在所有受支援的科爾多瓦平臺支援：
+* 该`<widget>` 元素的 `id`属性提供了应用程序的反向域标识符，并`version`在主/次/修补程序符号中表示其完整的版本号。
-* `<widget>`元素的 `id` 屬性提供了應用程式的反向域識別碼和 `version` 主要/次要/修補程式符號表示其完整版本號碼。
+* 该`<name>` 元素指定应用程序的正式名称，因为它出现在设备的主屏幕上和应用存储接口中。。
-* `<name>`元素指定應用程式的正式名稱，因為它出現在設備的主畫面上和在應用程式商店介面內。
+* 该 `<description>`和 `<author>` 元素指定的元数据和联系信息可能出现在应用存储列表内。
-* `<description>`和 `<author>` 的元素指定的中繼資料和聯繫資訊，可能會出現在應用程式商店清單內。
+* 该可选的 `<content>` 元素在顶级的web资源目录中定义了该应用程序的起始页。 默认值是`index.html`，这通常在一个项目的顶级`www` 目录中出现。
-* 可選的 `<content>` 元素在頂級 web 資產目錄中定義應用程式的起始頁。 預設值是 `index.html` ，其中通常出現在一個專案中的頂級 `www` 目錄。
+* `<access>` 元素定义了一组外部域的应用程序被允许与其通信。 如上所示的默认值允许它访问任何服务器。 请查看域名Whitelist Guide 以了解详情。
-* `<access>`元素定義應用程式能夠與進行通信的外部域的集。 如上所示的預設值允許它訪問任何伺服器。 請參閱域白名單指南的詳細資訊。
+* 该`<preference>`标记对`name` / `value`属性设置各种选项。 每个首选项的 `name` 是不区分大小写。 许多参数是指定平台特有的，如列在本页的顶部。 下面章节介绍的详细参数适应于多个平台。
-* `<preference>`標記設置各種選項作為對 `name` / `value` 屬性。 每個首選項的 `name` 是不區分大小寫。 很多優惠是獨有的特定平臺上，如列于此頁的頂部。 以下各節詳細介紹了適用于多個平臺的首選項。
+## 全局参数选择
-## 全球首選項
+以下全局参数选择适用于所有平台：
-以下全球首選項適用于所有平臺：
-
-* `Fullscreen`使您可以隱藏在螢幕頂部的狀態列。預設值是 `false` 。示例：
+* `Fullscreen`允许你在屏幕顶端隐藏状态栏。默认值为`false`。例如：
<preference name="Fullscreen" value="true" />
-* `Orientation`允許您鎖定方向和防止介面旋轉，在回應的方向變化。 可能的值是 `default` ， `landscape` ，或 `portrait` 。 示例：
+* `Orientation`允许您锁定方向，并防止界面从响应变化的方向来旋转。 可能的值是`default`，`landscape`, or `portrait`。 例如：
<preference name="Orientation" value="landscape" />
- **注：**`default`值是指*兩個*橫向或縱向方向被啟用。 如果您想要使用的每個平臺的預設設置 （通常縱向只），離開此標記出來的 `config.xml` 檔。 此外，黑莓手機使用 `auto` 而不是 `default` 在其 `config.xml` 檔。 如果您指定 `default` 在全球 `config.xml` ，它會轉換為 `auto` 黑莓的生成中。
+ **NOTE**: 该 `default`的值是指*both*横向和纵向方位被启用。 如果你想使用每个平台的默认设置（通常仅仅是纵向），离开此标记出来的 `config.xml` 文件。
-## 多平臺首選項
+## 多平台参数选择
-下面的首選項應用到多個平臺，但不是所有人都：
+下面的参数选择适用于多个平台，但不是所有的平台：
-* `DisallowOverscroll`(boolean 類型的值，預設值為 `false` ）： 設置為 `true` 如果你不想要當使用者滾動過去的開頭或結尾的內容時顯示的任何回饋資訊的介面。
+* `DisallowOverscroll`(boolean 类型的值，默认值为 `false` )：如果你不想要当用户滚动过去的开头或结尾的内容时显示的任何反馈信息的接口，那就设置为`true`。
<preference name="DisallowOverscroll" value="true"/>
- 適用于 Android 和 iOS。 在 iOS，overscroll 手勢事業內容反彈到其原始位置。 在 android 系統，它們產生一個更微妙的光暈效果沿的頂部或底部邊緣的內容。
+ 适用于 Android 和 iOS。 在iOS上，overscroll动作导致内容回升到原来的位置。 在Android系统上，他们沿顶部或底部边缘的内容产生一个微妙的发光效果。
-* `BackgroundColor`： 設置應用程式的背景色。 支援四個位元組的十六進位值，與第一個位元組代表一個 Alpha 色板、 和標準的 RGB 值為以下三個位元組。 此示例指定藍色：
+* `BackgroundColor`： 设置应用程序的背景颜色。 支持四个字节的十六进制值，与第一个字节代表一个 alpha 通道、 和标准的 RGB 值为以下三个字节。 此例子指定为蓝色：
<preference name="BackgroundColor" value="0xff0000ff"/>
- 適用于 Android 和黑莓手機。覆蓋 CSS 否則為可跨*所有*平臺，例如：`body{background-color:blue}`.
+ 适用于Android and BlackBerry，覆盖CSS否则可用在 *all* 平台上，例如：`body{background-color:blue}`.
-* `HideKeyboardFormAccessoryBar`(boolean 類型的值，預設值為 `false` ）： 設置為 `true` ，隱藏其他工具列出現在鍵盤上方説明使用者導航到另一個表單輸入從。
+* `HideKeyboardFormAccessoryBar`(boolean 类型的值，默认值为 `false` )： 设置为`true`，隐藏显示键盘上的附加工具栏，帮助用户从一种形式输入到另外一种形式来导航。
<preference name="HideKeyboardFormAccessoryBar" value="true"/>
- 適用于 iOS 和黑莓手機。
-
- **注：**為黑莓手機，有效的值是 `enable` 或`disable`.
-
-## `<feature>`元素
+ 适用于 iOS 和BlackBerry手机。
-如果你使用 CLI 來構建應用程式，則使用 `plugin` 命令來啟用設備的 Api。 這不會修改的頂級 `config.xml` 檔中，所以 `<feature>` 的元素並不適用于您的工作流。 如果您直接在 SDK 中工作，使用特定平臺 `config.xml` 檔作為源，您使用 `<feature>` 標記，以使設備級 Api 和外部外掛程式。 它們通常出現在此表單中：
-
- <feature name="Plugin" value="PluginID" />
-
+## The *feature*元素
-他們經常出現在特定于平臺的自訂值以 `config.xml` 檔。例如，在這裡是如何指定為 Android 專案設備 API：
+如果您使用CLI来构建应用程序，您可以使用该`plugin`命令来启动设备的APIs。 不修改顶级的`config.xml`文件，所以该`<feature>`元素不适用于您的工作流程。 如果您的工作直接在SDK中并使用特定平台的`config.xml`文件作为起源的话，您使用该 `<feature>`标签来启用设备级的APIs和外部插件。 他们经常出现在特定平台 `config.xml`文件的自定义值中。 例如，这里是如何为Android项目指定设备的API：
<feature name="Device">
<param name="android-package" value="org.apache.cordova.device.Device" />
</feature>
-下面是該元素為 iOS 專案的顯示方式：
+下面是如何为iOS项目出现的元素：
<feature name="Device">
<param name="ios-package" value="CDVDevice" />
</feature>
-有關如何指定每個功能，請參閱 API 參考的詳細資訊。在外掛程式上看到外掛程式開發指南的詳細資訊。
\ No newline at end of file
+有关如何指定每个功能的详细信息，请参阅API参考。为插件的更多信息请参考插件开发指南。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.backbutton.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.backbutton.md b/docs/zh/edge/cordova/events/events.backbutton.md
index 6143bba..8493652 100644
--- a/docs/zh/edge/cordova/events/events.backbutton.md
+++ b/docs/zh/edge/cordova/events/events.backbutton.md
@@ -16,22 +16,23 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# backbutton
-在使用者按後退按鈕時，將觸發該事件。
+在用户点击back按钮时，将触发该事件。
document.addEventListener("backbutton", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-要重寫後退按鈕的預設行為，註冊為事件攔截器 `backbutton` 事件，通常通過調用 `document.addEventListener` 一旦您收到 `deviceready` 事件。 不再需要調用任何其他方法重寫的後退按鈕的行為。
+要重写后退按钮的默认行为，注册为事件侦听器 `backbutton` 事件，一旦您收到 `deviceready` 事件 通常通过调用 `document.addEventListener` 。 不再需要调用任何其他方法重写的后退按钮的行为。
-## 支援的平臺
+## 支持的平台
-* Android 系統
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 亚马逊火 OS
+* Android 系统
+* 黑莓 10
* Windows Phone 7 和 8
-## 快速的示例
+## 简单的例子
document.addEventListener("backbutton", onBackKeyDown, false);
@@ -40,7 +41,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE html>
<html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.deviceready.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.deviceready.md b/docs/zh/edge/cordova/events/events.deviceready.md
index 8feaf99..a2316ef 100644
--- a/docs/zh/edge/cordova/events/events.deviceready.md
+++ b/docs/zh/edge/cordova/events/events.deviceready.md
@@ -16,31 +16,32 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# deviceready
-科爾多瓦是在完全載入時，將觸發該事件。
+当Cordova是在完全加载时，将触发该事件。
document.addEventListener("deviceready", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-此事件的任何應用程式至關重要。它發出信號科爾多瓦的設備已載入的 Api，並準備訪問。
+此事件的任何应用程序至关重要。它标志着Cordova设备的APIs已被加载，并准备访问。
-科爾多瓦組成的兩個代碼庫： 本機和 JavaScript。 雖然本機代碼載入、 顯示的自訂載入圖像。 然而，JavaScript 僅載入一旦 DOM 裝載。 這意味著您的 web 應用程式可能有可能調用的科爾多瓦 JavaScript 函數之前的相應的本機代碼是可用。
+Cordova组成的两个代码库： 本机和 JavaScript。 虽然本机代码加载、 显示的自定义加载图像。 然而，一旦 DOM 装载JavaScript 仅加载。 这意味着 相应的本机代码变得可用之前，web 应用程序 有可能潜在的调用Cordova JavaScript 函数。
-`deviceready`科爾多瓦已完全載入後會觸發事件。 一次事件火，你可以安全地使對科爾多瓦 Api 的調用。 應用程式通常將附加一個事件攔截器與 `document.addEventListener` 一旦 HTML 文檔的 DOM 已載入。
+一旦Cordova已完全加载后，会触发`deviceready`事件。 一旦触发该事件，你可以安全的调用Cordova APIs。 一旦 HTML 文档的 DOM 已经被加载，应用程序将通常`document.addEventListener` 附加一个事件侦听器。
-`deviceready`事件從其他人的行為方式略有不同。註冊後的任何事件處理 `deviceready` 事件將觸發了其立即調用的回呼函數。
+`deviceready`事件的行为方式略有不同其它方式。注册后的任何事件处理，在`deviceready` 事件触发后 将立即调用回调函数。
-## 支援的平臺
+## 支持的平台
-* Android 系統
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 亚马逊火 OS
+* Android 系统
+* BlackBerry 10
* iOS
* Tizen
* Windows Phone 7 和 8
* Windows 8
-## 快速的示例
+## 简单的例子
document.addEventListener("deviceready", onDeviceReady, false);
@@ -49,7 +50,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE html>
<html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.endcallbutton.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.endcallbutton.md b/docs/zh/edge/cordova/events/events.endcallbutton.md
index 18e54f1..27c5af8 100644
--- a/docs/zh/edge/cordova/events/events.endcallbutton.md
+++ b/docs/zh/edge/cordova/events/events.endcallbutton.md
@@ -16,22 +16,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# endcallbutton
-當使用者按下結束通話按鈕時，將激發此事件。
+当用户按下结束通话按钮时，将激发此事件。
document.addEventListener("endcallbutton", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-該事件將重寫預設結束調用行為。
+该事件将重写默认结束调用行为。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+一旦`deviceready` 事件触发了，应用程序通常应该使用 `document.addEventListener`附加一个事件侦听器。
-## 支援的平臺
+## 支持的平台
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 黑莓 10
-## 快速的示例
+## 简单的例子
document.addEventListener("endcallbutton", onEndCallKeyDown, false);
@@ -40,7 +40,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.md b/docs/zh/edge/cordova/events/events.md
index fb1e76d..d571f1a 100644
--- a/docs/zh/edge/cordova/events/events.md
+++ b/docs/zh/edge/cordova/events/events.md
@@ -16,19 +16,14 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# 事件
-> 科爾多瓦生命週期事件。
+> Cordova生命周期事件。
-## 事件種類
+## 事件类型
* deviceready
-* 暫停
-* 簡歷
-* 線上
-* 離線
+* 暂停
+* 简历
* backbutton
-* batterycritical
-* batterylow
-* batterystatus
* menubutton
* searchbutton
* startcallbutton
@@ -36,56 +31,17 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
* volumedownbutton
* volumeupbutton
-## 訪問功能
-
-版本為 3.0，科爾多瓦實現電池狀態和其他設備級 Api 作為*外掛程式*。 預設情況下啟用對所有其他不相關的電池狀態的事件的訪問。 使用 CLI 的 `plugin` 命令，描述在命令列介面，可以啟用或禁用電池事件：
-
- $ cordova plugin add org.apache.cordova.battery-status
- $ cordova plugin ls
- [ 'org.apache.cordova.battery-status' ]
- $ cordova plugin rm org.apache.cordova.battery-status
-
-
-這些命令適用于所有有針對性的平臺，但修改如下所述的特定于平臺的配置設置：
-
-* Android 系統
-
- (in app/res/xml/config.xml)
- <feature name="Battery">
- <param name="android-package" value="org.apache.cordova.BatteryListener" />
- </feature>
-
- (in app/AndroidManifest.xml)
- <uses-permission android:name="android.permission.BROADCAST_STICKY" />
-
+## 由 [org.apache.cordova.battery-status][1] 添加事件
-* 黑莓手機 WebWorks
-
- (in www/plugins.xml)
- <feature name="Battery">
- <param name="blackberry-package" value="org.apache.cordova.battery.Battery" />
- </feature>
-
- (in www/config.xml)
- <feature id="blackberry.app" required="true" version="1.0.0.0" />
- <feature id="blackberry.app.event" required="true" version="1.0.0.0" />
- <feature id="blackberry.system.event" required="true" version="1.0.0.0" />
-
+ [1]: https://github.com/apache/cordova-plugin-battery-status/blob/master/doc/index.md
-* （在 iOS`config.xml`)
-
- <feature name="Battery">
- <param name="ios-package" value="CDVBattery" />
- </feature>
-
+* batterycritical
+* batterylow
+* batterystatus
-* （在 Tizen`config.xml`)
-
- <feature name="http://tizen.org/api/systeminfo" required="true"/>
-
-
- 引用： [Tizen Web 應用程式的應用程式清單][1]
+## 由 [org.apache.cordova.network-information][2] 添加事件
- [1]: https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures
+ [2]: https://github.com/apache/cordova-plugin-network-information/blob/master/doc/index.md
-一些平臺可能支援此功能，而無需任何特殊的配置。請參見在概述部分中*的平臺支援*。
\ No newline at end of file
+* online
+* offline
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.menubutton.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.menubutton.md b/docs/zh/edge/cordova/events/events.menubutton.md
index 6b09e04..9cf0438 100644
--- a/docs/zh/edge/cordova/events/events.menubutton.md
+++ b/docs/zh/edge/cordova/events/events.menubutton.md
@@ -16,23 +16,24 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# menubutton
-在使用者按功能表按鈕時，將觸發該事件。
+在用户按菜单按钮时，将触发该事件。
document.addEventListener("menubutton", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-事件處理常式的應用覆蓋的預設功能表按鈕行為。
+事件处理程序的应用覆盖默认的菜单按钮的行为。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+一旦`deviceready` 事件触发了，应用程序通常应该使用 `document.addEventListener`附加一个事件侦听器。
-## 支援的平臺
+## 支持的平台
-* Android 系統
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 亚马逊火 OS
+* Android 系统
+* 黑莓 10
-## 快速的示例
+## 简单的例子
document.addEventListener("menubutton", onMenuKeyDown, false);
@@ -41,7 +42,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.pause.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.pause.md b/docs/zh/edge/cordova/events/events.pause.md
index 5469316..6f8cb21 100644
--- a/docs/zh/edge/cordova/events/events.pause.md
+++ b/docs/zh/edge/cordova/events/events.pause.md
@@ -14,28 +14,29 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# 暫停
+# 暂停
-當一個應用程式放入後臺，將觸發該事件。
+当一个应用程序被放入后台时，将触发该事件。
document.addEventListener("pause", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-`pause`當本機平臺放入背景，應用程式通常在使用者切換到不同的應用程式時激發的事件。
+当本机平台放入应用程序去后台，通常在用户切换到不同的应用程序时触发该`pause`事件。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+一旦`deviceready` 事件触发了，应用程序通常应该使用 `document.addEventListener`附加一个事件侦听器。
-## 支援的平臺
+## 支持的平台
-* Android 系統
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 亚马逊火 OS
+* Android 系统
+* 黑莓 10
* iOS
* Windows Phone 7 和 8
* Windows 8
-## 快速的示例
+## 简单的例子
document.addEventListener("pause", onPause, false);
@@ -44,7 +45,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE html>
<html>
@@ -78,10 +79,10 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
</html>
-## iOS 的怪癖
+## iOS 的怪异
-在 `pause` 處理常式中，任何調用到科爾多瓦 API 或穿過目標 C 的本機外掛程式不工作，以及任何互動式調用，如警報或 `console.log()` 。 當應用程式恢復後，在下一次運行迴圈上他們，只處理。
+在 `pause` 处理程序中，任何调用到Cordova API 或本地插件经历的Objective-C不工作，以及任何交互式调用的插件，如警报或 `console.log()` 。 当应用程序恢复后，他们只处理在下一次运行循环上。
-特定于 iOS `resign` 事件是可用作為替代 `pause` ，並檢測時的使用者啟用**鎖定**按鈕鎖定設備與應用程式在前臺運行。 如果為多工啟用的應用程式 （和設備），則這配對與其後 `pause` 事件，但只在 iOS 5 下的。 實際上，所有鎖定應用程式已啟用多工的 iOS 5 中被推到背景中。 對於應用程式繼續運行在 iOS 5 下鎖定時，禁用應用程式的多工處理通過將[UIApplicationExitsOnSuspend][1]設置為 `YES` 。 若要運行在 iOS 4 上鎖定狀態時，此設置並不重要。
+特定于 iOS `resign` 事件是可作为替代 `pause` ，并检测当用户启用**Lock**按钮锁定设备与应用程序在前台运行。 如果应用程序 （和设备）为多任务启用时，这将与其后 的`pause` 事件配对，但只在 iOS 5 下。 实际上，在iOS 5 上，所有锁定应用程序已启用的多任务都被放置到后台。 对于应用程序在 iOS 5 下锁定时将继续运行，通过设置[UIApplicationExitsOnSuspend][1]为 `YES`来禁用应用程序的多任务处理 。 若要运行在 iOS 4 上锁定状态时，此设置并不重要。
[1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.resume.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.resume.md b/docs/zh/edge/cordova/events/events.resume.md
index 2728656..58af8bd 100644
--- a/docs/zh/edge/cordova/events/events.resume.md
+++ b/docs/zh/edge/cordova/events/events.resume.md
@@ -14,23 +14,24 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# 簡歷
+# 简历
-當應用程式從背景中檢索時，將觸發該事件。
+当应用程序从背景中检索时，将触发该事件。
document.addEventListener("resume", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-`resume`事件觸發時的本機平臺拔出從背景的應用程式。
+`resume`事件触发时的本机平台拔出从背景的应用程序。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+应用程序通常应使用 `document.addEventListener` 将一个事件侦听器附加一次 `deviceready` 事件火灾。
-## 支援的平臺
+## 支持的平台
-* Android 系統
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 亚马逊火 OS
+* Android 系统
+* 黑莓 10
* iOS
* Windows Phone 7 和 8
* Windows 8
@@ -80,15 +81,15 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
## iOS 的怪癖
-從調用任何互動式函數 `pause` 事件處理常式以後執行應用程式恢復時，由發出信號 `resume` 事件。 這些包括警報， `console.log()` ，和任何調用從外掛程式或 API，科爾多瓦，穿過目標 C.
+从调用任何交互式函数 `pause` 事件处理程序以后执行应用程序恢复时，由发出信号 `resume` 事件。 这些包括警报， `console.log()` ，和任何调用从插件或 API，科尔多瓦，穿过目标 C.
-* **活動**事件
+* **活动**事件
- 特定于 iOS `active` 事件是可用作為替代 `resume` ，並檢測時使用者禁用**鎖定**按鈕以解鎖設備與應用程式在前臺運行。 如果為多工啟用的應用程式 （和設備），則這配對與其後 `resume` 事件，但只在 iOS 5 下的。 實際上，所有鎖定應用程式已啟用多工的 iOS 5 中被推到背景中。 對於應用程式繼續運行在 iOS 5 下鎖定時，禁用應用程式的多工處理通過將[UIApplicationExitsOnSuspend][1]設置為 `YES` 。 若要運行在 iOS 4 上鎖定狀態時，此設置並不重要。
+ 特定于 iOS `active` 事件是可用作为替代 `resume` ，并检测时用户禁用**锁定**按钮以解锁设备与应用程序在前台运行。 如果为多任务启用的应用程序 （和设备），则这配对与其后 `resume` 事件，但只在 iOS 5 下的。 实际上，所有锁定应用程序已启用多任务的 iOS 5 中被推到背景中。 对于应用程序继续运行在 iOS 5 下锁定时，禁用应用程序的多任务处理通过将[UIApplicationExitsOnSuspend][1]设置为 `YES` 。 若要运行在 iOS 4 上锁定状态时，此设置并不重要。
-* **恢復**事件
+* **恢复**事件
- 當從調用 `resume` 事件處理常式，如互動式功能 `alert()` 需要包裝在 `setTimeout()` 調用超時值為零，否則應用程式掛起。 例如：
+ 当从调用 `resume` 事件处理程序，如交互式功能 `alert()` 需要包装在 `setTimeout()` 调用超时值为零，否则应用程序挂起。 例如：
document.addEventListener("resume", onResume, false);
function onResume() {
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.searchbutton.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.searchbutton.md b/docs/zh/edge/cordova/events/events.searchbutton.md
index 5497785..2a6a6db 100644
--- a/docs/zh/edge/cordova/events/events.searchbutton.md
+++ b/docs/zh/edge/cordova/events/events.searchbutton.md
@@ -16,22 +16,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# searchbutton
-當使用者按 Android 上的搜尋按鈕時，將觸發該事件。
+当用户在Android 上点击搜索按钮时，将触发该事件。
document.addEventListener("searchbutton", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-如果您需要重寫預設的搜尋按鈕行為在 android 系統上您可以註冊為 'searchbutton' 事件一個事件攔截器。
+如果您在 android 系统上需要重写默认的搜索按钮特性，您可以为 'searchbutton' 事件注册一个事件侦听器。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+一旦`deviceready` 事件触发了，应用程序通常应该使用 `document.addEventListener`附加一个事件侦听器。
-## 支援的平臺
+## 支持的平台
-* Android 系統
+* Android
-## 快速的示例
+## 简单的例子
document.addEventListener("searchbutton", onSearchKeyDown, false);
@@ -40,7 +40,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.startcallbutton.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.startcallbutton.md b/docs/zh/edge/cordova/events/events.startcallbutton.md
index 30093da..6eccaae 100644
--- a/docs/zh/edge/cordova/events/events.startcallbutton.md
+++ b/docs/zh/edge/cordova/events/events.startcallbutton.md
@@ -16,22 +16,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# startcallbutton
-當使用者按下開始呼叫按鈕時，將觸發該事件。
+当用户按下开始呼叫按钮时，将触发该事件。
document.addEventListener("startcallbutton", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-如果您需要重寫預設開始調用行為您可以註冊為事件攔截器 `startcallbutton` 事件。
+如果您需要重写默认开始调用特性，您可以为`startcallbutton` 事件注册一个事件侦听器 。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+一旦`deviceready` 事件触发了，应用程序通常应该使用 `document.addEventListener`附加一个事件侦听器。
-## 支援的平臺
+## 支持的平台
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 黑莓 10
-## 快速的示例
+## 简单的例子
document.addEventListener("startcallbutton", onStartCallKeyDown, false);
@@ -40,7 +40,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.volumedownbutton.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.volumedownbutton.md b/docs/zh/edge/cordova/events/events.volumedownbutton.md
index 313b3db..cfd2347 100644
--- a/docs/zh/edge/cordova/events/events.volumedownbutton.md
+++ b/docs/zh/edge/cordova/events/events.volumedownbutton.md
@@ -16,22 +16,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# volumedownbutton
-在使用者按下按鈕卷時，將觸發該事件。
+在用户按下缩小音量键时，将触发该事件。
document.addEventListener("volumedownbutton", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-如果您需要重寫預設音量降低的行為你可以註冊為事件攔截器 `volumedownbutton` 事件。
+如果您需要重写默认音量降低特性的时候，你可以为`volumedownbutton` 事件注册一个事件侦听器 。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+一旦`deviceready` 事件触发了，应用程序通常应该使用 `document.addEventListener`附加一个事件侦听器。
-## 支援的平臺
+## 支持的平台
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 黑莓 10
-## 快速的示例
+## 简单的例子
document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
@@ -40,7 +40,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/events/events.volumeupbutton.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/events/events.volumeupbutton.md b/docs/zh/edge/cordova/events/events.volumeupbutton.md
index e05c2cd..5208276 100644
--- a/docs/zh/edge/cordova/events/events.volumeupbutton.md
+++ b/docs/zh/edge/cordova/events/events.volumeupbutton.md
@@ -16,22 +16,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# volumeupbutton
-當使用者按下了按鈕卷時，將觸發該事件。
+当用户按下放大音量键时，将触发该事件。
document.addEventListener("volumeupbutton", yourCallbackFunction, false);
-## 詳細資訊
+## 详细信息
-如果您需要重寫預設卷起來的行為你可以註冊為事件攔截器 `volumeupbutton` 事件。
+如果您需要重写默认音量放大的特性时，你可以为 `volumeupbutton` 事件注册一个侦听器。
-應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `deviceready` 事件火災。
+一旦`deviceready` 事件触发了，应用程序通常应该使用 `document.addEventListener`附加一个事件侦听器。
-## 支援的平臺
+## 支持的平台
-* 黑莓手機 WebWorks （OS 5.0 和更高）
+* 黑莓 10
-## 快速的示例
+## 简单的例子
document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
@@ -40,7 +40,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
}
-## 完整的示例
+## 完整的例子
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/plugins/pluginapis.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/plugins/pluginapis.md b/docs/zh/edge/cordova/plugins/pluginapis.md
new file mode 100644
index 0000000..21ae9f3
--- /dev/null
+++ b/docs/zh/edge/cordova/plugins/pluginapis.md
@@ -0,0 +1,108 @@
+---
+
+许可证： 在下一个或更多的贡献许可协议 授权给Apache软件基金会（ASF）。 请参阅文件分布与这项工作有关的著作权归属的附加信息的通知文件。 ASF的许可证文件到你的Apache许可证下，版本2.0（"License"）；你不可能使用此文件，除了符合许可证之外。 您可能会获得在许可证的副本
+
+ http://www.apache.org/licenses/LICENSE-2.0
+ 除非适用的法律要求或书面同意，否则按照该许可证分发的软件分发上"AS IS"的基础，WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, 明示或暗示。 请参阅许可证规定的权限和限制的特定语言
+
+
+## 根据许可证。
+
+# 插件的 APIs
+
+Cordova全员最小的一组APIs，和项目添加额外的APIs，它们需要通过插件。
+
+您可以通过使用 [Plugin Registry][1] 的所有现有的插件来搜索。.
+
+ [1]: http://plugins.cordova.io/
+
+传统的Cordova插件集如下所示：
+
+* [电池状态][2]
+
+ > 监视设备的电池的状态。
+
+* [相机][3]
+
+ > 捕获照片使用的设备的相机。
+
+* [联系人][4]
+
+ > 与设备联系人数据库的工作。
+
+* [设备][5]
+
+ > 收集设备特定信息。
+
+* [设备运动 (加速度计)][6]
+
+ > 进入设备的运动传感器。
+
+* [设备定位 (指南针)][7]
+
+ > 获取该设备的指向的方向。
+
+* [会话][8]
+
+ > 视觉设备通知。
+
+* [文件系统][9]
+
+ > 通过 JavaScript挂接到本机文件系统。
+
+* [文件传输][10]
+
+ > 通过 JavaScript挂接到本机文件系统。
+
+* [地理定位][11]
+
+ > 意识到您的应用程序的本地位置。
+
+* [全球化][12]
+
+ > 启用特定于区域设置的对象表示的形式。
+
+* [InAppBrowser][13]
+
+ > 启动另一个应用程序中的浏览器实例的 Url。
+
+* [媒体][14]
+
+ > 录制和播放音频文件。
+
+* [媒体捕获][15]
+
+ > 使用设备的媒体捕获应用程序来捕获媒体文件。
+
+* [网络信息 (连接)][16]
+
+ > 快速检查网络状态和蜂窝网络的信息。
+
+* [闪屏][17]
+
+ > 显示和隐藏应用程序的初始屏幕。
+
+* [振动][18]
+
+ > 振动设备的 API。
+
+ [2]: https://github.com/apache/cordova-plugin-battery-status/blob/dev/doc/index.md
+ [3]: https://github.com/apache/cordova-plugin-camera/blob/dev/doc/index.md
+ [4]: https://github.com/apache/cordova-plugin-contacts/blob/dev/doc/index.md
+ [5]: https://github.com/apache/cordova-plugin-device/blob/dev/doc/index.md
+ [6]: https://github.com/apache/cordova-plugin-device-motion/blob/dev/doc/index.md
+ [7]: https://github.com/apache/cordova-plugin-device-orientation/blob/dev/doc/index.md
+ [8]: https://github.com/apache/cordova-plugin-dialogs/blob/dev/doc/index.md
+ [9]: https://github.com/apache/cordova-plugin-file/blob/dev/doc/index.md
+ [10]: https://github.com/apache/cordova-plugin-file-transfer/blob/dev/doc/index.md
+ [11]: https://github.com/apache/cordova-plugin-geolocation/blob/dev/doc/index.md
+ [12]: https://github.com/apache/cordova-plugin-globalization/blob/dev/doc/index.md
+ [13]: https://github.com/apache/cordova-plugin-inappbrowser/blob/dev/doc/index.md
+ [14]: https://github.com/apache/cordova-plugin-media/blob/dev/doc/index.md
+ [15]: https://github.com/apache/cordova-plugin-media-capture/blob/dev/doc/index.md
+ [16]: https://github.com/apache/cordova-plugin-network-information/blob/dev/doc/index.md
+ [17]: https://github.com/apache/cordova-plugin-splashscreen/blob/dev/doc/index.md
+ [18]: https://github.com/apache/cordova-plugin-vibration/blob/dev/doc/index.md
+
+为这些插件文档的非英语翻译可以在Cordova文档的旧版本找到。使用顶部右上角的这个站点的下拉式菜单来切换版本。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/cordova/storage/storage.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/storage/storage.md b/docs/zh/edge/cordova/storage/storage.md
index 32e01f2..e90d183 100644
--- a/docs/zh/edge/cordova/storage/storage.md
+++ b/docs/zh/edge/cordova/storage/storage.md
@@ -14,54 +14,49 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# 存儲
+# 存储
-> 提供對設備的存儲選項的訪問。
+> 对Cordova存储选项的概述。
-此 API 提供了基於兩個不同的 W3C 規範的存儲選項：
+几个存储APIs 是用于Cordova的应用程序。请参阅[html5rocks][1]。为更全面地概述和示例。
-* [Web 存儲 API 規範][1]允許您要訪問的資料通過簡單的鍵/值對。 上認為在此介面上的完整詳細資訊，請參閱節。
+ [1]: http://www.html5rocks.com/en/features/storage
-* [Web SQL 資料庫規範][2]提供更多的功能全面的資料庫表訪問通過 SQL 查詢。 此介面的摘要將立即出現下面。
+## LocalStorage
- [1]: http://dev.w3.org/html5/webstorage/
- [2]: http://dev.w3.org/html5/webdatabase/
+此 API 也被称为*web storage*、*simple storage*，或由其备用*session storage*接口，这个API提供同步键/值对存储，并且是可用的在底层的 WebView中实现。 请参阅[W3C spec][2]的详细信息。
-科爾多瓦提供兩個介面都對少數已經不支援他們的設備的訪問。否則內置實現應用。
+ [2]: http://www.w3.org/TR/webstorage/
-## 方法
+**Windows Phone 7 Quirk**： 点符号是*not*提供的，所以一定要使用 `setItem` 或 `getItem` ，而不是直接从存储对象访问键，如`window.localStorage.someKey`.
-* 大概
+## WebSQL
-## 參數
+此 API 是在底层WebView中可用。 [Web SQL Database Specification][3]提供了通过 SQL 查询访问的更多的功能全面的数据库表。
-* database_name
-* database_version
-* database_displayname
-* database_size
+ [3]: http://dev.w3.org/html5/webdatabase/
-## 物件
+在以下平台支持 WebSQL：
-* 資料庫
-* SQLTransaction
-* SQLResultSet
-* SQLResultSetRowList
-* SQLError
+* Android
+* BlackBerry 10
+* iOS
+* Tizen
-## 訪問功能
+## IndexedDB
-版本為 3.0，對存儲 Api 的訪問內置於科爾多瓦，，不需要使用 CLI 要添加的外掛程式，如所述的命令列介面。
+此 API 是在底层WebView中可用的。[Indexed DB][4]提供比LocalStorage更多但比 WebSQL 较少的功能。
-如果您使用較舊的前面，CLI 的科爾多瓦工具集，，仍然需要以下的平臺特定的配置設置：
+ [4]: http://www.w3.org/TR/IndexedDB/
-* （在 android`app/res/xml/config.xml`)
-
- < 功能名稱 ="存儲">< 參數名稱 ="android 包"value="org.apache.cordova.Storage"/ >< / 功能 >
-
+以下平台支持 IndexedDB：
-* 黑莓手機 WebWorks （中`www/config.xml`)
-
- < 功能 id="blackberry.widgetcache"所需 ="true"版本 ="1.0.0.0"/ >
-
+* Windows Phone 8
+* BlackBerry 10
+
+## Plugin-Based 选项
+
+除了上面列出的 APIs 的存储，[File API][5]允许您在本地文件系统上缓存数据。 其他的[Cordova plugins][6]提供类似的存储选项。
-一些平臺可能支援此功能，而無需任何特殊的配置。請參見在概述部分中*的平臺支援*。
\ No newline at end of file
+ [5]: https://github.com/apache/cordova-plugin-file/blob/master/doc/index.md
+ [6]: http://plugins.cordova.io/
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/guide/appdev/privacy/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/appdev/privacy/index.md b/docs/zh/edge/guide/appdev/privacy/index.md
index af0bfda..6cfd4aa 100644
--- a/docs/zh/edge/guide/appdev/privacy/index.md
+++ b/docs/zh/edge/guide/appdev/privacy/index.md
@@ -14,38 +14,38 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# 隱私指南
+# 隐私指南
-手機隱私是每個應用程式開發者必須解決的關鍵問題。 您的使用者期望將搜集他們的私人資訊，並由您的應用程式得到適當的處理。此外，有越來越多的現在有關于手機隱私慣例的法律要求司法管轄區。
+手机隐私是每个应用程序开发者必须解决的关键问题。 您的用户期望将搜集他们的私人信息，并由您的应用程序得到适当的处理。此外，有越来越多的现在有关于手机隐私惯例的法律要求司法管辖区。
-本指南中的移動應用程式的隱私應被視為一*底漆*處理一些最重要的問題。 它概述了人們廣泛接受的一些最佳做法，並提供到其他更詳細的指南和參考參考。
+本指南中的移动应用程序的隐私应被视为一*底漆*处理一些最重要的问题。 它概述了人们广泛接受的一些最佳做法，并提供到其他更详细的指南和参考参考。
-* **私隱政策**： 您的應用程式應包括私隱政策，解決什麼樣的資訊您的應用程式收集來自或關於您的使用者、 如何使用這些資訊，與誰它共用的和如何使用者可以在應用程式內私隱有關的選擇等主題。以説明理解，你應該使用普通語言和避免技術術語。 你應該使您的隱私權原則可供使用者之前下載，如審查的 app 描述中的應用市場。 此外，應使您的隱私權原則可用在該應用程式本身的範圍內。 有限的行動裝置的顯示大小創建用於向使用者顯示私隱政策的挑戰。 考慮發展一種*縮寫形式*的政策，其中包括最重要的資訊，，然後在更多的細節感興趣的人提供一個連結到"長表"政策。 幾個小組正試圖開發基於圖示通信隱私慣例，你可能想要考慮一旦這些標準成熟的標準。
+* **私隐政策**： 您的应用程序应包括私隐政策，解决什么样的信息您的应用程序收集来自或关于您的用户、 如何使用这些信息，与谁它共享的和如何用户可以在应用程序内私隐有关的选择等主题。以帮助理解，你应该使用普通语言和避免技术术语。 你应该使您的隐私策略可供用户之前下载，如审查的 app 描述中的应用市场。 此外，应使您的隐私策略可用在该应用程序本身的范围内。 有限的移动设备的显示大小创建用于向用户显示私隐政策的挑战。 考虑发展一种*缩写形式*的政策，其中包括最重要的信息，，然后在更多的细节感兴趣的人提供一个链接到"长表"政策。 几个小组正试图开发基于图标通信隐私惯例，你可能想要考虑一旦这些标准成熟的标准。
-* **敏感資訊的收集**： 敏感的個人資訊的應用程式的集合將引發重要隱私問題。 敏感的個人資訊的例子包括敏感的財務資訊，健康的資訊，並從或兒童的資訊。 它還包括從某些感應器和通常發現行動裝置和平板電腦、 地理定位資訊、 連絡人/電話簿、 麥克風/相機和存儲的圖片視頻等的資料庫收集的資訊。 請參見以下文檔頁的詳細資訊：[相機][1]、[捕獲][2]、[連絡人][3]和[地理定位][4]。 一般情況下，您應該獲得使用者的明確許可之前收集敏感資訊，如果可能的話，提供一種控制機制，使使用者可以輕鬆地更改許可權。 應用程式的作業系統可以説明在某些情況下提出只是時間的對話方塊，要求使用者的許可權前集合。 在這些情況下，一定要利用任何機會，若要自訂對話方塊的框文本，以澄清如何應用程式使用，並且，如果適用，將共用此類資
訊。
+* **敏感信息的收集**： 敏感的个人信息的应用程序的集合将引发重要隐私问题。 敏感的个人信息的例子包括敏感的财务信息，健康的信息，并从或儿童的信息。 它还包括从某些传感器和通常发现移动设备和平板电脑、 地理定位信息、 联系人/电话簿、 麦克风/相机和存储的图片视频等的数据库收集的信息。 请参见以下文档页的详细信息：[相机][1]、[捕获][2]、[联系人][3]和[地理定位][4]。 一般情况下，您应该获得用户的明确许可之前收集敏感信息，如果可能的话，提供一种控制机制，使用户可以轻松地更改权限。 应用程序的操作系统可以帮助在某些情况下提出只是时间的对话框，要求用户的权限前集合。 在这些情况下，一定要利用任何机会，若要自定义对话框的框文本，以澄清如何应用程序使用，并且，如果适用，将共享此类信息。
-* **避免使用者驚喜**： 如果您的應用程式收集或使用中可能向使用者根據您的應用程式 （例如，訪問存儲的圖片的音樂播放機） 的主要目的令人驚訝的方式的資訊，你應該帶類似的步驟作為敏感個人資訊的收集。 這就是，你強烈應考慮只是時間對話方塊通知使用者有關集合或該資訊的使用，並提供一個相應的隱私控制項，如果合適的話，的使用。
+* **避免用户惊喜**： 如果您的应用程序收集或使用中可能向用户根据您的应用程序 （例如，访问存储的图片的音乐播放器） 的主要目的令人惊讶的方式的信息，你应该带类似的步骤作为敏感个人信息的收集。 这就是，你强烈应考虑只是时间对话框通知用户有关集合或该信息的使用，并提供一个相应的隐私控件，如果合适的话，的使用。
-* **協力廠商資料收集或分享**： 如果你的應用程式收集到另一家公司 — — 提供的資訊，如一個社交網路平臺或廣告網路 （例如，如果您的應用程式會顯示廣告) — — 你應該告知該集合的使用者和共用。 至少，您的隱私權原則應該描述資訊收集和共用和，如果合適的話，為您的使用者提供控制能力或退出這種集合或共用。
+* **第三方数据收集或分享**： 如果你的应用程序收集到另一家公司 — — 提供的信息，如一个社交网络平台或广告网络 （例如，如果您的应用程序会显示广告) — — 你应该告知该集合的用户和共享。 至少，您的隐私策略应该描述信息收集和共享和，如果合适的话，为您的用户提供控制能力或退出这种集合或共享。
-* **集合限制和安全**： 您的使用者委託他們的資訊與您的應用程式，他們期望你將會採取適當的安全防範措施來保護它。 避免個人資訊的安全妥協的最佳方法之一併不是在第一次的地方收集的資訊，除非您的應用程式具有集合的一個具體和合法的商業原因。 不會需要收集的資訊，確保你提供適當的安全控制，以保護該資訊，無論它存儲在設備上或在您的後端伺服器上。 您還應開發這款應用和後端伺服器上實施適當的資料保留原則。
+* **集合限制和安全**： 您的用户委托他们的信息与您的应用程序，他们期望你将会采取适当的安全防范措施来保护它。 避免个人信息的安全妥协的最佳方法之一并不是在第一次的地方收集的信息，除非您的应用程序具有集合的一个具体和合法的商业原因。 不会需要收集的信息，确保你提供适当的安全控制，以保护该信息，无论它存储在设备上或在您的后端服务器上。 您还应开发这款应用和后端服务器上实施适当的数据保留策略。
[1]: cordova_camera_camera.md.html
[2]: cordova_media_capture_capture.md.html
[3]: cordova_contacts_contacts.md.html
[4]: cordova_geolocation_geolocation.md.html
-以下是一些其他有用手機隱私指南，開發人員：
+以下是一些其他有用手机隐私指南，开发人员：
-* 加州總檢察長[私隱去： 移動生態系統的建議][5]
+* 加州总检察长[私隐去： 移动生态系统的建议][5]
-* 民主與技術，隱私論壇，[為手機應用程式開發人員的最佳做法][6]的未來中心
+* 民主与技术，隐私论坛，[为手机应用程序开发人员的最佳做法][6]的未来中心
-* CTIA 無線協會、[最佳做法和準則的位置基於服務][7]
+* CTIA 无线协会、[最佳做法和准则的位置基于服务][7]
-* 聯邦貿易委員會，[手機隱私披露： 建立信任通過透明度][8]
+* 联邦贸易委员会，[手机隐私披露： 建立信任通过透明度][8]
-* [應用隱私][9]網站隱私論壇的未來
+* [应用隐私][9]网站隐私论坛的未来
[5]: http://oag.ca.gov/sites/all/files/pdfs/privacy/privacy_on_the_go.pdf
[6]: http://www.futureofprivacy.org/wp-content/uploads/Best-Practices-for-Mobile-App-Developers_Final.pdf
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/909e5fb4/docs/zh/edge/guide/appdev/whitelist/index.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/appdev/whitelist/index.md b/docs/zh/edge/guide/appdev/whitelist/index.md
index 7a78298..4303a1f 100644
--- a/docs/zh/edge/guide/appdev/whitelist/index.md
+++ b/docs/zh/edge/guide/appdev/whitelist/index.md
@@ -14,189 +14,122 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# 白名單指南
+# Whitelist Guide
-## 概述
+域白是一种安全模式，控制访问到您应用程序有没有控制的外部域。 科尔多瓦的默认安全策略允许访问的任何站点。 在移动之前您在生产中的应用，应制订白名单和允许访问特定的网络域和子域。
-資源白的就是安全模型控制訪問外部網路資源，如 `http://google.com` 。 Apache 科爾多瓦預設安全性原則允許訪問 Internet 上的任何網站上的任何資源。 在移動之前您在生產中的應用，應審查其白名單和聲明訪問到特定的網路域和子域。
-
-## 規格
-
-域白為[W3C 構件訪問][1]規範奠定了基礎。 在構件訪問規範中， `<access>` 元素，用來聲明對特定的網路資源的訪問。 Apache 科爾多瓦擴展了此概念允許個別網路資源 (Url) 的白。 在將來，Apache 科爾多瓦將抽象的白平臺實現。 然而，現在每個平臺實現其自己的資源或域的白。 平臺實現之間的差異是在本文檔後面所述。
+科尔多瓦遵循[W3C 构件访问][1]规范，它依赖于 `<access>` 中应用程序的元素 `config.xml` 文件以启用对特定域的网络访问。 对于依赖于所述的命令行界面 CLI 工作流的项目，此文件位于项目的顶级目录。 否则为特定于平台的发展道路，位置列出以下各节。 （每个平台上见各种平台指南的详细信息）。
[1]: http://www.w3.org/TR/widgets-access/
-白名單條目的一般格式如下 Google Chrome 打包企業應用套件的"[模式匹配][2]"規範。 資源指定的 URL，但一個星號 （*） 字元可用作在幾個地方的"萬用字元"表示"任何值可能會在這裡去"。 具體的例子如下所示。
-
- [2]: http://developer.chrome.com/apps/match_patterns.html
-
-## 語法
+下面的示例演示白名单中的语法：
-在[google.com][3]的所有資源的存取權限：
-
- [3]: http://google.com
-
- http://google.com/*
+* [Google.com][2]访问：
+ <access origin="http://google.com" />
+
-訪問所有資源在安全[google.com][4] ( `https://` ):
-
- [4]: https://google.com
-
- HTTPs://google.com/ *
-
-
-對特定的子域[maps.google.com][5]的訪問：
-
- [5]: http://maps.google.com
-
- http://maps.google.com/*
+* 对安全[google.com][3]的访问 ( `https://` ):
+ <access origin="https://google.com" />
+
-訪問[google.com][3] （例如， [mail.google.com][6]和[docs.google.com][7]） 的所有子域：
-
- [6]: http://mail.google.com
- [7]: http://docs.google.com
-
- http://*.google.com/*
+* 子域[maps.google.com][4]访问：
+ <access origin="http://maps.google.com" />
+
-對上[www.google.com][8] "/ 移動"路徑下的所有資源的訪問：
-
- [8]: http://www.google.com
-
- http://www.google.com/mobile/*
+* 对所有子域[google.com][2]，例如[mail.google.com][5]和[docs.google.com][6]的访问：
+ <access origin="http://*.google.com" />
+
-訪問[google.com][3]上任何協定 （如 HTTP、 HTTPS、 FTP 等）：
-
- *://google.com/*
+* 到*所有*的域，例如， [google.com][2]和[developer.mozilla.org][7]的访问：
-
-所有資源 （例如， [google.com][3]和[developer.mozilla.org][9]） 在互聯網上訪問：
-
- [9]: http://developer.mozilla.org
-
- *
+ <access origin="*" />
+
+ 这是新创建的 CLI 项目的默认值。
-## Android 系統
+ [2]: http://google.com
+ [3]: https://google.com
+ [4]: http://maps.google.com
+ [5]: http://mail.google.com
+ [6]: http://docs.google.com
+ [7]: http://developer.mozilla.org
-### 詳細資訊
+## 亚马逊火 OS 白
-在找到白規則 `res/xml/config.xml` ，並宣佈與元素`<access origin="..." />`.
+在找到特定平台白规则`res/xml/config.xml`.
-Android 系統完全支援白語法。
+## Android 白
-### 語法
+在找到特定平台白规则`res/xml/config.xml`.
-[Google.com][3]訪問：
+**注**： 在 Android 2.3 上和之前，域白仅适用于 `href` 的超链接，不引用的资源，如图像和脚本。 采取步骤，避免从被注入到应用程序的脚本。
- <access origin="http://google.com/*" />
-
-
-## 黑莓 10
+导航到非白名单域通过 `href` 的超链接会导致要打开默认浏览器中，而不是在应用程序中的页。（比较这到下面提到的 iOS 的行为)。
-### 詳細資訊
+## iOS 白
-在找到白規則 `www/config.xml` ，並宣佈與元素`<access origin="..." />`.
+该平台的白规则命名的应用程序目录中找到 `config.xml` 文件。
-黑莓 10 比其他平臺兩種方式以不同的方式處理萬用字元：
+没有一个协议，如指定的起源 `www.apache.org` 而不是 `http://www.apache.org` ，默认为所有的 `http` ， `https` ， `ftp` ，和 `ftps` 计划。
-1） 由用戶端代碼訪問的內容必須顯式聲明。起源 ="*"將不尊重這一使用情形。或者，可使用首選項禁用所有 web 安全。
+在 iOS 平台上的通配符是比在[W3C 构件访问][1]规范更灵活。 例如，以下访问所有子域和顶级域如 `.com` 和 `.net` ：
-2） 子域 ="true"可用於代替"*.domain"
+ <access origin="*.google.*" />
+
-### 語法
+与上文指出的对非白名单域通过导航的 Android 平台不同的是 `href` iOS 上的超链接可以防止页面打开在所有。
-[Google.com][3]訪問：
+## 黑莓 10 白
- <access origin="http://google.com" subdomains="false" />
-
+在找到白规则`www/config.xml`.
-對[maps.google.com][5]的訪問：
+黑莓 10 位使用通配符有别于其他平台两种方式：
- <access origin="http://maps.google.com" subdomains="false" />
+* 通过访问任何内容 `XMLHttpRequest` 必须显式声明。 设置 `origin="*"` 不在这种情况下工作。 另外，所有 web 安全性可能会都禁用使用 `WebSecurity` 黑莓手机配置中所述的首选项：
+ <preference name="websecurity" value="disable" />
+
-對在[google.com][3]上的所有子域的訪問：
-
- <access origin="http://google.com" subdomains="true" />
+* 作为替代设置 `*.domain` ，设置附加 `subdomains` 属性为 `true` 。 它应设置为 `false` ，默认情况。 例如，以下允许访问 `google.com` ， `maps.google.com` ，和 `docs.google.com` ：
-
-訪問到所有的域，包括 `file://` 協定：
-
- <access origin="*" subdomains="true" />
+ <access origin="http://google.com" subdomains="true" />
+
-
-禁用所有 web 安全性：
-
- <preference name="websecurity" value="disable" />
+ 以下缩小访问到 `google.com` ：
-
-## iOS
-
-### 詳細資訊
-
-在找到白規則 `AppName/config.xml` ，並宣佈與元素`<access origin="..." />`.
-
-iOS 完全支援白語法。
-
-### 在 3.1.0 中更改：
-
-之前 3.1.0 版，科爾多瓦 iOS 包括一些非標準擴展域 whilelisting 計畫其他科爾多瓦平臺都支援的。 自 3.1.0、 iOS 白名單現在符合資源白名單語法描述了本文檔的頂部。 如果您從 pre-3.1.0、 升級和使用這些擴展，您可能需要更改您 `config.xml` ，以前一樣繼續白組相同的資源檔。
-
-具體而言，這些模式需要更新：
-
-* " `apache.org` "（無協定）： 這將先前匹配 `http` ， `https` ， `ftp` ，和 `ftps` 的協定。 將更改為" `*://apache.org/*` "，包括所有協定，或都包括您需要支援的每個協定的線。
-
-* " `http://apache.*` "（萬用字元域的一端）： 這將先前匹配的所有頂級-級別-域，包括所有可能的兩個字母 Tld （但不是有用域喜歡。 co.uk)。 為每個 TLD，您實際上控制，並且需要到白名單中包括一條線。
-
-* " `h*t*://ap*he.o*g` "（萬用字元為隨機丟失信件）： 不再支援這些 ； 更改包含一條線的每個域和協定，您實際上需要到白名單中。
-
-### 語法
-
-[Google.com][3]訪問：
-
- <access origin="http://google.com/*" />
+ <access origin="http://google.com" subdomains="false" />
+
-
-## Windows Phone (7 和 8)
-
-在找到白規則 `config.xml` ，並宣佈與元素`<access origin="..." />`.
-
-### 語法
-
-[Google.com][3]訪問：
-
- <access origin="http://google.com" />
+ 指定访问到所有的域，包括本地 `file://` 协议：
+ <access origin="*" subdomains="true" />
-## Tizen
+(有关支持的详细信息，请参阅黑莓的文档[访问元素][8]上.)
-### 詳細資訊
+ [8]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html
-應用程式根目錄下的 `config.xml` 檔指定域白規則，使用 `<access origin="..." />` 元素。 完整引用，請參閱[Tizen 訪問外部網路資源檔][10].
+## 3.1.0 的 iOS 变化
- [10]: https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_4#8814682_CreatingaProject-AccessingExternalNetworkResources
+之前 3.1.0 版，科尔多瓦 iOS 包括一些非标准扩展域 whilelisting 计划其他科尔多瓦平台都支持的。 自 3.1.0、 iOS 白名单现在符合资源白名单语法描述了本文档的顶部。 如果您从 pre-3.1.0、 升级和使用这些扩展，您可能需要更改您 `config.xml` ，以前一样继续白组相同的资源文件。
-### 語法
+具体而言，这些模式需要更新：
-[Google.com][3]訪問：
+* `apache.org`（无协议）： 这将先前匹配 `http` ， `https` ， `ftp` ，和 `ftps` 的协议。 将更改为" `*://apache.org/*` "，包括所有协议，或都包括您需要支持的每个协议的线。
- <access origin="http://google.com" subdomains="false" />
-
+* `http://apache.*`（通配符域的一端）： 这将先前匹配的所有顶级-级别-域，包括所有可能的两个字母 Tld （但不是有用域喜欢。 co.uk)。 为每个 TLD，您实际上控制，并且需要到白名单中包括一条线。
-對安全[google.com][4]的訪問 ( `https://` ):
+* `h*t*://ap*he.o*g`（随机缺少字母的通配符）： 不再支持这些 ；更改包含为每个域和协议，你实际上需要到白名单中的一线。
- <access origin="https://google.com" subdomains="false" />
-
+## Windows Phone 白
-對在[google.com][3]上的所有子域的訪問：
+Windows Phone 7 和 8 的白规则发现在应用程序中的 `config.xml` 文件。
- <access origin="http://google.com" subdomains="true" />
-
+## Tizen 白
-訪問到所有的域，包括 `file://` 協定：
+白规则发现在应用程序中的 `config.xml` 文件。 在平台上同样依赖于 `subdomains` 属性作为黑莓平台。 (有关支持的详细信息，请参阅 Tizen 的文档[访问元素][9]上.)
- <access origin="*" subdomains="true" />
\ No newline at end of file
+ [9]: https://developer.tizen.org/help/index.jsp?topic=%2Forg.tizen.web.appprogramming%2Fhtml%2Fide_sdk_tools%2Fconfig_editor_w3celements.htm
\ No newline at end of file