[46/51] [partial] docs commit: Adding both Chinese versions.

[dblotsky]

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/fileerror/fileerror.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/fileerror/fileerror.md 
b/www/docs/zh-cn/3.1.0/cordova/file/fileerror/fileerror.md
new file mode 100644
index 0000000..3b9312e
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/fileerror/fileerror.md
@@ -0,0 +1,48 @@
+---
+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.
+
+title: FileError
+---
+
+# FileError
+
+A `FileError` 物件時出現錯誤在檔 API 方法中的任何設置。
+
+## 屬性
+
+*   **代碼**： 下面列出的預定義的錯誤代碼之一。
+
+## 常量
+
+*   `FileError.NOT_FOUND_ERR`
+*   `FileError.SECURITY_ERR`
+*   `FileError.ABORT_ERR`
+*   `FileError.NOT_READABLE_ERR`
+*   `FileError.ENCODING_ERR`
+*   `FileError.NO_MODIFICATION_ALLOWED_ERR`
+*   `FileError.INVALID_STATE_ERR`
+*   `FileError.SYNTAX_ERR`
+*   `FileError.INVALID_MODIFICATION_ERR`
+*   `FileError.QUOTA_EXCEEDED_ERR`
+*   `FileError.TYPE_MISMATCH_ERR`
+*   `FileError.PATH_EXISTS_ERR`
+
+## 說明
+
+`FileError`物件是提供給任何檔 API 錯誤回檔的唯一參數。 
若要確定錯誤的類型，比較其 `code` 
屬性設置為任何上述的節目表。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/fileobj/fileobj.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/fileobj/fileobj.md 
b/www/docs/zh-cn/3.1.0/cordova/file/fileobj/fileobj.md
new file mode 100644
index 0000000..37801de
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/fileobj/fileobj.md
@@ -0,0 +1,82 @@
+---
+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.
+
+title: 檔
+---
+
+# 檔
+
+此物件包含的單個檔的屬性。
+
+## 屬性
+
+*   **名稱**： 檔的名稱。*() DOMString*
+
+*   **完整路徑**： 包括檔案名的檔的完整路徑。*() DOMString*
+
+*   **類型**： 檔的 mime 類型。*() DOMString*
+
+*   **lastModifiedDate**： 上次修改該檔的時間。*（日期）*
+
+*   **大小**： 以位元組為單位的檔案大小。*(長)*
+
+## 方法
+
+*   **切片**: 僅選擇了部分要讀取的檔。
+
+## 詳細資訊
+
+`File`物件包含單個檔的屬性。您可以獲取的實例 `File` 
物件通過調用 `[FileEntry](../fileentry/fileentry.html)` 物件的 
`file()` 方法。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 切片
+
+返回一個新的 `File` 物件，為其 
`[FileReader](../filereader/filereader.html)` 
返回只有該檔的指定的部分。 負值設置為 `start` 或 `end` 
測量從檔的末尾。 相對於當前切片定位的索引。 
（請參閱下面的完整示例）。
+
+**參數：**
+
+*   **開始**： 要閱讀，具有包容性的第一個位元組的索引。
+
+*   **結束**: 後最後一個要讀取的位元組的索引。
+
+**快速的示例**
+
+    var slicedFile = file.slice(10, 30);
+    
+
+**完整的示例**
+
+    var slice1 = file.slice(100, 400);
+    var slice2 = slice1.slice(20, 35);
+    
+    var slice3 = file.slice(120, 135);
+    // slice2 and slice3 are equivalent.
+    
+
+**支援的平臺**
+
+*   Android 系統
+*   iOS
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/filereader/filereader.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/filereader/filereader.md 
b/www/docs/zh-cn/3.1.0/cordova/file/filereader/filereader.md
new file mode 100644
index 0000000..c188ef1
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/filereader/filereader.md
@@ -0,0 +1,259 @@
+---
+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.
+
+title: FileReader
+---
+
+# FileReader
+
+`FileReader`允許基本檔的存取權限。
+
+## 屬性
+
+*   **readyState**： 一個讀者的三個可能的狀態，要麼 `EMPTY` 
， `LOADING` 或`DONE`.
+
+*   **結果**： 已讀取檔的內容。*() DOMString*
+
+*   **錯誤**： 包含錯誤的物件。*() FileError*
+
+*   **onloadstart**: 讀取啟動時調用。*（函數）*
+
+*   **onload**： 讀取已成功完成時調用。*（函數）*
+
+*   **onabort**： 當已中止，讀取時調用。例如，通過調用 
`abort()` 方法。*（函數）*
+
+*   **onerror**: 當讀取已失敗時調用。*（函數）*
+
+*   **onloadend**： 當請求已完成 （無論成功或失敗） 
時調用。*（函數）*
+
+**注：**以下產權不受支援：
+
+*   **onprogress**: 讀取該檔，報告進度的角度時稱為 
`progress.loaded` / `progress.total` 。*（函數）*
+
+## 方法
+
+*   **中止**: 中止讀取檔。
+
+*   **readAsDataURL**: 讀取檔並返回資料作為 base64 
編碼的資料的 URL。
+
+*   **readAsText**： 檔中讀取文本。
+
+*   **readAsBinaryString**: 
讀取檔為二進位檔案，並返回一個二進位字串。
+
+*   **readAsArrayBuffer**: 讀取檔作為`ArrayBuffer`.
+
+## 詳細資訊
+
+`FileReader`物件提供的方法來從該設備的檔案系統中讀取檔。 
可以讀取檔，作為文本或 base64 編碼的資料的字串。 
事件攔截器接收 `loadstart` ， `progress` ， `load` ， `loadend` ， 
`error` ，和 `abort` 的事件。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## readAsDataURL
+
+**參數：**
+
+*   **檔**： 要讀取的檔物件。
+
+## 快速的示例
+
+    function win(file) {
+        var reader = new FileReader();
+        reader.onloadend = function (evt) {
+            console.log("read success");
+            console.log(evt.target.result);
+        };
+        reader.readAsDataURL(file);
+    };
+    
+    var fail = function (error) {
+        console.log(error.code);
+    };
+    
+    entry.file(win, fail);
+    
+
+## readAsText
+
+**參數：**
+
+*   **檔**： 要讀取的檔物件。
+
+*   **編碼**： 使用編碼的檔內容的編碼。預設值為 UTF8。
+
+## 快速的示例
+
+    function win(file) {
+        var reader = new FileReader();
+        reader.onloadend = function (evt) {
+            console.log("read success");
+            console.log(evt.target.result);
+        };
+        reader.readAsText(file);
+    };
+    
+    var fail = function (error) {
+        console.log(error.code);
+    };
+    
+    entry.file(win, fail);
+    
+
+## 中止
+
+    function win(file) {
+        var reader = new FileReader();
+        reader.onloadend = function(evt) {
+            console.log("read success");
+            console.log(evt.target.result);
+        };
+        reader.readAsText(file);
+        reader.abort();
+    };
+    
+    function fail(error) {
+        console.log(error.code);
+    }
+    
+    entry.file(win, fail);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>FileReader 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() {
+            window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, gotFS, 
fail);
+        }
+    
+        function gotFS(fileSystem) {
+            fileSystem.root.getFile("readme.txt", null, gotFileEntry, fail);
+        }
+    
+        function gotFileEntry(fileEntry) {
+            fileEntry.file(gotFile, fail);
+        }
+    
+        function gotFile(file){
+            readDataUrl(file);
+            readAsText(file);
+        }
+    
+        function readDataUrl(file) {
+            var reader = new FileReader();
+            reader.onloadend = function(evt) {
+                console.log("Read as data URL");
+                console.log(evt.target.result);
+            };
+            reader.readAsDataURL(file);
+        }
+    
+        function readAsText(file) {
+            var reader = new FileReader();
+            reader.onloadend = function(evt) {
+                console.log("Read as text");
+                console.log(evt.target.result);
+            };
+            reader.readAsText(file);
+        }
+    
+        function fail(error) {
+            console.log(error.code);
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Read File</p>
+      </body>
+    </html>
+    
+
+## iOS 的怪癖
+
+*   **編碼**參數不受支援，並且 UTF8 編碼總是在效果。
+
+## readAsBinaryString
+
+目前僅支援 iOS 和 android 系統。
+
+**參數：**
+
+*   **檔**： 要讀取的檔物件。
+
+## 快速的示例
+
+    function win(file) {
+        var reader = new FileReader();
+        reader.onloadend = function (evt) {
+            console.log("read success");
+            console.log(evt.target.result);
+        };
+        reader.readAsBinaryString(file);
+    };
+    
+    var fail = function (error) {
+        console.log(error.code);
+    };
+    
+    entry.file(win, fail);
+    
+
+## readAsArrayBuffer
+
+目前僅支援 iOS 和 android 系統。
+
+**參數：**
+
+*   **檔**： 要讀取的檔物件。
+
+## 快速的示例
+
+    function win(file) {
+        var reader = new FileReader();
+        reader.onloadend = function (evt) {
+            console.log("read success");
+            console.log(new Uint8Array(evt.target.result));
+        };
+        reader.readAsArrayBuffer(file);
+    };
+    
+    var fail = function (error) {
+        console.log(error.code);
+    };
+    
+    entry.file(win, fail);
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/filesystem/filesystem.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/filesystem/filesystem.md 
b/www/docs/zh-cn/3.1.0/cordova/file/filesystem/filesystem.md
new file mode 100644
index 0000000..bbcb7f9
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/filesystem/filesystem.md
@@ -0,0 +1,91 @@
+---
+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.
+
+title: 檔案系統
+---
+
+# 檔案系統
+
+此物件表示一個檔案系統。
+
+## 屬性
+
+*   **名稱**： 檔案系統的名稱。*() DOMString*
+
+*   **根**： 檔案系統的根目錄。*() DirectoryEntry*
+
+## 詳細資訊
+
+`FileSystem`物件表示檔案系統的資訊。 檔案系統的名稱的å…
¬é–‹çš„檔案系統的清單中是唯一的。 根屬性包含 `DirectoryEntry` 
物件，表示檔案系統的根目錄。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 檔案系統快速示例
+
+    function onSuccess(fileSystem) {
+        console.log(fileSystem.name);
+        console.log(fileSystem.root.name);
+    }
+    
+    // request the persistent file system
+    window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onSuccess, null);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>File System 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() {
+            window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, 
onFileSystemSuccess, fail);
+        }
+    
+        function onFileSystemSuccess(fileSystem) {
+            console.log(fileSystem.name);
+            console.log(fileSystem.root.name);
+        }
+    
+        function fail(evt) {
+            console.log(evt.target.error.code);
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>File System</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/filetransfer/filetransfer.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/filetransfer/filetransfer.md 
b/www/docs/zh-cn/3.1.0/cordova/file/filetransfer/filetransfer.md
new file mode 100644
index 0000000..393e956
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/filetransfer/filetransfer.md
@@ -0,0 +1,255 @@
+---
+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.
+
+title: 檔案傳輸
+---
+
+# 檔案傳輸
+
+`FileTransfer`物件允許你上傳或下載檔案，伺服器和用戶端。
+
+## 屬性
+
+*   **onprogress**： 使用調用 `ProgressEvent` 
每當一塊新的資料傳輸。*（函數）*
+
+## 方法
+
+*   **上傳**： 將檔發送到伺服器。
+
+*   **下載**： 從伺服器上下載檔案。
+
+*   **中止**: 中止正在進行轉讓。
+
+## 詳細資訊
+
+`FileTransfer`物件提供一種方法將檔上載到遠
端伺服器使用多部分的 HTTP POST 請求。 支援 HTTP 和 HTTPS 
協定。 可以通過指定可選參數 
`[FileUploadOptions](../fileuploadoptions/fileuploadoptions.html)` 物件的 
`upload()` 方法。 上傳成功， 
`[FileUploadResult](../fileuploadresult/fileuploadresult.html)` 
物件傳遞給成功回檔。 如果發生錯誤， 
`[FileTransferError](../filetransfererror/filetransfererror.html)` 
物件傳遞到錯誤回檔。 它也是可能的 （只在 iOS 和 Android） 
從遠端伺服器下載檔案並將其保存在設備上。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 上傳
+
+**參數：**
+
+*   **檔路徑**: 設備上的檔的完整路徑。
+
+*   **伺服器**： 伺服器以接收該檔，由編碼的 URL`encodeURI()`.
+
+*   **successCallback**： 傳遞一個回檔 `Metadata` 
物件。*（函數）*
+
+*   **errorCallback**： 回檔的執行如果出現檢索錯誤 `Metadata` 
。調用與 `[FileTransferError](../filetransfererror/filetransfererror.html)` 
物件。*（函數）*
+
+*   **選項**： 檔案名稱和 mimetype 等可選參數。
+
+*   **trustAllHosts**: 可選參數，預設值為 `false` 。 如果設置為 
`true` ，它可以接受的所有安全證書。 由於 Android 
拒絕自行簽署式安全證書，這非常有用。 
不建議供生產使用。 在 Android 和 iOS 上受支援。 *(布林值)*
+
+**快速的示例**
+
+    // !! Assumes variable fileURI contains a valid URI to a text file on the 
device
+    
+    var win = function (r) {
+        console.log("Code = " + r.responseCode);
+        console.log("Response = " + r.response);
+        console.log("Sent = " + r.bytesSent);
+    }
+    
+    var fail = function (error) {
+        alert("An error has occurred: Code = " + error.code);
+        console.log("upload error source " + error.source);
+        console.log("upload error target " + error.target);
+    }
+    
+    var options = new FileUploadOptions();
+    options.fileKey = "file";
+    options.fileName = fileURI.substr(fileURI.lastIndexOf('/') + 1);
+    options.mimeType = "text/plain";
+    
+    var params = {};
+    params.value1 = "test";
+    params.value2 = "param";
+    
+    options.params = params;
+    
+    var ft = new FileTransfer();
+    ft.upload(fileURI, encodeURI("http://some.server.com/upload.php";), win, 
fail, options);
+    
+
+**完整的示例**
+
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 
"http://www.w3.org/TR/html4/strict.dtd";>
+    <html>
+    <head>
+        <title>File Transfer 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() {
+                // Retrieve image file location from specified source
+                navigator.camera.getPicture(
+                    uploadPhoto,
+                    function(message) { alert('get picture failed'); },
+                    {
+                        quality         : 50,
+                        destinationType : 
navigator.camera.DestinationType.FILE_URI,
+                        sourceType      : 
navigator.camera.PictureSourceType.PHOTOLIBRARY
+                    }
+                );
+            }
+    
+            function uploadPhoto(imageURI) {
+                var options = new FileUploadOptions();
+                options.fileKey="file";
+                options.fileName=imageURI.substr(imageURI.lastIndexOf('/')+1);
+                options.mimeType="image/jpeg";
+    
+                var params = {};
+                params.value1 = "test";
+                params.value2 = "param";
+    
+                options.params = params;
+    
+                var ft = new FileTransfer();
+                ft.upload(imageURI, 
encodeURI("http://some.server.com/upload.php";), win, fail, options);
+            }
+    
+            function win(r) {
+                console.log("Code = " + r.responseCode);
+                console.log("Response = " + r.response);
+                console.log("Sent = " + r.bytesSent);
+            }
+    
+            function fail(error) {
+                alert("An error has occurred: Code = " + error.code);
+                console.log("upload error source " + error.source);
+                console.log("upload error target " + error.target);
+            }
+    
+            </script>
+    </head>
+    <body>
+        <h1>Example</h1>
+        <p>Upload File</p>
+    </body>
+    </html>
+    
+
+**設置上傳標頭**
+
+在 Android 和 iOS 上受支援
+
+    function win(r) {
+        console.log("Code = " + r.responseCode);
+        console.log("Response = " + r.response);
+        console.log("Sent = " + r.bytesSent);
+    }
+    
+    function fail(error) {
+        alert("An error has occurred: Code = " + error.code);
+        console.log("upload error source " + error.source);
+        console.log("upload error target " + error.target);
+    }
+    
+    var uri = encodeURI("http://some.server.com/upload.php";);
+    
+    var options = new FileUploadOptions();
+    options.fileKey="file";
+    options.fileName=fileURI.substr(fileURI.lastIndexOf('/')+1);
+    options.mimeType="text/plain";
+    
+    var headers={'headerParam':'headerValue'};
+    
+    options.headers = headers;
+    
+    var ft = new FileTransfer();
+    ft.upload(fileURI, uri, win, fail, options);
+    
+
+**Android 的怪癖**
+
+設置 `chunkedMode` 選項 `false` ，防止將上載到 Nginx 
伺服器的問題。
+
+## 下載
+
+**參數：**
+
+*   **來源**： 要下載的檔，如由編碼的伺服器的 
URL`encodeURI()`.
+
+*   **目標**： 在設備上的檔的完整路徑。
+
+*   **successCallback**： 傳遞一個回檔 
`[FileEntry](../fileentry/fileentry.html)` 物件。*（函數）*
+
+*   **errorCallback**： 如果錯誤發生在檢索時將執行的回檔 
`Metadata` 。調用與 
`[FileTransferError](../filetransfererror/filetransfererror.html)` 
物件。*（函數）*
+
+*   **trustAllHosts**: 可選參數，預設值為 `false` 。 如果設置為 
`true` 然後它將接受所有安全證書。 隨著 Android 
拒絕自我簽署的安全證書，這非常有用。 
不建議供生產使用。 在 Android 和 iOS 上受支援。 *(布林值)*
+
+*   **選項**： 可選參數，目前只支援標題 （如授權 
（基本驗證） 等）。
+
+**快速的示例**
+
+    // !! 假定檔路徑是設備 var 檔案傳輸的有效路徑 = 新 
FileTransfer() ；var uri = encodeURI ("HTTP://some.server.com/download.php"） 
；fileTransfer.download (uri，檔路徑，function(entry) {console.log 
("下載完成："+ entry.fullPath） ；}，function(error) {console.log 
("下載錯誤源"+ error.source) ；console.log ("下載錯誤目標"+ 
error.target) ；console.log ("上傳錯誤代碼"+ error.code) 
；}，false，{標題： {"授權書"："基本 
dGVzdHVzZXJuYW1lOnRlc3RwYXNzd29yZA = ="}}) ；
+    
+
+## 中止
+
+中止正在進行轉讓。Onerror 回檔傳遞的錯誤代碼為 
[FileTransferError](../filetransfererror/filetransfererror.html).ABORT_ERR 的 
[FileTransferError](../filetransfererror/filetransfererror.html) 物件。
+
+**支援的平臺**
+
+*   Android 系統
+*   iOS
+
+**快速的示例**
+
+    // !! 假定變數 fileURI 包含有效的 URI 
到一個文字檔中，對設備無功贏 = function(r) {console.log 
("不應調用。");}var 失敗 = function(error) {/ / error.code = = 
FileTransferError.ABORT_ERR 警報 ("發生了一個錯誤： 代碼 ="+ 
error.code） ；console.log （"上傳錯誤源"+ error.source） 
；console.log ("上傳錯誤目標"+ error.target);}var 選項 = 新 
FileUploadOptions() 
；options.fileKey="file"；options.fileName="myphoto.jpg"；options.mimeType="image/jpeg"；var
 ft = 新 FileTransfer() ；ft.upload （fileURI、 encodeURI 
("HTTP://some.server.com/upload.php"）、 贏、 失敗、 選項） 
；ft.abort() ；
+    
+
+## onprogress
+
+每當新的資料區塊轉移與 ProgressEvent 調用。
+
+**支援的平臺**
+
+*   Android 系統
+*   iOS
+
+**示例**
+
+    fileTransfer.onprogress = function(progressEvent) {
+        if (progressEvent.lengthComputable) {
+          loadingStatus.setPercentage(progressEvent.loaded / 
progressEvent.total);
+        } else {
+          loadingStatus.increment();
+        }
+    };
+    fileTransfer.download(...); // or fileTransfer.upload(...);
+    
+
+**怪癖**-在這兩個一個 iOS，Android 上 lengthComputable 是 `false` 
使用 gzip 已編碼的下載。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/filetransfererror/filetransfererror.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/file/filetransfererror/filetransfererror.md 
b/www/docs/zh-cn/3.1.0/cordova/file/filetransfererror/filetransfererror.md
new file mode 100644
index 0000000..b626420
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/filetransfererror/filetransfererror.md
@@ -0,0 +1,46 @@
+---
+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.
+
+title: FileTransferError
+---
+
+# FileTransferError
+
+A `FileTransferError` 物件傳遞到錯誤回檔時出現錯誤。
+
+## 屬性
+
+*   **代碼**： 下面列出的預定義的錯誤代碼之一。（人數）
+
+*   **源**： 源 URI。（字串）
+
+*   **目標**： 向目標 URI。（字串）
+
+*   **HTTP_status**： HTTP 狀態碼。從 HTTP 
連接收到一個回應代碼時，此屬性才可用。（人數）
+
+## 常量
+
+*   `FileTransferError.FILE_NOT_FOUND_ERR`
+*   `FileTransferError.INVALID_URL_ERR`
+*   `FileTransferError.CONNECTION_ERR`
+*   `FileTransferError.ABORT_ERR`
+
+## 說明
+
+`FileTransferError`上傳或下載檔案時出現錯誤時，將物件傳遞到錯誤回檔。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/fileuploadoptions/fileuploadoptions.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/file/fileuploadoptions/fileuploadoptions.md 
b/www/docs/zh-cn/3.1.0/cordova/file/fileuploadoptions/fileuploadoptions.md
new file mode 100644
index 0000000..557b189
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/fileuploadoptions/fileuploadoptions.md
@@ -0,0 +1,47 @@
+---
+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.
+
+title: FileUploadOptions
+---
+
+# FileUploadOptions
+
+A `FileUploadOptions` 可以將物件傳遞給 `FileTransfer` 物件的 
`upload()` 方法，以指定上載腳本的附加參數。
+
+## 屬性
+
+*   **fileKey**： 表單元素的名稱。預設值為 `file` 。() DOMString
+
+*   **檔案名**： 
要保存在伺服器上的檔時使用的檔案名稱。預設值為 
`image.jpg` 。() DOMString
+
+*   **mimeType**： 要上傳的資料的 mime 類型。預設值為 
`image/jpeg` 。() DOMString
+
+*   **params**： 一組可選的鍵/值對中的 HTTP 
要求的傳遞。（物件）
+
+*   **chunkedMode**： 是否要分塊流式處理模式中的資料上載。é 
è¨­å€¼ç‚º `true` 。(布林值)
+
+*   **標題**： 一張地圖的標頭名稱/標é 
­å€¼ã€‚使用陣列來指定多個值。（物件）
+
+## 說明
+
+A `FileUploadOptions` 可以將物件傳遞給 `FileTransfer` 物件的 
`upload()` 方法，以指定上載腳本的附加參數。
+
+## WP7 怪癖
+
+*   **chunkedMode：**： 在 WP7 上可以忽略。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/fileuploadresult/fileuploadresult.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/file/fileuploadresult/fileuploadresult.md 
b/www/docs/zh-cn/3.1.0/cordova/file/fileuploadresult/fileuploadresult.md
new file mode 100644
index 0000000..923c562
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/fileuploadresult/fileuploadresult.md
@@ -0,0 +1,41 @@
+---
+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.
+
+title: FileUploadResult
+---
+
+# FileUploadResult
+
+A `FileUploadResult` 物件傳遞給成功回檔的 `FileTransfer` 物件的 
`upload()` 方法。
+
+## 屬性
+
+*   **位元組發送**： 作為上載的一部分發送到伺服器的位å…
ƒçµ„數。(長)
+
+*   **responseCode**： 由伺服器返回的 HTTP 回應代碼。(長)
+
+*   **回應**： 由伺服器返回的 HTTP 回應。() DOMString
+
+## 說明
+
+`FileUploadResult`通過成功回檔的返回的物件是 `FileTransfer` 
物件的 `upload()` 方法。
+
+## iOS 的怪癖
+
+*   不支援 `responseCode` 或`bytesSent`.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/filewriter/filewriter.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/filewriter/filewriter.md 
b/www/docs/zh-cn/3.1.0/cordova/file/filewriter/filewriter.md
new file mode 100644
index 0000000..2dc18ff
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/filewriter/filewriter.md
@@ -0,0 +1,236 @@
+---
+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.
+
+title: FileWriter
+---
+
+# FileWriter
+
+作為物件，它允許您創建和向檔中寫入資料。
+
+## 屬性
+
+*   **readyState**： 三種可能狀態之一，或者 `INIT` ， `WRITING` 
，或`DONE`.
+
+*   **檔案名**: 要寫入的檔的名稱。*() DOMString*
+
+*   **長度**： 要寫入的檔的長度。*(長)*
+
+*   **位置**： 當前檔指標的位置。*(長)*
+
+*   **錯誤**： 包含錯誤的物件。*() FileError*
+
+*   **onwritestart**： 當寫操作開始時調用。*（函數）*
+
+*   **onwrite**： 當請求已成功完成時調用。*（函數）*
+
+*   **onabort**： 當寫操作已中止時調用。例如，通過調用 
abort () 方法。*（函數）*
+
+*   **onerror**： 當寫操作已失敗時調用。*（函數）*
+
+*   **onwriteend**： 當請求已完成 （無論成功或失敗） 
時調用。*（函數）*
+
+下面的屬性*不*受支援：
+
+*   **onprogress**： 寫入檔，報告進度的角度時稱為 
`progress.loaded` / `progress.total` 。*（函數）*
+
+## 方法
+
+*   **中止**: 中止寫入檔。
+
+*   **尋求**： 將檔指標移到指定的位元組。
+
+*   **截斷**： 縮短至指定長度的檔。
+
+*   **寫**： 將資料寫入到該檔。
+
+## 詳細資訊
+
+`FileWriter`物件提供 utf-8 編碼檔寫入設備檔案系統的方法。 
應用程式回應 `writestart` ， `progress` ， `write` ， `writeend` ， 
`error` ，和 `abort` 的事件。
+
+每個 `FileWriter` 對應于一個檔中，資料可以被寫入許多倍。 
`FileWriter`維護的檔 `position` 和 `length` 屬性，允許到 app `seek` 
和 `write` 檔中的任意位置。 預設情況下， `FileWriter` 將寫å…
¥åˆ°æª”中，覆蓋現有資料的開始。 設置可選的 `append` 到布林 
`true` 在 `FileWriter` 的建構函式來寫入到檔的末尾。
+
+下面列出的所有平臺都支援文本資料。 正在寫å…
¥åˆ°æª”案系統之前文本編碼為 utf-8。 
一些平臺還支援可以作為 ArrayBuffer 或 Blob 
傳遞中的二進位資料。
+
+## 支援的平臺
+
+文本和二進位的支援：
+
+*   Android 系統
+*   iOS
+
+僅限文本的支援：
+
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 尋求快速的示例
+
+    function win(writer) {
+        // fast forwards file pointer to end of file
+        writer.seek(writer.length);
+    };
+    
+    var fail = function(evt) {
+        console.log(error.code);
+    };
+    
+    entry.createWriter(win, fail);
+    
+
+## 截斷快速示例
+
+    function win(writer) {
+        writer.truncate(10);
+    };
+    
+    var fail = function(evt) {
+        console.log(error.code);
+    };
+    
+    entry.createWriter(win, fail);
+    
+
+## 寫快速示例
+
+    function win(writer) {
+        writer.onwrite = function(evt) {
+            console.log("write success");
+        };
+        writer.write("some sample text");
+    };
+    
+    var fail = function(evt) {
+        console.log(error.code);
+    };
+    
+    entry.createWriter(win, fail);
+    
+
+## 二進位檔案寫入快速示例
+
+    function win(writer) {
+        var data = new ArrayBuffer(5),
+            dataView = new Int8Array(data);
+        for (i=0; i < 5; i++) {
+            dataView[i] = i;
+        }
+        writer.onwrite = function(evt) {
+            console.log("write success");
+        };
+        writer.write(data);
+    };
+    
+    var fail = function(evt) {
+        console.log(error.code);
+    };
+    
+    entry.createWriter(win, fail);
+    
+
+## 追加快速示例
+
+    function win(writer) {
+        writer.onwrite = function(evt) {
+        console.log("write success");
+    };
+    writer.seek(writer.length);
+        writer.write("appended text");
+    };
+    
+    var fail = function(evt) {
+        console.log(error.code);
+    };
+    
+    entry.createWriter(win, fail);
+    
+
+## 中止快速示例
+
+    function win(writer) {
+        writer.onwrite = function(evt) {
+            console.log("write success");
+        };
+        writer.write("some sample text");
+        writer.abort();
+    };
+    
+    var fail = function(evt) {
+        console.log(error.code);
+    };
+    
+    entry.createWriter(win, fail);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>FileWriter 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() {
+            window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, gotFS, 
fail);
+        }
+    
+        function gotFS(fileSystem) {
+            fileSystem.root.getFile("readme.txt", {create: true, exclusive: 
false}, gotFileEntry, fail);
+        }
+    
+        function gotFileEntry(fileEntry) {
+            fileEntry.createWriter(gotFileWriter, fail);
+        }
+    
+        function gotFileWriter(writer) {
+            writer.onwriteend = function(evt) {
+                console.log("contents of file now 'some sample text'");
+                writer.truncate(11);
+                writer.onwriteend = function(evt) {
+                    console.log("contents of file now 'some sample'");
+                    writer.seek(4);
+                    writer.write(" different text");
+                    writer.onwriteend = function(evt){
+                        console.log("contents of file now 'some different 
text'");
+                    }
+                };
+            };
+            writer.write("some sample text");
+        }
+    
+        function fail(error) {
+            console.log(error.code);
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Write File</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/flags/flags.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/flags/flags.md 
b/www/docs/zh-cn/3.1.0/cordova/file/flags/flags.md
new file mode 100644
index 0000000..694ed72
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/flags/flags.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.
+
+title: 標誌
+---
+
+# 標誌
+
+提供的參數 `DirectoryEntry` 物件的 `getFile()` 和 `getDirectory()` 
方法，查找或創建的檔和目錄，分別。
+
+## 屬性
+
+*   **創建**： 
指示應創建的檔或目錄，是否它不存在。*（布林）*
+
+*   **獨家**: 已由本身，但與一起使用時不起任何作用 
`create` 
導致檔或目錄的創建，如果已經存在的目標路徑失敗。*（布林）*
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    / / 獲取資料目錄，如果它不存在，則創建它。
+    dataDir = fileSystem.root.getDirectory （"資料"，{創建: true});/ / 
創建鎖定檔，當且僅當它不存在。
+    備份的鎖定檔 = dataDir.getFile ("lockfile.txt"，{創建: 真實、 
獨家： true}) ；
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/localfilesystem/localfilesystem.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/file/localfilesystem/localfilesystem.md 
b/www/docs/zh-cn/3.1.0/cordova/file/localfilesystem/localfilesystem.md
new file mode 100644
index 0000000..a55d13a
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/localfilesystem/localfilesystem.md
@@ -0,0 +1,132 @@
+---
+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.
+
+title: 場合
+---
+
+# 場合
+
+此物件提供一個獲取根檔案系統方法。
+
+## 方法
+
+*   **requestFileSystem**: 請求的檔案系統。*（函數）*
+
+*   **resolveLocalFileSystemURI**: 檢索 `DirectoryEntry` 或 
`[FileEntry](../fileentry/fileentry.html)` 使用當地的 URI。*（函數）*
+
+## 常量
+
+*   `LocalFileSystem.PERSISTENT`： 用於存儲，不應由使用者
代理不應用程式或使用者的許可權的情況下刪除。
+
+*   `LocalFileSystem.TEMPORARY`： 用於不能保證的持久性存儲。
+
+## 詳細資訊
+
+`LocalFileSystem`物件的方法定義在 `window` 物件。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 請求檔案系統快速示例
+
+    function onSuccess(fileSystem) {
+        console.log(fileSystem.name);
+    }
+    
+    // request the persistent file system
+    window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onSuccess, 
onError);
+    
+
+## 解決本地檔案系統的 URI 快速示例
+
+    function onSuccess(fileEntry) {
+        console.log(fileEntry.name);
+    }
+    
+    window.resolveLocalFileSystemURI("file:///example.txt", onSuccess, 
onError);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Local File System 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() {
+            window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, 
onFileSystemSuccess, fail);
+            window.resolveLocalFileSystemURI("file:///example.txt", 
onResolveSuccess, fail);
+        }
+    
+        function onFileSystemSuccess(fileSystem) {
+            console.log(fileSystem.name);
+        }
+    
+        function onResolveSuccess(fileEntry) {
+            console.log(fileEntry.name);
+        }
+    
+        function fail(evt) {
+            console.log(evt.target.error.code);
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Local File System</p>
+      </body>
+    </html>
+    
+
+# requestFileSystem
+
+> 請求一個檔案系統，用來存儲應用程式資料。
+
+     window.requestFileSystem(type, size, successCallback, errorCallback)
+    
+
+*   **視窗**： 對全球視窗物件的引用
+*   **類型**： 本地檔案系統類型，請參見場合常數
+*   **大小**： 指示應用程式期望需要多少存儲空間，以位å…
ƒçµ„為單位，
+*   **successCallback**： 使用一個檔案系統物件調用
+*   **errorCallback**： 如果發生錯誤的檢索檔案系統調用
+
+## 請求檔案系統快速示例
+
+    function onSuccess(fileSystem) {
+        console.log(fileSystem.name);
+    }
+    
+    // request the persistent file system
+    window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onSuccess, 
onError);
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/metadata/metadata.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/metadata/metadata.md 
b/www/docs/zh-cn/3.1.0/cordova/file/metadata/metadata.md
new file mode 100644
index 0000000..80f5e1e
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/metadata/metadata.md
@@ -0,0 +1,50 @@
+---
+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.
+
+title: 中繼資料
+---
+
+# 中繼資料
+
+供應狀態資訊的檔或目錄的一個介面。
+
+## 屬性
+
+*   **modificationTime**： 
當檔或目錄被最後修改的時間。*（日期）*
+
+## 詳細資訊
+
+`Metadata`物件表示檔或目錄的狀態資訊。 調用 `DirectoryEntry` 
或 `[FileEntry](../fileentry/fileentry.html)` 物件的 `getMetadata()` 
方法將產生 `Metadata` 實例。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    function win(metadata) {
+        console.log("Last Modified: " + metadata.modificationTime);
+    }
+    
+    // Request the metadata object for this entry
+    entry.getMetadata(win, null);
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/Coordinates/coordinates.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/geolocation/Coordinates/coordinates.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/Coordinates/coordinates.md
new file mode 100644
index 0000000..cde04fd
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/Coordinates/coordinates.md
@@ -0,0 +1,129 @@
+---
+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.
+
+title: 座標
+---
+
+# 座標
+
+描述位置的地理座標的屬性集。
+
+## 屬性
+
+*   **緯度**： 緯度以十進位度為單位。*（人數）*
+
+*   **經度**: 經度以十進位度為單位。*（人數）*
+
+*   **海拔高度**： 
高度在米以上橢球體中的位置。*（人數）*
+
+*   **準確性**： 
中米的緯度和經度座標的精度級別。*（人數）*
+
+*   **altitudeAccuracy**： 
在米的海拔高度座標的精度級別。*（人數）*
+
+*   **標題**： 旅行，指定以度為單位元數目相對於真北é 
†æ™‚針方向。*（人數）*
+
+*   **速度**： 
當前地面速度的設備，指定在米每秒。*（人數）*
+
+## 說明
+
+`Coordinates`物件附加到 `Position` 
物件，可用於在當前職位的請求中的回呼函數。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    // onSuccess Callback
+    //
+    var onSuccess = function(position) {
+        alert('Latitude: '          + position.coords.latitude          + '\n' 
+
+              'Longitude: '         + position.coords.longitude         + '\n' 
+
+              'Altitude: '          + position.coords.altitude          + '\n' 
+
+              'Accuracy: '          + position.coords.accuracy          + '\n' 
+
+              'Altitude Accuracy: ' + position.coords.altitudeAccuracy  + '\n' 
+
+              'Heading: '           + position.coords.heading           + '\n' 
+
+              'Speed: '             + position.coords.speed             + '\n' 
+
+              'Timestamp: '         + position.timestamp                + 
'\n');
+    };
+    
+    // onError Callback
+    //
+    var onError = function() {
+        alert('onError!');
+    };
+    
+    navigator.geolocation.getCurrentPosition(onSuccess, onError);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Geolocation Position 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() {
+            navigator.geolocation.getCurrentPosition(onSuccess, onError);
+        }
+    
+        // Display `Position` properties from the geolocation
+        //
+        function onSuccess(position) {
+            var div = document.getElementById('myDiv');
+    
+            div.innerHTML = 'Latitude: '             + 
position.coords.latitude         + '<br/>' +
+                            'Longitude: '            + 
position.coords.longitude        + '<br/>' +
+                            'Altitude: '             + 
position.coords.altitude         + '<br/>' +
+                            'Accuracy: '             + 
position.coords.accuracy         + '<br/>' +
+                            'Altitude Accuracy: '    + 
position.coords.altitudeAccuracy + '<br/>' +
+                            'Heading: '              + position.coords.heading 
         + '<br/>' +
+                            'Speed: '                + position.coords.speed   
         + '<br/>';
+        }
+    
+        // Show an alert if there is a problem getting the geolocation
+        //
+        function onError() {
+            alert('onError!');
+        }
+    
+        </script>
+      </head>
+      <body>
+        <div id="myDiv"></div>
+      </body>
+    </html>
+    
+
+## Android 的怪癖
+
+**altitudeAccuracy**: 不支援的 Android 設備，返回`null`.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/Position/position.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/geolocation/Position/position.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/Position/position.md
new file mode 100644
index 0000000..4a22f51
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/Position/position.md
@@ -0,0 +1,117 @@
+---
+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.
+
+title: 位置
+---
+
+# 位置
+
+包含 `Position` 座標和時間戳記，由地理位置 API 創建。
+
+## 屬性
+
+*   **coords**： 一組的地理座標。*（座標）*
+
+*   **時間戳記**： 創建時間戳記為 `coords` 。*（日期）*
+
+## 說明
+
+`Position`創建和填充的科爾多瓦，並返回到使用者
通過一個回呼函數物件。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    // onSuccess Callback
+    //
+    var onSuccess = function(position) {
+        alert('Latitude: '          + position.coords.latitude          + '\n' 
+
+              'Longitude: '         + position.coords.longitude         + '\n' 
+
+              'Altitude: '          + position.coords.altitude          + '\n' 
+
+              'Accuracy: '          + position.coords.accuracy          + '\n' 
+
+              'Altitude Accuracy: ' + position.coords.altitudeAccuracy  + '\n' 
+
+              'Heading: '           + position.coords.heading           + '\n' 
+
+              'Speed: '             + position.coords.speed             + '\n' 
+
+              'Timestamp: '         + position.timestamp                + 
'\n');
+    };
+    
+    // onError Callback receives a PositionError object
+    //
+    function onError(error) {
+        alert('code: '    + error.code    + '\n' +
+              'message: ' + error.message + '\n');
+    }
+    
+    navigator.geolocation.getCurrentPosition(onSuccess, onError);
+    
+
+## 完整的示例
+
+    <!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() {
+            navigator.geolocation.getCurrentPosition(onSuccess, onError);
+        }
+    
+        // onSuccess Geolocation
+        //
+        function onSuccess(position) {
+            var element = document.getElementById('geolocation');
+            element.innerHTML = 'Latitude: '          + 
position.coords.latitude         + '<br />' +
+                                'Longitude: '         + 
position.coords.longitude        + '<br />' +
+                                'Altitude: '          + 
position.coords.altitude         + '<br />' +
+                                'Accuracy: '          + 
position.coords.accuracy         + '<br />' +
+                                'Altitude Accuracy: ' + 
position.coords.altitudeAccuracy + '<br />' +
+                                'Heading: '           + 
position.coords.heading          + '<br />' +
+                                'Speed: '             + position.coords.speed  
          + '<br />' +
+                                'Timestamp: '         + position.timestamp     
          + '<br />';
+        }
+    
+            // onError Callback receives a PositionError object
+            //
+            function onError(error) {
+                alert('code: '    + error.code    + '\n' +
+                      'message: ' + error.message + '\n');
+            }
+    
+        </script>
+      </head>
+      <body>
+        <p id="geolocation">Finding geolocation...</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/PositionError/positionError.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/geolocation/PositionError/positionError.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/PositionError/positionError.md
new file mode 100644
index 0000000..aabda22
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/PositionError/positionError.md
@@ -0,0 +1,53 @@
+---
+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.
+
+title: PositionError
+---
+
+# PositionError
+
+A `PositionError` 物件傳遞給 
`[geolocationError](../parameters/geolocationError.html)` 
回檔時出現錯誤。
+
+## 屬性
+
+*   **代碼**： 下面列出的預定義的錯誤代碼之一。
+
+*   **消息**： 描述所遇到的錯誤的詳細資訊的錯誤訊息。
+
+## 常量
+
+*   `PositionError.PERMISSION_DENIED`
+*   `PositionError.POSITION_UNAVAILABLE`
+*   `PositionError.TIMEOUT`
+
+## 說明
+
+`PositionError`物件傳遞給 
`[geolocationError](../parameters/geolocationError.html)` 
與地理定位發生錯誤時的回呼函數。
+
+### `PositionError.PERMISSION_DENIED`
+
+返回當使用者不å…
è¨±æ‚¨çš„應用程式檢索的位置資訊。這是取決於平臺。
+
+### `PositionError.POSITION_UNAVAILABLE`
+
+返回設備時，不能檢索的位置。這就意味著該設備沒有網路連接和/或不能得到衛星的修復。
+
+### `PositionError.TIMEOUT`
+
+返回設備時，無法在指定的時間內檢索位置 
`[geolocationOptions](../parameters/geolocation.options.html)` ' `timeout` 
屬性。 與一起使用時 
`[geolocation.watchPosition](../geolocation.watchPosition.html)` 
，此錯誤可能傳遞給 
`[geolocationError](../parameters/geolocationError.html)` 回檔每 `timeout` 
毫秒為單位）。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.clearWatch.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.clearWatch.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.clearWatch.md
new file mode 100644
index 0000000..6bf1104
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.clearWatch.md
@@ -0,0 +1,114 @@
+---
+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.
+
+title: geolocation.clearWatch
+---
+
+# geolocation.clearWatch
+
+再看對所引用的設備的位置更改為 `watchID` 參數。
+
+    navigator.geolocation.clearWatch(watchID);
+    
+
+## 參數
+
+*   **watchID**： 的 id `watchPosition` 清除的時間間隔。（字串）
+
+## 說明
+
+`geolocation.clearWatch`將停止觀看對設備的位置的更改通過清除 
`[geolocation.watchPosition](geolocation.watchPosition.html)` 
引用的`watchID`.
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    / / 選項： 監視的更改的位置，並使用最 / / 
準確定位採集方法可用。
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { 
enableHighAccuracy: true });
+    
+    // ...later on...
+    
+    navigator.geolocation.clearWatch(watchID);
+    
+
+## 完整的示例
+
+    <!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);
+    
+        var watchID = null;
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Get the most accurate position updates available on the
+            // device.
+            var options = { enableHighAccuracy: true };
+            watchID = navigator.geolocation.watchPosition(onSuccess, onError, 
options);
+        }
+    
+        // onSuccess Geolocation
+        //
+        function onSuccess(position) {
+            var element = document.getElementById('geolocation');
+            element.innerHTML = 'Latitude: '  + position.coords.latitude      
+ '<br />' +
+                                'Longitude: ' + position.coords.longitude     
+ '<br />' +
+                                '<hr />'      + element.innerHTML;
+        }
+    
+        // clear the watch that was started earlier
+        //
+        function clearWatch() {
+            if (watchID != null) {
+                navigator.geolocation.clearWatch(watchID);
+                watchID = null;
+            }
+        }
+    
+            // onError Callback receives a PositionError object
+            //
+            function onError(error) {
+              alert('code: '    + error.code    + '\n' +
+                    'message: ' + error.message + '\n');
+            }
+    
+        </script>
+      </head>
+      <body>
+        <p id="geolocation">Watching geolocation...</p>
+            <button onclick="clearWatch();">Clear Watch</button>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.getCurrentPosition.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.getCurrentPosition.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.getCurrentPosition.md
new file mode 100644
index 0000000..d185e88
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.getCurrentPosition.md
@@ -0,0 +1,126 @@
+---
+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.
+
+title: geolocation.getCurrentPosition
+---
+
+# geolocation.getCurrentPosition
+
+返回設備的當前位置作為 `Position` 物件。
+
+    navigator.geolocation.getCurrentPosition(geolocationSuccess,
+                                             [geolocationError],
+                                             [geolocationOptions]);
+    
+
+## 參數
+
+*   **geolocationSuccess**： 傳遞當前位置的回檔。
+
+*   **geolocationError**： 
*（可選）*如果錯誤發生時執行的回檔。
+
+*   **geolocationOptions**： *（可選）*地理定位選項。
+
+## 說明
+
+`geolocation.getCurrentPosition`是一個非同步函數。 
它將返回到該設備的當前位置 
`[geolocationSuccess](parameters/geolocationSuccess.html)` 回檔與 `Position` 
物件作為參數。 如果有錯誤， 
`[geolocationError](parameters/geolocationError.html)` 回檔通過 
`[PositionError](PositionError/positionError.html)` 物件。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    // onSuccess Callback
+    // This method accepts a Position object, which contains the
+    // current GPS coordinates
+    //
+    var onSuccess = function(position) {
+        alert('Latitude: '          + position.coords.latitude          + '\n' 
+
+              'Longitude: '         + position.coords.longitude         + '\n' 
+
+              'Altitude: '          + position.coords.altitude          + '\n' 
+
+              'Accuracy: '          + position.coords.accuracy          + '\n' 
+
+              'Altitude Accuracy: ' + position.coords.altitudeAccuracy  + '\n' 
+
+              'Heading: '           + position.coords.heading           + '\n' 
+
+              'Speed: '             + position.coords.speed             + '\n' 
+
+              'Timestamp: '         + position.timestamp                + 
'\n');
+    };
+    
+    // onError Callback receives a PositionError object
+    //
+    function onError(error) {
+        alert('code: '    + error.code    + '\n' +
+              'message: ' + error.message + '\n');
+    }
+    
+    navigator.geolocation.getCurrentPosition(onSuccess, onError);
+    
+
+## 完整的示例
+
+    <!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() {
+            navigator.geolocation.getCurrentPosition(onSuccess, onError);
+        }
+    
+        // onSuccess Geolocation
+        //
+        function onSuccess(position) {
+            var element = document.getElementById('geolocation');
+            element.innerHTML = 'Latitude: '           + 
position.coords.latitude              + '<br />' +
+                                'Longitude: '          + 
position.coords.longitude             + '<br />' +
+                                'Altitude: '           + 
position.coords.altitude              + '<br />' +
+                                'Accuracy: '           + 
position.coords.accuracy              + '<br />' +
+                                'Altitude Accuracy: '  + 
position.coords.altitudeAccuracy      + '<br />' +
+                                'Heading: '            + 
position.coords.heading               + '<br />' +
+                                'Speed: '              + position.coords.speed 
                + '<br />' +
+                                'Timestamp: '          + position.timestamp    
                + '<br />';
+        }
+    
+        // onError Callback receives a PositionError object
+        //
+        function onError(error) {
+            alert('code: '    + error.code    + '\n' +
+                  'message: ' + error.message + '\n');
+        }
+    
+        </script>
+      </head>
+      <body>
+        <p id="geolocation">Finding geolocation...</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.md
new file mode 100644
index 0000000..0251933
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.md
@@ -0,0 +1,109 @@
+---
+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.
+
+title: 地理定位
+---
+
+# 地理定位
+
+> `geolocation`物件提供對基於設備的 GPS 
感應器或推斷網路信號的位置資料的訪問。
+
+`Geolocation`提供有關該設備的位置，例如緯度和經度資訊。 
常見的位置資訊來源包括全球定位系統 (GPS) 和網路信號，如 
IP 位址、 RFID、 WiFi 和藍牙 MAC 位址和 GSM/CDMA 儲存格 Id 
從推斷出的位置。 沒有任何保證，API 返回設備的實際位置。
+
+此 API 基於[W3C 地理定位 API 
規範][1]，並只執行已經不提供實現的設備上。
+
+ [1]: http://dev.w3.org/geo/api/spec-source.html
+
+**重要的隱私注：**地理定位資料的收集和使用提出了重要的隱私問題。
 
您的應用程式的隱私權原則應該討論這款應用程式如何使用地理定位資料，資料是否å
…±ç”¨å®ƒçš„任何其他締約方和的資料 （例如，粗、 細，ZIP 
代碼級別，等等） 的精度水準。 
地理定位資料被普遍認為敏感的因
為它能揭示一個人的下落，如果存儲中，他或她的旅行史。 
因此，除了您的應用程式的隱私權原則，您應強烈考æ…
®æä¾›åœ¨æ‚¨çš„應用程式訪問地理定位資料 
（如果設備作業系統不會這樣做已經） 
之前的時間只是通知。 
該通知應提供相同的資訊上文指出的並獲取該使用者
的許可權 
（例如，通過為**確定**並**不感謝**提出的選擇）。 
有關詳細資訊，請參閱隱私指南。
+
+## 方法
+
+*   [geolocation.getCurrentPosition](geolocation.getCurrentPosition.html)
+*   [geolocation.watchPosition](geolocation.watchPosition.html)
+*   [geolocation.clearWatch](geolocation.clearWatch.html)
+
+## 參數
+
+*   [geolocationSuccess](parameters/geolocationSuccess.html)
+*   [geolocationError](parameters/geolocationError.html)
+*   [geolocationOptions](parameters/geolocation.options.html)
+
+## 物件 （唯讀）
+
+*   Position
+*   [PositionError](PositionError/positionError.html)
+*   Coordinates
+
+## 訪問功能
+
+從 3.0 版，科爾多瓦作為*外掛程式*實現了設備級 Api。 使用 
CLI 的 `plugin` 命令，描述在命令列介面，可以添加
或刪除一個專案，為此功能：
+
+        $ cordova plugin add org.apache.cordova.geolocation
+        $ cordova plugin ls
+        [ 'org.apache.cordova.geolocation' ]
+        $ cordova plugin rm org.apache.cordova.geolocation
+    
+
+這些命令適用于所有有針對性的平臺，但修改如下所述的特定于平臺的é
…ç½®è¨­ç½®ï¼š
+
+*   Android 系統
+    
+        (in app/res/xml/config.xml)
+        <feature name="Geolocation">
+            <param name="android-package" value="org.apache.cordova.GeoBroker" 
/>
+        </feature>
+        
+        (in app/AndroidManifest.xml)
+        <uses-permission 
android:name="android.permission.ACCESS_COARSE_LOCATION" />
+        <uses-permission 
android:name="android.permission.ACCESS_FINE_LOCATION" />
+        <uses-permission 
android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
+        
+
+*   黑莓手機 WebWorks
+    
+        (in www/plugins.xml)
+        <feature name="Geolocation">
+            <param name="blackberry-package" 
value="org.apache.cordova.geolocation.Geolocation" />
+        </feature>
+        
+        (in www/config.xml)
+        <rim:permissions>
+            <rim:permit>read_geolocation</rim:permit>
+        </rim:permissions>
+        
+
+*   （在 iOS`config.xml`)
+    
+        <feature name="Geolocation">
+            <param name="ios-package" value="CDVLocation" />
+        </feature>
+        
+
+*   （在 Windows Phone`Properties/WPAppManifest.xml`)
+    
+        <Capabilities>
+            <Capability Name="ID_CAP_LOCATION" />
+        </Capabilities>
+        
+    
+    引用：[為 Windows Phone 應用程式清單][2]
+
+ [2]: 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/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.watchPosition.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.watchPosition.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.watchPosition.md
new file mode 100644
index 0000000..05ec411
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/geolocation.watchPosition.md
@@ -0,0 +1,127 @@
+---
+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.
+
+title: geolocation.watchPosition
+---
+
+# geolocation.watchPosition
+
+對該設備的當前的位置更改的手錶。
+
+    var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+                                                      [geolocationError],
+                                                      [geolocationOptions]);
+    
+
+## 參數
+
+*   **geolocationSuccess**： 傳遞當前位置的回檔。
+
+*   **geolocationError**： （可選） 
如果錯誤發生時執行的回檔。
+
+*   **geolocationOptions**： （可選） 地理定位選項。
+
+## 返回
+
+*   **字串**： 返回引用的觀看位置間隔的表 
id。應與一起使用的表 id 
`[geolocation.clearWatch](geolocation.clearWatch.html)` 
停止了觀看中位置的更改。
+
+## 說明
+
+`geolocation.watchPosition`是一個非同步函數。 
當檢測到位置更改時，它返回該設備的當前的位置。 
當設備中檢索一個新的位置， 
`[geolocationSuccess](parameters/geolocationSuccess.html)` 回檔執行與 
`Position` 物件作為參數。 如果有錯誤， 
`[geolocationError](parameters/geolocationError.html)` 回檔執行與 
`[PositionError](PositionError/positionError.html)` 物件作為參數。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks （OS 5.0 和更高）
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    // onSuccess Callback
+    //   This method accepts a `Position` object, which contains
+    //   the current GPS coordinates
+    //
+    function onSuccess(position) {
+        var element = document.getElementById('geolocation');
+        element.innerHTML = 'Latitude: '  + position.coords.latitude      + 
'<br />' +
+                            'Longitude: ' + position.coords.longitude     + 
'<br />' +
+                            '<hr />'      + element.innerHTML;
+    }
+    
+    // onError Callback receives a PositionError object
+    //
+    function onError(error) {
+        alert('code: '    + error.code    + '\n' +
+              'message: ' + error.message + '\n');
+    }
+    
+    // Options: throw an error if no update is received every 30 seconds.
+    //
+    var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { 
timeout: 30000 });
+    
+
+## 完整的示例
+
+    <!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);
+    
+        var watchID = null;
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Throw an error if no update is received every 30 seconds
+            var options = { timeout: 30000 };
+            watchID = navigator.geolocation.watchPosition(onSuccess, onError, 
options);
+        }
+    
+        // onSuccess Geolocation
+        //
+        function onSuccess(position) {
+            var element = document.getElementById('geolocation');
+            element.innerHTML = 'Latitude: '  + position.coords.latitude      
+ '<br />' +
+                                'Longitude: ' + position.coords.longitude     
+ '<br />' +
+                                '<hr />'      + element.innerHTML;
+        }
+    
+            // onError Callback receives a PositionError object
+            //
+            function onError(error) {
+                alert('code: '    + error.code    + '\n' +
+                      'message: ' + error.message + '\n');
+            }
+    
+        </script>
+      </head>
+      <body>
+        <p id="geolocation">Watching geolocation...</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocation.options.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocation.options.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocation.options.md
new file mode 100644
index 0000000..31cfed6
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocation.options.md
@@ -0,0 +1,40 @@
+---
+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.
+
+title: geolocationOptions
+---
+
+# geolocationOptions
+
+若要自訂的地理定位檢索的可選參數`Position`.
+
+    {maximumAge: 3000，超時： 5000，enableHighAccuracy: true} ；
+    
+
+## 選項
+
+*   **enableHighAccuracy**： 
提供應用程式需要最佳的可能結果的提示。 預設情
況下，該設備將嘗試檢索 `Position` 使用基於網路的方法。 
將此屬性設置為 `true` 
告訴要使用更精確的方法，如衛星定位的框架。 *(布林值)*
+
+*   **超時**： 時間 (毫秒) 從調用傳遞，允許的最大長度 
`[geolocation.getCurrentPosition](../geolocation.getCurrentPosition.html)` 或 
`[geolocation.watchPosition](../geolocation.watchPosition.html)` 
直到相應的 `[geolocationSuccess](geolocationSuccess.html)` 回檔執行。 
如果 `[geolocationSuccess](geolocationSuccess.html)` 不會在此時間å…
§èª¿ç”¨å›žæª” `[geolocationError](geolocationError.html)` 傳遞回檔 
`[PositionError](../PositionError/positionError.html).TIMEOUT` 錯誤代碼。 
(請注意，與一起使用時 
`[geolocation.watchPosition](../geolocation.watchPosition.html)` 、 
`[geolocationError](geolocationError.html)` 
的時間間隔可以調用回檔每 `timeout` 毫秒!)*（人數）*
+
+*   **maximumAge**： 接受å…
¶å¹´é½¡å¤§æ–¼æŒ‡å®šä»¥æ¯«ç§’為單位的時間沒有緩存的位置。*（人數）*
+
+## Android 的怪癖
+
+Android 2.x 模擬器不返回地理定位結果除非 `enableHighAccuracy` 
選項設置為`true`.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationError.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationError.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationError.md
new file mode 100644
index 0000000..d686755
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationError.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.
+
+title: geolocationError
+---
+
+# geolocationError
+
+當有地理定位功能錯誤時執行的使用者的回呼函數。
+
+    function(error) {
+        // Handle the error
+    }
+    
+
+## 參數
+
+*   **錯誤**: 設備所返回的錯誤。*() PositionError*
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationSuccess.md
----------------------------------------------------------------------
diff --git 
a/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationSuccess.md 
b/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationSuccess.md
new file mode 100644
index 0000000..61642cb
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/geolocation/parameters/geolocationSuccess.md
@@ -0,0 +1,47 @@
+---
+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.
+
+title: geolocationSuccess
+---
+
+# geolocationSuccess
+
+使用者的地理位置變得可用時執行的回呼函數 （當從調用 
`[geolocation.getCurrentPosition](../geolocation.getCurrentPosition.html)` 
），或 
（當從調用位置的更改時`[geolocation.watchPosition](../geolocation.watchPosition.html)`).
+
+    function(position) {
+        // Do something
+    }
+    
+
+## 參數
+
+*   **位置**： 返回設備的地理位置。*（位置）*
+
+## 示例
+
+    function geolocationSuccess(position) {
+        alert('Latitude: '          + position.coords.latitude          + '\n' 
+
+              'Longitude: '         + position.coords.longitude         + '\n' 
+
+              'Altitude: '          + position.coords.altitude          + '\n' 
+
+              'Accuracy: '          + position.coords.accuracy          + '\n' 
+
+              'Altitude Accuracy: ' + position.coords.altitudeAccuracy  + '\n' 
+
+              'Heading: '           + position.coords.heading           + '\n' 
+
+              'Speed: '             + position.coords.speed             + '\n' 
+
+              'Timestamp: '         + position.timestamp                + 
'\n');
+    }
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org