You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/08/30 19:26:00 UTC

[10/36] Add edge for Spanish, French, and Chinese.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/compass/parameters/compassError.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/compass/parameters/compassError.md b/docs/zh/edge/cordova/compass/parameters/compassError.md
new file mode 100644
index 0000000..b1b84d6
--- /dev/null
+++ b/docs/zh/edge/cordova/compass/parameters/compassError.md
@@ -0,0 +1,25 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# compassError
+
+罗盘功能的 onError 回调函数。
+
+## 示例
+
+    function(CompassError) {
+        // Handle the error
+    }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/compass/parameters/compassHeading.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/compass/parameters/compassHeading.md b/docs/zh/edge/cordova/compass/parameters/compassHeading.md
new file mode 100644
index 0000000..c3d05e3
--- /dev/null
+++ b/docs/zh/edge/cordova/compass/parameters/compassHeading.md
@@ -0,0 +1,45 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# compassHeading
+
+A `CompassHeading` 对象返回到 `compassSuccess` 回调函数。
+
+## 属性
+
+*   **magneticHeading**: 在某一时刻在时间中从 0-359.99 度的标题。*(人数)*
+
+*   **trueHeading**: 在某一时刻的时间与地理北极在 0-359.99 度标题。 负值表示不能确定真正的标题。 *(人数)*
+
+*   **headingAccuracy**: 中度报告的标题和真正标题之间的偏差。*(人数)*
+
+*   **时间戳**: 本项决定在其中的时间。*(毫秒)*
+
+## 说明
+
+`CompassHeading`对象返回到 `compassSuccess` 回调函数。
+
+## Android 的怪癖
+
+*   `trueHeading`不受支持,但报告相同的值`magneticHeading`
+
+*   `headingAccuracy`是始终为 0 因为有没有区别 `magneticHeading` 和`trueHeading`.
+
+## iOS 的怪癖
+
+*   `trueHeading` is only returned when location services are enabled via `navigator.geolocation.watchLocation()`
+
+*   IOS 4 设备及以上标题因素在该设备的当前方向,不涉及其绝对的立场,为应用程序支持的方向。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/compass/parameters/compassOptions.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/compass/parameters/compassOptions.md b/docs/zh/edge/cordova/compass/parameters/compassOptions.md
new file mode 100644
index 0000000..e75e612
--- /dev/null
+++ b/docs/zh/edge/cordova/compass/parameters/compassOptions.md
@@ -0,0 +1,39 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# compassOptions
+
+若要自定义的指南针检索一个可选参数。
+
+## 选项
+
+*   **频率**: 经常如何检索以毫秒为单位的罗经航向。*(人数)*(默认值: 100)
+
+*   **筛选器**: 启动 watchHeading 成功回调所需的度的变化。*(人数)*
+
+Android 的怪癖
+
+---
+
+*   `filter`不受支持。
+
+## Tizen 怪癖
+
+*   `filter`不受支持。
+
+## Windows Phone 7 和 8 怪癖
+
+*   `filter`不受支持。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/compass/parameters/compassSuccess.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/compass/parameters/compassSuccess.md b/docs/zh/edge/cordova/compass/parameters/compassSuccess.md
new file mode 100644
index 0000000..935b1f5
--- /dev/null
+++ b/docs/zh/edge/cordova/compass/parameters/compassSuccess.md
@@ -0,0 +1,34 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# compassSuccess
+
+提供了通过的罗经航向信息的 onSuccess 回调函数 `compassHeading` 对象。
+
+    function(heading) {
+        // Do something
+    }
+    
+
+## 参数
+
+*   **标题**: 标题信息。*() compassHeading*
+
+## 示例
+
+    function onSuccess(heading) {
+        alert('Heading: ' + heading.magneticHeading);
+    };
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/connection/connection.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/connection/connection.md b/docs/zh/edge/cordova/connection/connection.md
new file mode 100644
index 0000000..ed56141
--- /dev/null
+++ b/docs/zh/edge/cordova/connection/connection.md
@@ -0,0 +1,78 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# 连接
+
+> `connection`对象,通过公开 `navigator.connection` ,提供了有关该设备的移动电话和无线网络连接的信息。
+
+## 属性
+
+*   connection.type
+
+## 常量
+
+*   Connection.UNKNOWN
+*   Connection.ETHERNET
+*   Connection.WIFI
+*   Connection.CELL_2G
+*   Connection.CELL_3G
+*   Connection.CELL_4G
+*   Connection.CELL
+*   Connection.NONE
+
+## 访问功能
+
+从 3.0 版,科尔多瓦作为*插件*实现了设备级 Api。 使用 CLI 的 `plugin` 命令,描述在命令行界面,可以添加或删除一个项目,为此功能:
+
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
+        $ cordova plugin rm org.apache.cordova.core.network-information
+    
+
+这些命令适用于所有有针对性的平台,但修改如下所述的特定于平台的配置设置:
+
+*   Android 系统
+    
+        (in app/res/xml/config.xml) < 功能名称 ="网络状态">< 参数名称 ="android 包"value="org.apache.cordova.NetworkManager"/ >< / 功能 > (在 app/AndroidManifest.xml) < 使用权限 android:name="android.permission.INTERNET"/ >< 使用权限 android:name="android.permission.ACCESS_NETWORK_STATE"/ >< 使用权限 android:name="android.permission.READ_PHONE_STATE"/ >
+        
+
+*   黑莓手机 WebWorks
+    
+        (in www/plugins.xml) < 功能名称 ="网络状态">< 参数名称 ="黑莓手机-包"value="org.apache.cordova.network.Network"/ >< / 功能 >
+        
+
+*   (在 iOS`config.xml`)
+    
+        < 功能名称 ="网络状态">< 参数名称 ="ios 包"值 ="CDVConnection"/ >< / 功能 >
+        
+
+*   (在 Windows Phone`Properties/WPAppManifest.xml`)
+    
+        < 功能 >< 功能名称 ="ID_CAP_NETWORKING"/ >< / 功能 >
+        
+    
+    引用:[为 Windows Phone 应用程序清单][1]
+
+*   (在 Tizen`config.xml`)
+    
+        < 功能名称 = 所需的"http://tizen.org/api/systeminfo"="true"/ >
+        
+    
+    引用: [Tizen Web 应用程序的应用程序清单][2]
+
+ [1]: http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx
+ [2]: https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures
+
+一些平台可能支持此功能,而无需任何特殊的配置。有关概述,请参见平台支持。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/connection/connection.type.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/connection/connection.type.md b/docs/zh/edge/cordova/connection/connection.type.md
new file mode 100644
index 0000000..479caa8
--- /dev/null
+++ b/docs/zh/edge/cordova/connection/connection.type.md
@@ -0,0 +1,119 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# connection.type
+
+检查当前活动的网络连接。
+
+## 说明
+
+此属性提供快速的方法来确定设备的网络连接状态,和连接类型。
+
+## 支持的平台
+
+*   iOS
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    function checkConnection() {
+        var networkState = navigator.connection.type;
+    
+        var states = {};
+        states[Connection.UNKNOWN]  = 'Unknown connection';
+        states[Connection.ETHERNET] = 'Ethernet connection';
+        states[Connection.WIFI]     = 'WiFi connection';
+        states[Connection.CELL_2G]  = 'Cell 2G connection';
+        states[Connection.CELL_3G]  = 'Cell 3G connection';
+        states[Connection.CELL_4G]  = 'Cell 4G connection';
+        states[Connection.CELL]     = 'Cell generic connection';
+        states[Connection.NONE]     = 'No network connection';
+    
+        alert('Connection type: ' + states[networkState]);
+    }
+    
+    checkConnection();
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>navigator.connection.type Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            checkConnection();
+        }
+    
+            function checkConnection() {
+                var networkState = navigator.connection.type;
+    
+                var states = {};
+                states[Connection.UNKNOWN]  = 'Unknown connection';
+                states[Connection.ETHERNET] = 'Ethernet connection';
+                states[Connection.WIFI]     = 'WiFi connection';
+                states[Connection.CELL_2G]  = 'Cell 2G connection';
+                states[Connection.CELL_3G]  = 'Cell 3G connection';
+                states[Connection.CELL_4G]  = 'Cell 4G connection';
+                states[Connection.CELL]     = 'Cell generic connection';
+                states[Connection.NONE]     = 'No network connection';
+    
+                alert('Connection type: ' + states[networkState]);
+            }
+    
+        </script>
+      </head>
+      <body>
+        <p>A dialog box will report the network state.</p>
+      </body>
+    </html>
+    
+
+## API 更改
+
+科尔多瓦 2.3.0,直到 `Connection` 对象的访问通过 `navigator.network.connection` 后才改为其中, `navigator.connection` 以匹配的 W3C 规范。 它在其原始位置,是仍然可用,但已废弃,最终将被删除。
+
+## iOS 的怪癖
+
+*   iOS 无法检测到蜂窝网络连接的类型。 
+    *   `navigator.connection.type` is set to `Connection.CELL` for all cellular data.
+
+## Windows Phone 怪癖
+
+*   When running in the emulator, always detects `navigator.connection.type` as `Connection.UNKNOWN`.
+
+*   Windows Phone 不能检测的蜂窝网络连接的类型。
+    
+    *   `navigator.connection.type` is set to `Connection.CELL` for all cellular data.
+
+## Tizen 怪癖
+
+*   Tizen 只可以检测一个 WiFi 或者蜂窝连接。 
+    *   `navigator.connection.type` is set to `Connection.CELL_2G` for all cellular data.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/Contact/contact.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/Contact/contact.md b/docs/zh/edge/cordova/contacts/Contact/contact.md
new file mode 100644
index 0000000..7ce2c42
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/Contact/contact.md
@@ -0,0 +1,251 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# 联系人
+
+包含描述联系,如用户的个人或业务联系人的属性。
+
+## 属性
+
+*   **id**: 一个全局唯一标识符。*() DOMString*
+
+*   **显示名称**: 此联系人,适合于向最终用户显示的名称。*() DOMString*
+
+*   **名称**: 包含所有组件的人的名称的对象。*(联系人姓名)*
+
+*   **昵称**: 休闲的解决联系人名称。*() DOMString*
+
+*   **手机**: 一个数组的所有联系人的电话号码。*(ContactField[])*
+
+*   **电子邮件**: 所有联系人的电子邮件地址的数组。*(ContactField[])*
+
+*   **地址**: 该联系人的所有地址的数组。*(ContactAddress[])*
+
+*   **ims**: 所有联系人的 IM 地址的数组。*(ContactField[])*
+
+*   **组织**: 该联系人的所有组织的数组。*(ContactOrganization[])*
+
+*   **生日**: 联系人的生日。*(日期)*
+
+*   **注**: 有关联系人的注释。*() DOMString*
+
+*   **照片**: 数组联系人的照片。*(ContactField[])*
+
+*   **类别**: 数组与联系人关联的所有用户定义的类别。*(ContactField[])*
+
+*   **url**: 数组与联系人关联的 web 页。*(ContactField[])*
+
+## 方法
+
+*   **克隆**: 返回一个新的 `Contact` 对象就是调用对象的深层副本 `id` 属性设置为`null`.
+
+*   **删除**: 从设备的联系人数据库中删除联系人,否则执行错误回调与 `ContactError` 对象。
+
+*   **保存**: 将一个新的联系人保存到设备的联系人数据库中,或更新现有的联系人 (如果已存在具有相同**id**的联系人。
+
+## 详细信息
+
+`Contact`对象表示用户的联系人。 可以创建、 存储,或从设备的联系人数据库中删除的联系人。 联系人可以还 (单独或批量) 从数据库中检索通过调用 `contacts.find` 方法。
+
+**注:**不是所有的上面列出的联系人字段平台支持的每个设备。请检查每个平台*的怪癖*节了解详细信息。
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 保存快速示例
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+## 克隆快速示例
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+## 删除快速示例
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+        // remove the contact from the device
+        contact.remove(onSuccess,onError);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Contact Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // create
+            var contact = navigator.contacts.create();
+            contact.displayName = "Plumber";
+            contact.nickname = "Plumber";                 // specify both to support all devices
+            var name = new ContactName();
+            name.givenName = "Jane";
+            name.familyName = "Doe";
+            contact.name = name;
+    
+            // save
+            contact.save(onSaveSuccess,onSaveError);
+    
+            // clone
+            var clone = contact.clone();
+            clone.name.givenName = "John";
+            console.log("Original contact name = " + contact.name.givenName);
+            console.log("Cloned contact name = " + clone.name.givenName);
+    
+            // remove
+            contact.remove(onRemoveSuccess,onRemoveError);
+        }
+    
+        // onSaveSuccess: Get a snapshot of the current contacts
+        //
+        function onSaveSuccess(contact) {
+            alert("Save Success");
+        }
+    
+        // onSaveError: Failed to get the contacts
+        //
+        function onSaveError(contactError) {
+            alert("Error = " + contactError.code);
+        }
+    
+        // onRemoveSuccess: Get a snapshot of the current contacts
+        //
+        function onRemoveSuccess(contacts) {
+            alert("Removal Success");
+        }
+    
+        // onRemoveError: Failed to get the contacts
+        //
+        function onRemoveError(contactError) {
+            alert("Error = " + contactError.code);
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Find Contacts</p>
+      </body>
+    </html>
+    
+
+## Android 2.X 的怪癖
+
+*   **类别**: 不支持 Android 2.X 设备上,返回`null`.
+
+## 黑莓手机 WebWorks (OS 5.0 和更高) 的怪癖
+
+*   **id**: 支持。由该设备分配时保存该联系人。
+
+*   **显示名称**: 支持。黑莓**user1**字段中存储。
+
+*   **昵称**: 不受支持,返回`null`.
+
+*   **手机**: 部分支持。 电话号码存储在黑莓的字段**homePhone1**和**homePhone2**中,如果*类型*是 '回家', **workPhone1**和**workPhone2**如果*类型*是 '工作',**手机**如果*类型*为移动电话, **faxPhone** ,如果*类型*是传真, **pagerPhone** ,如果*类型*是 '寻呼机' 和**otherPhone**如果*类型*是以上都不是。
+
+*   **电子邮件**: 部分支持。 第三个电子邮件地址分别存储在黑莓**电子邮件 1**,**电子邮件 2**、**电子邮件 3**字段。
+
+*   **地址**: 部分支持。第一和第二个地址分别存储在黑莓**家庭地址**和**workAddress**字段中。
+
+*   **ims**: 不受支持,返回`null`.
+
+*   **组织**: 部分支持。 **名称**和**标题**的第一个组织存储在黑莓**公司**和**标题**字段中,分别。
+
+*   **照片**: 部分支持。 支持单一的缩略图大小的照片。 若要设置联系人的照片,通过在任一 base64 编码的图像或指向图像的 URL。 图像保存到黑莓手机的联系人数据库前按比例缩小。 联系人照片返回 base64 编码的图像。
+
+*   **类别**: 部分支持。支持的只有*商业*和*个人*的类别。
+
+*   **url**: 部分支持。第一个 URL 存储在黑莓手机**网页**字段中。
+
+## iOS 的怪癖
+
+*   **显示名称**: 上返回的 iOS 不支持 `null` 除非有没有 `ContactName` 指定,在这种情况下它将返回复合名称,**绰号**或 `""` ,分别。
+
+*   **生日**: 必须输入 JavaScript 作为 `Date` 对象,它将返回相同的方式。
+
+*   **照片**: 返回到图像,存储在应用程序的临时目录中的文件的 URL。当应用程序退出时删除临时目录的内容。
+
+*   **类别**: 这目前不支持属性,返回`null`.
+
+## Windows Phone 7 和 8 怪癖
+
+*   **显示名称**: 当创建一个联系人,提供的显示名称参数不同于显示名称的值检索查找联系人时。
+
+*   **url**: 当创建一个联系人,用户可以输入和保存多个 web 地址,但只有一个是可用时,可以使用搜索联系人。
+
+*   **手机**: 不支持*参照*选项。 在*查找*操作中不是支持的*类型*。 只有一个 `phoneNumber` 允许为每个*类型*.
+
+*   **电子邮件**:*参照*选项不受支持。家庭和个人使用引用同一电子邮件项。只有一项被允许为每个*类型*.
+
+*   **地址**: 仅支持工作和家庭/个人*类型*。家庭和个人*类型*引用相同的地址条目。只有一项被允许为每个*类型*.
+
+*   **组织**: 唯一一个允许的并且不支持的*治安*、*类型*和*新闻部*的属性。
+
+*   **注意**: 不支持返回`null`.
+
+*   **ims**: 不受支持,返回`null`.
+
+*   **生日**: 不受支持,返回`null`.
+
+*   **类别**: 不受支持,返回`null`.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/ContactAddress/contactaddress.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/ContactAddress/contactaddress.md b/docs/zh/edge/cordova/contacts/ContactAddress/contactaddress.md
new file mode 100644
index 0000000..d685b61
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/ContactAddress/contactaddress.md
@@ -0,0 +1,164 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# ContactAddress
+
+包含地址属性的 `Contact` 对象。
+
+## 属性
+
+*   **上一页**: 设置为 `true` 如果此 `ContactAddress` 包含用户的首选的值。*(布尔)*
+
+*   **类型**: 一个字符串,例如指示哪种类型的字段这是*回家*。*() DOMString*
+
+*   **格式**: 显示格式的完整地址。*() DOMString*
+
+*   **streetAddress**: 完整的街道地址。*() DOMString*
+
+*   **地点**: 城市或地点。*() DOMString*
+
+*   **区域**: 国家或地区。*() DOMString*
+
+*   **邮政编码**: 邮政编码或邮政代码。*() DOMString*
+
+*   **国家**: 国家名称。*() DOMString*
+
+## 详细信息
+
+`ContactAddress`对象存储的单一地址的联系人的属性。 A `Contact` 对象可能包括多个地址在 `ContactAddress[]` 数组。
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Contact Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // find all contacts
+            var options = new ContactFindOptions();
+            options.filter = "";
+            var filter = ["displayName", "addresses"];
+            navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Get a snapshot of the current contacts
+        //
+        function onSuccess(contacts) {
+            // display the address information for all contacts
+            for (var i = 0; i < contacts.length; i++) {
+                for (var j = 0; j < contacts[i].addresses.length; j++) {
+                    alert("Pref: "           + contacts[i].addresses[j].pref          + "\n" +
+                          "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                          "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                          "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                          "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                          "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                          "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                          "Country: "        + contacts[i].addresses[j].country);
+                }
+            }
+        };
+    
+        // onError: Failed to get the contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Find Contacts</p>
+      </body>
+    </html>
+    
+
+## Android 2.X 的怪癖
+
+*   **上一页**: 不受支持,返回 `false` Android 2.X 的设备上。
+
+## 黑莓手机 WebWorks (OS 5.0 和更高) 的怪癖
+
+*   **上一页**: 返回的黑莓设备上不支持`false`.
+
+*   **类型**: 部分支持。*工作*和*家庭*类型地址的每个唯一一个可以存储每个联系人。
+
+*   **格式化**: 部分支持。返回的串联的所有黑莓手机地址字段。
+
+*   **streetAddress**: 支持。返回的串联的黑莓**地址 1**和**地址 2**的地址字段。
+
+*   **现场**: 支持。黑莓手机**城**地址字段中存储。
+
+*   **区域**: 支持。黑莓手机**stateProvince**地址字段中存储。
+
+*   **邮政编码**: 支持。黑莓手机**zipPostal**地址字段中存储。
+
+*   **国家**: 支持。
+
+## iOS 的怪癖
+
+*   **上一页**: 返回的 iOS 设备上不支持`false`.
+
+*   **格式化**: 目前不支持。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/ContactError/contactError.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/ContactError/contactError.md b/docs/zh/edge/cordova/contacts/ContactError/contactError.md
new file mode 100644
index 0000000..73f1bd9
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/ContactError/contactError.md
@@ -0,0 +1,37 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# ContactError
+
+A `ContactError` 对象传递给 `contactError` 回调时出现错误。
+
+## 属性
+
+*   **代码**: 下面列出的预定义的错误代码之一。
+
+## 常量
+
+*   `ContactError.UNKNOWN_ERROR`
+*   `ContactError.INVALID_ARGUMENT_ERROR`
+*   `ContactError.TIMEOUT_ERROR`
+*   `ContactError.PENDING_OPERATION_ERROR`
+*   `ContactError.IO_ERROR`
+*   `ContactError.NOT_SUPPORTED_ERROR`
+*   `ContactError.PERMISSION_DENIED_ERROR`
+
+## 说明
+
+`ContactError`对象返回到用户通过 `contactError` 回调函数时出现错误。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/ContactField/contactfield.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/ContactField/contactfield.md b/docs/zh/edge/cordova/contacts/ContactField/contactfield.md
new file mode 100644
index 0000000..78330b6
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/ContactField/contactfield.md
@@ -0,0 +1,139 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# ContactField
+
+支持泛型字段在 `Contact` 对象。某些属性存储作为 `ContactField` 对象包括电子邮件地址、 电话号码和 Url。
+
+## 属性
+
+*   **类型**: 一个字符串,例如指示哪种类型的字段这是*回家*。*() DOMString*
+
+*   **值**: 字段的值,如电话号码或电子邮件地址。*() DOMString*
+
+*   **上一页**: 设置为 `true` 如果此 `ContactField` 包含用户的首选的值。*(布尔)*
+
+## 详细信息
+
+`ContactField`对象是可重用的组件表示泛指联系人字段。 每个 `ContactField` 对象包含 `value` , `type` ,和 `pref` 属性。 A `Contact` 对象存储中的几个属性 `ContactField[]` 数组,如电话号码和电子邮件地址。
+
+在大多数情况下,没有任何预先确定的值为 `ContactField` 对象的**type**属性。 例如,电话号码可以指定**类型**的*家庭*、*工作*、*移动*、 *iPhone*或由一个特定的设备平台联系数据库支持的任何其他值的值。 然而,对于 `Contact` **的照片**字段,**类型**字段指示返回图像的格式: **url**的**值**属性包含的照片图像或*base64*的 URL 时的**值**包含一个 base64 编码的图像字符串时。 
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Contact Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+    
+        function onDeviceReady() {
+            // create a new contact
+            var contact = navigator.contacts.create();
+    
+            // store contact phone numbers in ContactField[]
+            var phoneNumbers = [];
+            phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+            phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+            phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+            contact.phoneNumbers = phoneNumbers;
+    
+            // save the contact
+            contact.save();
+    
+            // search contacts, returning display name and phone numbers
+            var options = new ContactFindOptions();
+            options.filter = "";
+            filter = ["displayName", "phoneNumbers"];
+            navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Get a snapshot of the current contacts
+        //
+        function onSuccess(contacts) {
+            for (var i = 0; i < contacts.length; i++) {
+                // display phone numbers
+                for (var j = 0; j < contacts[i].phoneNumbers.length; j++) {
+                    alert("Type: "      + contacts[i].phoneNumbers[j].type  + "\n" +
+                          "Value: "     + contacts[i].phoneNumbers[j].value + "\n" +
+                          "Preferred: " + contacts[i].phoneNumbers[j].pref);
+                }
+            }
+        };
+    
+        // onError: Failed to get the contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Find Contacts</p>
+      </body>
+    </html>
+    
+
+## Android 的怪癖
+
+*   **上一页**: 不受支持,返回`false`.
+
+## 黑莓手机 WebWorks (OS 5.0 和更高) 的怪癖
+
+*   **类型**: 部分支持。使用的电话号码。
+
+*   **值**: 支持。
+
+*   **上一页**: 不受支持,返回`false`.
+
+## iOS 的怪癖
+
+*   **上一页**: 不受支持,返回`false`.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md b/docs/zh/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md
new file mode 100644
index 0000000..53a48eb
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/ContactFindOptions/contactfindoptions.md
@@ -0,0 +1,106 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# ContactFindOptions
+
+包含可用于筛选结果的属性 `contacts.find` 操作。
+
+## 属性
+
+*   **筛选器**: 用来查找联系人的搜索字符串。*() DOMString*(默认值:`""`)
+
+*   **多个**: 确定是否查找操作返回多个联系人。*(布尔)*(默认值:`false`)
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    // success callback
+    function onSuccess(contacts) {
+        for (var i=0; i<contacts.length; i++) {
+            alert(contacts[i].displayName);
+        }
+    };
+    
+    // error callback
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // specify contact search criteria
+    var options = new ContactFindOptions();
+        options.filter="";        // empty search string returns all contacts
+        options.multiple=true;    // return multiple results
+        filter = ["displayName"]; // return contact.displayName field
+    
+        // find contacts
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Contact Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // specify contact search criteria
+            var options = new ContactFindOptions();
+            options.filter = "";      // empty search string returns all contacts
+            options.multiple = true;  // return multiple results
+            filter = ["displayName"]; // return contact.displayName field
+    
+            // find contacts
+            navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Get a snapshot of the current contacts
+        //
+        function onSuccess(contacts) {
+            for (var i=0; i<contacts.length; i++) {
+                alert(contacts[i].displayName);
+            }
+        };
+    
+        // onError: Failed to get the contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Find Contacts</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/ContactName/contactname.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/ContactName/contactname.md b/docs/zh/edge/cordova/contacts/ContactName/contactname.md
new file mode 100644
index 0000000..e74b138
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/ContactName/contactname.md
@@ -0,0 +1,141 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# 联系人姓名
+
+包含有关的不同种类的信息 `Contact` 对象的名称。
+
+## 属性
+
+*   **格式化**: 该联系人的完整名称。*() DOMString*
+
+*   **家族**: 联系人的姓氏。*() DOMString*
+
+*   **givenName**: 联系人的名字。*() DOMString*
+
+*   **之间**: 联系人的中间名。*() DOMString*
+
+*   **honorificPrefix**: 联系人的前缀 (例如*先生*或*博士*) *(DOMString)*
+
+*   **honorificSuffix**: 联系人的后缀 (如*律师*)。*() DOMString*
+
+## 详细信息
+
+`ContactName`对象存储的联系人的名称属性。
+
+## 支持的平台
+
+*   Android 2.X
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Contact Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var options = new ContactFindOptions();
+            options.filter="";
+            filter = ["displayName","name"];
+            navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Get a snapshot of the current contacts
+        //
+        function onSuccess(contacts) {
+            for (var i = 0; i < contacts.length; i ++) {
+                alert("Formatted: " + contacts[i].name.formatted       + "\n" +
+                    "Family Name: " + contacts[i].name.familyName      + "\n" +
+                    "Given Name: "  + contacts[i].name.givenName       + "\n" +
+                    "Middle Name: " + contacts[i].name.middleName      + "\n" +
+                    "Suffix: "      + contacts[i].name.honorificSuffix + "\n" +
+                    "Prefix: "      + contacts[i].name.honorificPrefix);
+            }
+        };
+    
+        // onError: Failed to get the contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Find Contacts</p>
+      </body>
+    </html>
+    
+
+## Android 的怪癖
+
+*   **格式化**: 部分支持,和只读。 返回的串联的 `honorificPrefix` , `givenName` , `middleName` , `familyName` ,和`honorificSuffix`.
+
+## 黑莓手机 WebWorks (OS 5.0 和更高) 的怪癖
+
+*   **格式化**: 部分支持。返回的串联的黑莓手机**名字**和**姓氏**字段。
+
+*   **家族**: 支持。黑莓**姓氏**字段中存储。
+
+*   **givenName**: 支持。黑莓**名字**字段中存储。
+
+*   **之间**: 不受支持,返回`null`.
+
+*   **honorificPrefix**: 不受支持,返回`null`.
+
+*   **honorificSuffix**: 不受支持,返回`null`.
+
+## iOS 的怪癖
+
+*   **格式化**: 部分支持。返回 iOS 复合名称,但为只读。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/ContactOrganization/contactorganization.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/ContactOrganization/contactorganization.md b/docs/zh/edge/cordova/contacts/ContactOrganization/contactorganization.md
new file mode 100644
index 0000000..d6e3acb
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/ContactOrganization/contactorganization.md
@@ -0,0 +1,147 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# ContactOrganization
+
+包含 `Contact` 对象的组织属性。
+
+## 属性
+
+*   **上一页**: 设置为 `true` 如果此 `ContactOrganization` 包含用户的首选的值。*(布尔)*
+
+*   **类型**: 一个字符串,例如指示哪种类型的字段这是*回家*。_(DOMString)
+
+*   **名称**: 组织的名称。*() DOMString*
+
+*   **部门**: 新闻部的工程合约。*() DOMString*
+
+*   **标题**: 在组织联系人的标题。*() DOMString*
+
+## 详细信息
+
+`ContactOrganization`对象存储的联系人的组织属性。A `Contact` 对象存储一个或多个 `ContactOrganization` 数组中的对象。
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Contact Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var options = new ContactFindOptions();
+            options.filter="";
+            filter = ["displayName","organizations"];
+            navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Get a snapshot of the current contacts
+        //
+        function onSuccess(contacts) {
+            for (var i = 0; i < contacts.length; i++) {
+                for (var j = 0; j < contacts[i].organizations.length; j++) {
+                    alert("Pref: "     + contacts[i].organizations[j].pref       + "\n" +
+                        "Type: "       + contacts[i].organizations[j].type       + "\n" +
+                        "Name: "       + contacts[i].organizations[j].name       + "\n" +
+                        "Department: " + contacts[i].organizations[j].department + "\n" +
+                        "Title: "      + contacts[i].organizations[j].title);
+                }
+            }
+        };
+    
+        // onError: Failed to get the contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Find Contacts</p>
+      </body>
+    </html>
+    
+
+## Android 2.X 的怪癖
+
+*   **上一页**: 不支持的 Android 2.X 的设备,返回`false`.
+
+## 黑莓手机 WebWorks (OS 5.0 和更高) 的怪癖
+
+*   **上一页**: 不支持的黑莓设备,返回`false`.
+
+*   **类型**: 不支持的黑莓设备,返回`null`.
+
+*   **名称**: 部分支持。第一次组织名称存储在黑莓**公司**字段中。
+
+*   **部**: 不受支持,返回`null`.
+
+*   **标题**: 部分支持。第一次组织标题是黑莓**jobTitle**字段中存储的。
+
+## iOS 的怪癖
+
+*   **上一页**: 返回的 iOS 设备上不支持`false`.
+
+*   **类型**: 不支持的 iOS 设备上,返回`null`.
+
+*   **名称**: 部分支持。第一次组织名称存储在 iOS **kABPersonOrganizationProperty**字段中。
+
+*   **新闻部**: 部分支持。第一部名称存储在 iOS **kABPersonDepartmentProperty**字段中。
+
+*   **标题**: 部分支持。第一个标题是 iOS **kABPersonJobTitleProperty**字段中存储的。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/contacts.create.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/contacts.create.md b/docs/zh/edge/cordova/contacts/contacts.create.md
new file mode 100644
index 0000000..b5f623c
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/contacts.create.md
@@ -0,0 +1,70 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# contacts.create
+
+返回一个新的联系人对象。
+
+    var contact = navigator.contacts.create(properties);
+    
+
+## 说明
+
+`contacts.create`方法是同步的并返回一个新的 `Contact` 对象。
+
+此方法不会保留联系人对象在设备的联系人数据库中,您需要为其调用 `Contact.save` 方法。
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+
+## 快速的示例
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Contact Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var myContact = navigator.contacts.create({"displayName": "Test User"});
+            myContact.note = "This contact has a note.";
+            console.log("The contact, " + myContact.displayName + ", note: " + myContact.note);
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Create Contact</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/contacts.find.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/contacts.find.md b/docs/zh/edge/cordova/contacts/contacts.find.md
new file mode 100644
index 0000000..5120636
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/contacts.find.md
@@ -0,0 +1,110 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# contacts.find
+
+查询设备联系人数据库,并返回一个或多个 `Contact` 对象,每个包含指定的字段。
+
+    navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
+    
+
+## 说明
+
+`contacts.find`方法以异步方式,执行设备的联系人数据库查询并返回一个数组的 `Contact` 对象。 所得到的对象传递给 `contactSuccess` **contactSuccess**参数所指定的回调函数。
+
+**ContactFields**参数指定要搜索的限定符,作为使用的字段,只有那些结果传递给**contactSuccess**回调函数。 零长度**contactFields**参数是无效的结果在 `ContactError.INVALID_ARGUMENT_ERROR` 。 **ContactFields**值为 `"*"` 返回所有联系人字段。
+
+**ContactFindOptions.filter**字符串查询联系人数据库时,可以用作搜索筛选器。 如果提供,不区分大小写,部分值匹配应用于在**contactFields**参数中指定的每个字段。 如果有*任何*指定的字段的匹配,则返回该联系人。
+
+## 参数
+
+*   **contactFields**: 联系人字段使用作为搜索的限定符。生成的 `Contact` 对象只能使用这些字段的值。*(DOMString[])*[要求]
+
+*   **contactSuccess**: 从数据库返回成功回调函数调用时使用的联系人。[要求]
+
+*   **contactError**: 错误回调函数,当发生错误时调用。[可选]
+
+*   **contactFindOptions**: 搜索选项,以过滤联系人。[可选]
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    var fields       = ["displayName", "name"];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+        <head>
+            <title>Contact Example</title>
+            <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+            <script type="text/javascript" charset="utf-8">
+    
+                // Wait for device API libraries to load
+                document.addEventListener("deviceready", onDeviceReady, false);
+    
+                // device APIs are available
+    
+                function onDeviceReady() {
+                    // find all contacts with 'Bob' in any name field
+                    var options = new ContactFindOptions();
+                    options.filter = "Bob";
+                    var fields = ["displayName", "name"];
+                    navigator.contacts.find(fields, onSuccess, onError, options);
+                }
+    
+                // onSuccess: Get a snapshot of the current contacts
+    
+                function onSuccess(contacts) {
+                    for (var i = 0; i < contacts.length; i++) {
+                        console.log("Display Name = " + contacts[i].displayName);
+                    }
+                }
+    
+                // onError: Failed to get the contacts
+    
+                function onError(contactError) {
+                    alert('onError!');
+                }
+            </script>
+        </head>
+    
+        <body>
+            <h1>Example</h1>
+            <p>Find Contacts</p>
+        </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/contacts.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/contacts.md b/docs/zh/edge/cordova/contacts/contacts.md
new file mode 100644
index 0000000..441999b
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/contacts.md
@@ -0,0 +1,79 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# 联系人
+
+> `contacts`对象提供对设备的联系人数据库的访问。
+
+**重要的隐私注:**联系人数据的收集和使用提出了重要的隐私问题。 您的应用程序的隐私策略应该讨论如何应用程序使用的联系人数据和它是否被共享与任何其他方。 联系信息被视为敏感,因为它揭示了人与人通信的人们。 因此,除了您的应用程序的隐私策略,您应强烈考虑提供在您的应用程序访问或使用联系人数据 (如果设备操作系统不会这样做已经) 之前的时间只是通知。 该通知应提供相同的信息上文指出的并获取该用户的权限 (例如,通过为**确定**并**不感谢**提出的选择)。 请注意有些应用程序市场可能需要您的应用程序提供只是时间的通知,并从访问联系人数据之前用户获得的权限。 周围的联系人数据将有助于避免用户混淆使用感知的和滥用的联系人数据的清晰和易于理解的用户体验。 有关详细信息,请参阅隐私指南。
+
+## 方法
+
+*   contacts.create
+*   contacts.find
+
+## 参数
+
+*   contactFields
+*   contactSuccess
+*   contactError
+*   contactFindOptions
+
+## 对象
+
+*   联系人
+*   联系人姓名
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+
+## 访问功能
+
+从 3.0 版,科尔多瓦作为*插件*实现了设备级 Api。 使用 CLI 的 `plugin` 命令,描述在命令行界面,可以添加或删除一个项目,为此功能:
+
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git
+        $ cordova plugin rm org.apache.cordova.core.contacts
+    
+
+这些命令适用于所有有针对性的平台,但修改如下所述的特定于平台的配置设置:
+
+*   Android 系统
+    
+        (in app/res/xml/config.xml) < 功能名称 ="联系人">< 参数名称 ="android 包"value="org.apache.cordova.ContactManager"/ >< / 功能 > (在 app/AndroidManifest.xml) < 使用权限 android:name="android.permission.GET_ACCOUNTS"/ >< 使用权限 android:name="android.permission.READ_CONTACTS"/ >< 使用权限 android:name="android.permission.WRITE_CONTACTS"/ >
+        
+
+*   黑莓手机 WebWorks
+    
+        (in www/plugins.xml) < 功能名称 ="联系人">< 参数名称 ="黑莓手机-包"value="org.apache.cordova.pim.Contact"/ >< / 功能 > (在 www/config.xml) < 功能 id="blackberry.find"所需 ="true"版本 ="1.0.0.0"/ >< 功能 id="blackberry.identity"所需 ="true"版本 ="1.0.0.0"/ >< 功能 id="blackberry.pim.Address"所需 ="true"版本 ="1.0.0.0"/ >< 功能 id="blackberry.pim.Contact"所需 ="true"版本 ="1.0.0.0"/ >
+        
+
+*   (在 iOS`config.xml`)
+    
+        < 功能名称 ="联系人">< 参数名称 ="ios 包"值 ="CDVContacts"/ >< / 功能 >
+        
+
+*   Windows Phone
+    
+        (在 Properties/WPAppManifest.xml) < 功能 >< 功能名称 ="ID_CAP_CONTACTS"/ >< / 功能 >
+        
+    
+    引用:[为 Windows Phone 应用程序清单][1]
+
+ [1]: http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx
+
+一些平台可能支持此功能,而无需任何特殊的配置。有关概述,请参见平台支持。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/parameters/contactError.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/parameters/contactError.md b/docs/zh/edge/cordova/contacts/parameters/contactError.md
new file mode 100644
index 0000000..303df9a
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/parameters/contactError.md
@@ -0,0 +1,23 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# contactError
+
+联系函数的错误回调函数。
+
+    function(error) {
+        // Handle the error
+    }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/parameters/contactFields.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/parameters/contactFields.md b/docs/zh/edge/cordova/contacts/parameters/contactFields.md
new file mode 100644
index 0000000..792aeda
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/parameters/contactFields.md
@@ -0,0 +1,21 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# contactFields
+
+所需参数的 `contacts.find` 方法,用来指定哪些字段应包含在 `Contact` 产生的查找操作的对象。
+
+    ["名称"、"手机"、"电子邮件"]
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/parameters/contactFindOptions.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/parameters/contactFindOptions.md b/docs/zh/edge/cordova/contacts/parameters/contactFindOptions.md
new file mode 100644
index 0000000..ac59470
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/parameters/contactFindOptions.md
@@ -0,0 +1,28 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# contactFindOptions
+
+可选的参数, `contacts.find` 方法,用于筛选从联系人数据库返回的联系人。
+
+    {筛选器:""、 多个: true,} ;
+    
+
+## 选项
+
+*   **筛选器**: 用于过滤联系人的搜索字符串。*() DOMString*(默认值:`""`)
+
+*   **多个**: 确定是否查找操作返回多个联系人。*(布尔)*(默认值:`false`)
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/contacts/parameters/contactSuccess.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/contacts/parameters/contactSuccess.md b/docs/zh/edge/cordova/contacts/parameters/contactSuccess.md
new file mode 100644
index 0000000..e3db95a
--- /dev/null
+++ b/docs/zh/edge/cordova/contacts/parameters/contactSuccess.md
@@ -0,0 +1,36 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# contactSuccess
+
+提供的成功回调函数 `Contact` 数组产生的 `contacts.find` 操作。
+
+    function(contacts) {
+        // Do something
+    }
+    
+
+## 参数
+
+*   **联系人**: 联系人数组产生的查找操作。*(联系人)*
+
+## 示例
+
+    function contactSuccess(contacts) {
+        for (var i=0; i<contacts.length; i++) {
+            console.log("Display Name = " + contacts[i].displayName);
+        }
+    }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/device/device.cordova.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/device/device.cordova.md b/docs/zh/edge/cordova/device/device.cordova.md
new file mode 100644
index 0000000..122cbe0
--- /dev/null
+++ b/docs/zh/edge/cordova/device/device.cordova.md
@@ -0,0 +1,72 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# device.cordova
+
+获取科尔多瓦在设备上运行的版本。
+
+    var string = device.cordova;
+    
+
+## 说明
+
+`device.cordova`返回科尔多瓦在设备上运行的版本。
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    var name = device.cordova;
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Device Properties Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' +
+                                'Device Cordova: '  + device.cordova  + '<br />' +
+                                'Device Platform: ' + device.platform + '<br />' +
+                                'Device UUID: '     + device.uuid     + '<br />' +
+                                'Device Version: '  + device.version  + '<br />';
+        }
+    
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Loading device properties...</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/device/device.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/device/device.md b/docs/zh/edge/cordova/device/device.md
new file mode 100644
index 0000000..10d147f
--- /dev/null
+++ b/docs/zh/edge/cordova/device/device.md
@@ -0,0 +1,76 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# 设备
+
+> `device`对象描述该设备的硬件和软件。
+
+## 属性
+
+*   device.name
+*   device.cordova
+*   device.platform
+*   device.uuid
+*   device.version
+*   device.model
+
+## 变量范围
+
+因为 `device` 分配到 `window` 的对象,它是隐式地在全球范围内。
+
+    // These reference the same `device`
+    var phoneName = window.device.name;
+    var phoneName = device.name;
+    
+
+## 访问功能
+
+从 3.0 版,科尔多瓦作为*插件*实现了设备级 Api。 使用 CLI 的 `plugin` 命令,描述在命令行界面,可以添加或删除一个项目,为此功能:
+
+        $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
+        $ cordova plugin rm org.apache.cordova.core.device
+    
+
+这些命令适用于所有有针对性的平台,但修改如下所述的特定于平台的配置设置:
+
+*   Android 系统
+    
+        (in app/res/xml/config.xml) < 功能名称 ="设备">< 参数名称 ="android 包"value="org.apache.cordova.Device"/ >< / 功能 > (在 app/AndroidManifest.xml) < 使用权限 android:name="android.permission.READ_PHONE_STATE"/ >
+        
+
+*   黑莓手机 WebWorks
+    
+        (in www/plugins.xml) < 功能名称 ="设备">< 参数名称 ="黑莓手机-包"value="org.apache.cordova.device.Device"/ >< / 功能 > (在 www/config.xml) < 功能 id="blackberry.app"所需 ="true"版本 ="1.0.0.0"/ >< rim: 权限 >< rim: 许可证 > read_device_identifying_information < / rim: 许可证 >< / rim: 权限 >
+        
+
+*   (在 Windows Phone`Properties/WPAppManifest.xml`)
+    
+        < 功能 >< 功能名称 ="ID_CAP_WEBBROWSERCOMPONENT"/ >< 功能名称 ="ID_CAP_IDENTITY_DEVICE"/ >< 功能名称 ="ID_CAP_IDENTITY_USER"/ >< / 功能 >
+        
+    
+    引用:[为 Windows Phone 应用程序清单][1]
+
+*   (在 Tizen`config.xml`)
+    
+        < 功能名称 = 所需的"http://tizen.org/api/systeminfo"="true"/ >
+        
+    
+    引用: [Tizen Web 应用程序的应用程序清单][2]
+
+ [1]: http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx
+ [2]: https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures
+
+一些平台可能支持此功能,而无需任何特殊的配置。有关概述,请参见平台支持。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/device/device.model.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/device/device.model.md b/docs/zh/edge/cordova/device/device.model.md
new file mode 100644
index 0000000..3ce6861
--- /dev/null
+++ b/docs/zh/edge/cordova/device/device.model.md
@@ -0,0 +1,89 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# device.model
+
+获取设备的模型名称。
+
+    var string = device.model;
+    
+
+## 说明
+
+`device.model`返回设备的模型或产品的名称。值由设备制造商设置和同一产品的不同版本可能不同。
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    / / Android: Nexus 返回"激情"(Nexus One 代码名称) / / 摩托罗拉 Droid 返回"田鼠"/ / 黑莓手机: 火炬 9800 返回"9800"/ / iOS: 迷你 ipad,返回与 iPad2,5 ;iPhone 5 是 iPhone 5,1。 请参阅 http://theiphonewiki.com/wiki/index.php?title=Models / / var 模型 = device.model ;
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Device Properties Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' +
+                                'Device Cordova: '  + device.cordova  + '<br />' +
+                                'Device Platform: ' + device.platform + '<br />' +
+                                'Device UUID: '     + device.uuid     + '<br />' +
+                                'Device Model: '    + device.model    + '<br />' +
+                                'Device Version: '  + device.version  + '<br />';
+        }
+    
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Loading device properties...</p>
+      </body>
+    </html>
+    
+
+## Android 的怪癖
+
+*   获取[产品名称][1]而不是[产品型号名称][2],这往往是生产代码名称。 例如,Nexus One 返回 `Passion` ,和摩托罗拉 Droid 返回`voles`.
+
+ [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
+ [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
+
+## Tizen 怪癖
+
+*   例如,返回与供应商指派的设备模型`TIZEN`
+
+## Windows Phone 7 和 8 怪癖
+
+*   返回由制造商指定的设备模型。例如,三星焦点返回`SGH-i917`.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/device/device.name.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/device/device.name.md b/docs/zh/edge/cordova/device/device.name.md
new file mode 100644
index 0000000..e9eaf0b
--- /dev/null
+++ b/docs/zh/edge/cordova/device/device.name.md
@@ -0,0 +1,96 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+    
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+    
+
+   under the License.
+---
+
+# device.name
+
+**WARNING:** `device.name` is deprecated as of version 2.3.0. Use `device.model` instead.
+
+获取设备的模型名称。
+
+    var string = device.name;
+    
+
+## 说明
+
+`device.name`返回设备的模型或产品的名称。此值由设备制造商设置的并且可能不同,同一产品的不同版本。
+
+## 支持的平台
+
+*   Android 系统
+*   黑莓手机 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    // Android:    Nexus One       returns "Passion" (Nexus One code name)
+    //             Motorola Droid  returns "voles"
+    // BlackBerry: Torch 9800      returns "9800"
+    // iOS:     All devices     returns either "iPhone", "iPod Touch", "iPhone Simulator", "iPad", "iPad Simulator"
+    //
+    var name = device.name;
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Device Properties Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' +
+                                'Device Cordova: '  + device.cordova  + '<br />' +
+                                'Device Platform: ' + device.platform + '<br />' +
+                                'Device UUID: '     + device.uuid     + '<br />' +
+                                'Device Model: '    + device.model    + '<br />' +
+                                'Device Version: '  + device.version  + '<br />';
+        }
+    
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Loading device properties...</p>
+      </body>
+    </html>
+    
+
+## Android 的怪癖
+
+*   获取[产品名称][1]而不是[产品型号名称][2],这往往是生产代码名称。 例如,Nexus One 返回 `Passion` ,和摩托罗拉 Droid 返回`voles`.
+
+ [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
+ [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
+
+## Windows Phone 7 和 8 怪癖
+
+*   返回由制造商指定的设备模型。例如,三星焦点返回`SGH-i917`.
+
+## Tizen 怪癖
+
+*   例如,返回与供应商指派的设备模型`TIZEN`
\ No newline at end of file