incubator-callback-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwbro...@apache.org
Subject [10/25] docs commit: Translate and update files related to file
Date Thu, 12 Jul 2012 21:04:38 GMT
Translate and update files related to file


Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/b6d09bf8
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/b6d09bf8
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/b6d09bf8

Branch: refs/heads/master
Commit: b6d09bf890a7570e5ef50d10561634b8500e7439
Parents: 022cf30
Author: Keiko Oda <keiko713@gmail.com>
Authored: Tue Jul 10 01:58:30 2012 -0700
Committer: Keiko Oda <keiko713@gmail.com>
Committed: Wed Jul 11 17:33:15 2012 -0700

----------------------------------------------------------------------
 .../cordova/file/directoryentry/directoryentry.md  |   49 +++++++++++---
 docs/jp/1.8.1/cordova/file/file.md                 |   54 +++++++++++++++
 docs/jp/1.8.1/cordova/file/fileentry/fileentry.md  |   48 +++++++++++--
 .../jp/1.8.1/cordova/file/filereader/filereader.md |    2 +-
 .../cordova/file/filetransfer/filetransfer.md      |    2 +-
 .../file/filetransfererror/filetransfererror.md    |    1 +
 .../jp/1.8.1/cordova/file/filewriter/filewriter.md |    2 +-
 .../file/localfilesystem/localfilesystem.md        |    2 +-
 8 files changed, 139 insertions(+), 21 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/directoryentry/directoryentry.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/directoryentry/directoryentry.md b/docs/jp/1.8.1/cordova/file/directoryentry/directoryentry.md
index 08510b7..5292f32 100644
--- a/docs/jp/1.8.1/cordova/file/directoryentry/directoryentry.md
+++ b/docs/jp/1.8.1/cordova/file/directoryentry/directoryentry.md
@@ -40,12 +40,13 @@ DirectoryEntry
 以下のメソッドは DirectoryEntry オブジェクトから呼び出すことができます:
 
 - __getMetadata__: ディレクトリのメタデータを取得します
+- __setMetadata__: ディレクトリのメタデータをセットします
 - __moveTo__: ディレクトリを、ファイルシステム内の別の場所に移動します
 - __copyTo__: ディレクトリを、ファイルシステム内の別の場所にコピーします
-- __toURI__: ディレクトリの位置特定に使用できる URI を返します
+- __toURL__: ディレクトリの位置特定に使用できる URL を返します
 - __remove__: ディレクトリを削除します。ディレクトリは空である必要があります
 - __getParent__: 親ディレクトリを取得します
-- __getParent__: ディレクトリからエントリを読み込みできる DirectoryReader
を作成します
+- __createReader__: ディレクトリからエントリを読み込みできる DirectoryReader
を作成します
 - __getDirectory__: ディレクトリを取得または作成します
 - __getFile__: ファイルを取得または作成します
 - __removeRecursively__: ディレクトリと、その中身をすべて削除します
@@ -83,6 +84,34 @@ __使用例__
     // このエントリーの Metadata オブジェクトを取得
     entry.getMetadata(success, fail);
 
+setMetadata
+----------------
+
+ディレクトリのメタデータをセットします。
+**現在 iOS のみ対応しています** - ディレクトリの拡張属性をセットします。
+
+__パラメーター:__
+
+- __successCallback__ - Metadata が正常にセットされたときに呼び出されるコールバック関数を表します
_(Function)_
+- __errorCallback__ - Metadata のセット時にエラーが起きた場合に呼び出されるコールバック関数を表します
_(Function)_
+- __metadataObject__ - Metadata のキーと値が格納されているオブジェクトを表します
_(Object)_
+
+
+__使用例__
+
+    function success() {
+        console.log("メタデータが正常にセットされました。");
+    }
+
+    function fail() {
+        alert("メタデータ作成中にエラーが発生しました。");
+    }
+
+    // メタデータをセット
+    entry.setMetadata(success, fail, { "com.apple.MobileBackup": 1});
+__iOS に関する注意点__
+
+- **"com.apple.MobileBackup"** 拡張属性のみサポートされています。値を
**1** とセットすることで、ディレクトリを iCloud でバックアップされない設定とします。値を
**0** とセットすることで、再度ディレクトリを iCloud でバックアップされる設定とします。
 
 moveTo
 ------
@@ -116,8 +145,9 @@ __使用例__
 
     function moveDir(entry) {
         var parent = document.getElementById('parent').value,
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
             newName = document.getElementById('newName').value,
-            parentEntry = new DirectoryEntry({fullPath: parent});
+            parentEntry = new DirectoryEntry(parentName, parent);
 
         // ディレクトリを新しいディレクトリに移動し、名前付け替えます
         entry.moveTo(parentEntry, newName, success, fail);
@@ -153,24 +183,25 @@ __使用例__
 
     function copyDir(entry) {
         var parent = document.getElementById('parent').value,
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
             newName = document.getElementById('newName').value,
-            parentEntry = new DirectoryEntry({fullPath: parent});
+            parentEntry = new DirectoryEntry(parentName, parent);
 
         // ディレクトリを新しいディレクトリにコピーし、名前付け替えます
         entry.copyTo(parentEntry, newName, success, fail);
     }
 
 
-toURI
+toURL
 -----
 
-ディレクトリの位置特定に使用できる URI を返します。
+ディレクトリの位置特定に使用できる URL を返します。
 
 __使用例__
 
-    // ディレクトリ URI の取得
-    var uri = entry.toURI();
-    console.log(uri);
+    // ディレクトリ URL の取得
+    var dirURL = entry.toURL();
+    console.log(dirURL);
 
 
 remove

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/file.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/file.md b/docs/jp/1.8.1/cordova/file/file.md
index a9b7c68..5a80b4c 100644
--- a/docs/jp/1.8.1/cordova/file/file.md
+++ b/docs/jp/1.8.1/cordova/file/file.md
@@ -40,3 +40,57 @@ File
 - Flags
 - LocalFileSystem
 - Metadata
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+    <plugin name="File" value="org.apache.cordova.FileUtils" />
+    <plugin name="FileTransfer" value="org.apache.cordova.FileTransfer" />
+
+#### app/AndroidManifest.xml
+
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+### Bada
+
+    パーミッションの設定は必要ありません。
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+    <plugin name="File" value="org.apache.cordova.file.FileManager" />
+    <plugin name="FileTransfer" value="org.apache.cordova.http.FileTransfer" />
+
+#### www/config.xml
+
+    <feature id="blackberry.io.file" required="true" version="1.0.0.0" />
+    <feature id="blackberry.utils"   required="true" version="1.0.0.0" />
+    <feature id="blackberry.io.dir"  required="true" version="1.0.0.0" />
+    <rim:permissions>
+        <rim:permit>access_shared</rim:permit>
+    </rim:permissions>
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+    <key>Plugins</key>
+    <dict>
+        <key>File</key>
+        <string>CDVFile</string>
+    </dict>
+
+    <key>Plugins</key>
+    <dict>
+        <key>FileTransfer</key>
+        <string>CDVFileTransfer</string>
+    </dict>
+
+### webOS
+
+    パーミッションの設定は必要ありません。

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/fileentry/fileentry.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/fileentry/fileentry.md b/docs/jp/1.8.1/cordova/file/fileentry/fileentry.md
index 17a68c4..e9347f8 100644
--- a/docs/jp/1.8.1/cordova/file/fileentry/fileentry.md
+++ b/docs/jp/1.8.1/cordova/file/fileentry/fileentry.md
@@ -39,9 +39,10 @@ FileEntry
 -------
 
 - __getMetadata__: ファイルのメタデータを取得します
+- __setMetadata__: ディレクトリのメタデータをセットします
 - __moveTo__: ファイルを、ファイルシステム内の別の場所に移動します
 - __copyTo__: ファイルを、ファイルシステム内の別の場所にコピーします
-- __toURI__: ファイルの位置特定に使用できるURIを返します
+- __toURL__: ファイルの位置特定に使用できる URL を返します
 - __remove__: ファイルを削除します
 - __getParent__: 親ディレクトリを取得します
 - __createWriter__: ファイルの書き込みに使用できる FileWriter オブジェクトを作成します
@@ -82,6 +83,35 @@ __使用例__
     entry.getMetadata(success, fail);
 
 
+setMetadata
+----------------
+
+ディレクトリのメタデータをセットします。
+**現在 iOS のみ対応しています** - ディレクトリの拡張属性をセットします。
+
+__パラメーター:__
+
+- __successCallback__ - Metadata が正常にセットされたときに呼び出されるコールバック関数を表します
_(Function)_
+- __errorCallback__ - Metadata のセット時にエラーが起きた場合に呼び出されるコールバック関数を表します
_(Function)_
+- __metadataObject__ - Metadata のキーと値が格納されているオブジェクトを表します
_(Object)_
+
+
+__使用例__
+
+    function success() {
+        console.log("メタデータが正常にセットされました。");
+    }
+
+    function fail() {
+        alert("メタデータ作成中にエラーが発生しました。");
+    }
+
+    // メタデータをセット
+    entry.setMetadata(success, fail, { "com.apple.MobileBackup": 1});
+__iOS に関する注意点__
+
+- **"com.apple.MobileBackup"** 拡張属性のみサポートされています。値を
**1** とセットすることで、ディレクトリを iCloud でバックアップされない設定とします。値を
**0** とセットすることで、再度ディレクトリを iCloud でバックアップされる設定とします。
+
 moveTo
 ------
 
@@ -112,7 +142,8 @@ __使用例__
 
     function moveFile(entry) {
         var parent = document.getElementById('parent').value,
-            parentEntry = new DirectoryEntry({fullPath: parent});
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
+            parentEntry = new DirectoryEntry(parentName, parent);
 
         // ファイルを新しいディレクトリに移動し、名前付け替えます
         entry.moveTo(parentEntry, "newFile.txt", success, fail);
@@ -146,23 +177,24 @@ __使用例__
 
     function copyFile(entry) {
         var parent = document.getElementById('parent').value,
-            parentEntry = new DirectoryEntry({fullPath: parent});
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
+            parentEntry = new DirectoryEntry(parentName, parent);
 
         // ファイルを新しいディレクトリにコピーし、名前付け替えます
         entry.copyTo(parentEntry, "file.copy", success, fail);
     }
 
 
-toURI
+toURL
 -----
 
-ファイルの位置特定に使用できる URI を返します。
+ファイルの位置特定に使用できる URL を返します。
 
 __使用例__
 
-    // このエントリーの URI を取得
-    var uri = entry.toURI();
-    console.log(uri);
+    // このエントリーの URL を取得
+    var fileURL = entry.toURL();
+    console.log(fileURL);
 
 
 remove

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/filereader/filereader.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/filereader/filereader.md b/docs/jp/1.8.1/cordova/file/filereader/filereader.md
index 7f9e059..850b892 100644
--- a/docs/jp/1.8.1/cordova/file/filereader/filereader.md
+++ b/docs/jp/1.8.1/cordova/file/filereader/filereader.md
@@ -133,7 +133,7 @@ Abort の例
       <head>
         <title>FileReader の使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordova の読み込み完了まで待機

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/filetransfer/filetransfer.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/filetransfer/filetransfer.md b/docs/jp/1.8.1/cordova/file/filetransfer/filetransfer.md
index 98c8ea8..2eb8d9d 100644
--- a/docs/jp/1.8.1/cordova/file/filetransfer/filetransfer.md
+++ b/docs/jp/1.8.1/cordova/file/filetransfer/filetransfer.md
@@ -95,7 +95,7 @@ __詳細な使用例__
       <head>
         <title>File Transfer の使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
             // Cordova の読み込み完了まで待機

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/filetransfererror/filetransfererror.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/filetransfererror/filetransfererror.md b/docs/jp/1.8.1/cordova/file/filetransfererror/filetransfererror.md
index 8730ab5..d16f2ed 100644
--- a/docs/jp/1.8.1/cordova/file/filetransfererror/filetransfererror.md
+++ b/docs/jp/1.8.1/cordova/file/filetransfererror/filetransfererror.md
@@ -28,6 +28,7 @@ FileTransferError
 - __code__ 事前に定義された以下のエラーコードのうちの1つを表します
(int)
 - __source__ ソースの URI を表します (string)
 - __target__ ターゲットの URI を表します (string)
+- __http_status__ HTTP のステータスコードを表します。この属性は、レスポンスコードが
HTTP コネクションから返されたときのみ有効です (int)
 
 定数
 ---------

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/filewriter/filewriter.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/filewriter/filewriter.md b/docs/jp/1.8.1/cordova/file/filewriter/filewriter.md
index 5684a77..2673fc0 100644
--- a/docs/jp/1.8.1/cordova/file/filewriter/filewriter.md
+++ b/docs/jp/1.8.1/cordova/file/filewriter/filewriter.md
@@ -144,7 +144,7 @@ Abort の例
       <head>
         <title>FileWriter の使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordova の読み込み完了まで待機

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/b6d09bf8/docs/jp/1.8.1/cordova/file/localfilesystem/localfilesystem.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/file/localfilesystem/localfilesystem.md b/docs/jp/1.8.1/cordova/file/localfilesystem/localfilesystem.md
index fd71d51..26b1897 100644
--- a/docs/jp/1.8.1/cordova/file/localfilesystem/localfilesystem.md
+++ b/docs/jp/1.8.1/cordova/file/localfilesystem/localfilesystem.md
@@ -75,7 +75,7 @@ Resolve Local File System URIの使用例
       <head>
         <title>Local File System の使用例</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         // Cordova の読み込み完了まで待機


Mime
View raw message