incubator-callback-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From fil...@apache.org
Subject [2/29] Add French 1.3.0 translation
Date Thu, 12 Jan 2012 20:13:59 GMT
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/Contact/contact.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/Contact/contact.md b/docs/fr/1.3.0/phonegap/contacts/Contact/contact.md
new file mode 100644
index 0000000..2b625c6
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/Contact/contact.md
@@ -0,0 +1,202 @@
+Contact
+=======
+
+Contient des propriétés décrivant un contact, tel qu'un contact personnel ou professionnel.
+
+Propriétés
+----------
+
+- __id:__ L'identifiant unique du contact. _(DOMString)_
+- __displayName:__ Le nom du contact tel qu'il sera affiché à un utilisateur final. _(DOMString)_
+- __name:__ Un objet contenant tous les composants du nom du contact. _(ContactName)_
+- __nickname:__ Le nom d'usage utilisé pour désigner le contact. _(DOMString)_
+- __phoneNumbers:__ Un tableau de tous les numéros de téléphone du contact. _(ContactField[])_
+- __emails:__ Un tableau de toutes les adresses e-mail du contact. _(ContactField[])_
+- __addresses:__ Un tableau de toutes les adresses du contact. _(ContactAddresses[])_
+- __ims:__ Un tableau de toutes les adresses de messagerie instantanée du contact. _(ContactField[])_
+- __organizations:__ Un tableau de toutes les organisations du contact. _(ContactOrganization[])_
+- __birthday:__ La date de naissance du contact. _(Date)_
+- __note:__ Une remarque à propos du contact. _(DOMString)_
+- __photos:__ Un tableau de toutes les photos du contact. _(ContactField[])_
+- __categories:__ Un tableau de toutes les catégories auxquelles appartient le contact. _(ContactField[])_
+- __urls:__ Un tableau de toutes les URLs de pages web associées au contact. _(ContactField[])_
+
+Méthodes
+--------
+
+- __clone__: Retourne un nouvel objet Contact qui est une copie intégrale de l'objet appelant, avec la propriété `id` valorisée à `null`. 
+- __remove__: Supprime le contact de la base de contacts du mobile. Un callback d'erreur est appelé avec un objet `ContactError` si la suppression a échoué.
+- __save__: Enregistre un nouveau contact dans la base de contacts du mobile, ou met à jour un contact s'il existe déjà un contact possédant le même __id__.
+
+
+Details
+-------
+
+L'objet `Contact` représente un contact de l'utilisateur. Des contacts peuvent être ajoutés, modifiés ou supprimés de la base des contacts du mobile. Des contacts peuvent également être retrouvés (unitairement ou en masse) depuis la base en invoquant la méthode `contacts.find`. 
+
+_Remarque: Toutes les propriétés ci-dessus ne sont pas supportées par toutes plateformes. Veuillez consulter la section Singularités de votre plateforme pour savoir quelles propriétés sont supportées ou non._
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide de Save
+----------------------
+
+	function onSuccess(contact) {
+		alert("Enregistrement réussi");
+	};
+
+	function onError(contactError) {
+		alert("Erreur = " + contactError.code);
+	};
+
+	// Créer un nouvel objet contact
+    var contact = navigator.contacts.create();
+	contact.displayName = "Plombier";
+	contact.nickname = "Plombier"; 		// Préciser les deux propriétés pour que cela marche sur tous les mobiles
+	
+	// Renseigner quelques champs
+	var name = new ContactName();
+	name.givenName = "Jane";
+	name.familyName = "Doe";
+	contact.name = name;
+	
+	// Enregistrer dans la base du mobile
+	contact.save(onSuccess,onError);
+
+Exemple rapide de Clone
+-----------------------
+
+	// Cloner l'objet contact
+	var clone = contact.clone();
+	clone.name.givenName = "John";
+	console.log("Nom du contact de départ = " + contact.name.givenName);
+	console.log("Nom du contact cloné = " + clone.name.givenName); 
+
+Exemple rapide de Remove
+------------------------
+
+    function onSuccess() {
+        alert("Suppression réussie");
+    };
+
+    function onError(contactError) {
+        alert("Erreur = " + contactError.code);
+    };
+
+	// Supprimer le contact de la base du mobile
+	contact.remove(onSuccess,onError);
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+		    // Créer un nouveau contact
+		    var contact = navigator.contacts.create();
+			contact.displayName = "Plombier";
+			contact.nickname = "Plombier"; 		// Préciser les deux propriétés pour que cela marche sur tous les mobiles
+			var name = new ContactName();
+			name.givenName = "Jane";
+			name.familyName = "Doe";
+			contact.name = name;
+
+			// Enregistrer le contact
+			contact.save(onSaveSuccess,onSaveError);
+			
+			// Cloner le contact
+			var clone = contact.clone();
+			clone.name.givenName = "John";
+			console.log("Nom du contact de départ = " + contact.name.givenName);
+			console.log("Nom du contact cloné = " + clone.name.givenName); 
+			
+			// Supprimer le contact
+			contact.remove(onRemoveSuccess,onRemoveError);
+        }
+        
+        // onSaveSuccess: callback appelé en cas de réussite de l'enregistrement
+        //
+        function onSaveSuccess(contact) {
+			alert("Enregistrement réussi");
+        }
+    
+        // onSaveError: callback appelé en cas d'échec de l'enregistrement
+        //
+        function onSaveError(contactError) {
+			alert("Erreur = " + contactError.code);
+        }
+        
+        // onRemoveSuccess: callback appelé en cas de réussite de la suppression
+        //
+        function onRemoveSuccess(contacts) {
+			alert("Suppression réussie");
+        }
+    
+        // onRemoveError: callback appelé en cas d'échec de la suppression
+        //
+        function onRemoveError(contactError) {
+			alert("Erreur = " + contactError.code);
+        }
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Manipulation des contacts</p>
+      </body>
+    </html>
+
+Singularités Android 2.X
+------------------------
+
+- __categories:__ Cette propriété n'est pas supportée sur Android 2.X et vaudra toujours `null`.
+
+Singularités Android 1.X
+------------------------
+
+- __name:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __nickname:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __birthday:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __photos:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __categories:__  Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __urls:__  Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+
+
+Singularités BlackBerry WebWorks (OS 5.0 et plus récent)
+--------------------------------------------------------
+
+- __id:__ Supporté.  Défini par le mobile lorsque le contact est enregistré.
+- __displayName:__ Supporté.  Stocké dans le champ BlackBerry __user1__.
+- __nickname:__ Cette propriété n'est pas supportée et vaudra toujours `null`.
+- __phoneNumbers:__ Partiellement supporté.  Les numéros de téléphone sont stockées dans les champs BlackBerry __homePhone1__ et __homePhone2__ si _type_ vaut 'home', __workPhone1__ et __workPhone2__ si _type_ vaut 'work', __mobilePhone__ si _type_ vaut 'mobile', __faxPhone__ si _type_ vaut 'fax', __pagerPhone__ si _type_ vaut 'pager', et __otherPhone__ si _type_ vaut autre chose.
+- __emails:__ Partiellement supporté. Les trois premières adresses e-mail sont stockées respectivement dans les champs BlackBerry __email1__, __email2__, et __email3__.
+- __addresses:__ Partiellement supporté.  La deux premières adresses sont stockées respectivement dans les champs BlackBerry __homeAddress__ et __workAddress__.
+- __ims:__ Cette propriété n'est pas supportée et vaudra toujours `null`.
+- __organizations:__ Partiellement supporté.  Les propriétés __name__ et __title__ de la première organisation sont stockées respectivement dans les champs BlackBerry __company__ et __title__.
+- __photos:__ - Partiellement supporté.  Une seule photo, taille vignette, est autorisée.  Pour attribuer une photo à un contact, passer soit un flux image encodé en Base64, soit l'URI d'une image.  L'image sera redimensionnée en vignette avant d'être enregistrée dans la base de contacts BlackBerry.  La photo du contact est toujours renvoyée sour forme de flux encodé en Base64.
+- __categories:__  Partiellement supporté.  Seules les catégories 'Business' et 'Personal' sont autorisées.
+- __urls:__  Partiellement supporté. La première URL est stockée dans le champ BlackBerry __webpage__.
+
+Singularités iOS
+----------------
+- __displayName:__ Cette propriété n'est pas supportée sur iOS et sera ignorée à l'enregistrement sauf si aucun `ContactName` n'est renseigné.  A la récupération du contact, si aucun `ContactName` n'est renseigné, alors le "Composite Name" iOS, __nickame__ ou "" sera utilisé comme valeur de __displayName__. 
+- __birthday:__ En entrée, cette propriété doit être valorisée avec un objet Date JavaScript. Elle est renvoyée également sous forme d'objet Date JavaScript.
+- __photos:__ La photo du contact est déposée dans le dossier temporaire de l'application et c'est l'URI de ce fichier image qui est renvoyée. Le contenu du dossier temporaire est supprimé à la fermeture de l'application.
+- __categories:__ Cette propriété n'est pas supportée et vaudra toujours `null`.

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/ContactAddress/contactaddress.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/ContactAddress/contactaddress.md b/docs/fr/1.3.0/phonegap/contacts/ContactAddress/contactaddress.md
new file mode 100644
index 0000000..54f75f3
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/ContactAddress/contactaddress.md
@@ -0,0 +1,144 @@
+ContactAddress
+==============
+
+Contient les propriétés relatives à l'adresse, pour un objet `Contact`.
+
+Propriétés
+----------
+- __pref:__ Valorisé à `true` si cet objet `ContactAddress` correspond à l'adresse préférée par l'utilisateur. _(boolean)_
+- __type:__ Chaîne de caractères indiquant de quel type d'adresse il s'agit (exemple: 'home'). _(DOMString)
+- __formatted:__ L'adresse complète formatée pour l'affichage. _(DOMString)_
+- __streetAddress:__ Le numéro et le nom de voie. _(DOMString)_
+- __locality:__ La ville ou lieu-dit. _(DOMString)_
+- __region:__ La région ou le département. _(DOMString)_
+- __postalCode:__ Le code postal. _(DOMString)_
+- __country:__ Le nom du pays. _(DOMString)_
+
+Détails
+-------
+
+L'objet `ContactAddress` contient les propriétés relatives à une seule adresse de contact. Un contact peut avoir une ou plusieurs adresses dans un tableau `ContactAddress[]`.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+	// Afficher toutes les adresses de tous les contacts
+    function onSuccess(contacts) {
+		for (var i=0; i<contacts.length; i++) {
+			for (var j=0; j<contacts[i].addresses.length; j++) {
+				alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
+						"Type : " + contacts[i].addresses[j].type + "\n" +
+						"Version formatée : " + contacts[i].addresses[j].formatted + "\n" + 
+						"Numéro et nom de voie : "  + contacts[i].addresses[j].streetAddress + "\n" + 
+						"Ville : "  + contacts[i].addresses[j].locality + "\n" + 
+						"Région : "  + contacts[i].addresses[j].region + "\n" + 
+						"Code postal : "  + contacts[i].addresses[j].postalCode + "\n" + 
+						"Pays : "  + contacts[i].addresses[j].country);
+			}
+		}
+    };
+
+    function onError(contactError) {
+        alert('onError!');
+    };
+
+    // Trouver tous les contacts
+    var options = new ContactFindOptions();
+	options.filter=""; 
+	var filter = ["displayName","addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+		    // find all contacts
+		    var options = new ContactFindOptions();
+			options.filter=""; 
+			var filter = ["displayName","addresses"];
+		    navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Afficher toutes les adresses de tous les contacts
+        //
+		function onSuccess(contacts) {
+			// Afficher toutes les adresses de tous les contacts
+			for (var i=0; i<contacts.length; i++) {
+				for (var j=0; j<contacts[i].addresses.length; j++) {
+					alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
+							"Type: " + contacts[i].addresses[j].type + "\n" +
+							"Formatted: " + contacts[i].addresses[j].formatted + "\n" + 
+							"Street Address: "  + contacts[i].addresses[j].streetAddress + "\n" + 
+							"Locality: "  + contacts[i].addresses[j].locality + "\n" + 
+							"Region: "  + contacts[i].addresses[j].region + "\n" + 
+							"Postal Code: "  + contacts[i].addresses[j].postalCode + "\n" + 
+							"Country: "  + contacts[i].addresses[j].country);
+				}
+			}
+		};
+    
+        // onError: Echec de récupération des contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Adresses des contacts</p>
+      </body>
+    </html>
+
+Singularités Android 2.X
+------------------------
+
+- __pref:__ Cette propriété n'est pas supportée sur Android 2.X et vaudra toujours `null`.
+
+Singularités Android 1.X
+------------------------
+
+- __pref:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `false`.
+- __type:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __streetAddress:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __locality:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __region:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __postalCode:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __country:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+
+Singularités BlackBerry WebWorks (OS 5.0 et plus récent)
+--------------------------------------------------------
+- __pref:__ Cette propriété n'est pas supportée sur Blackberry et vaudra toujours `false`.
+- __type:__ Partiellement supporté.  Seules une adresse de type "Work" et une de type "Home" peuvent être enregistrées par contact. 
+- __formatted:__ Partiellement supporté.  Contiendra la concaténation de tous les champs d'adresse BlackBerry.
+- __streetAddress:__ Supporté.  Contiendra la concaténation des champs d'adresse BlackBerry __address1__ et __address2__. 
+- __locality:__ Supporté.  Stocké dans le champ d'adresse BlackBerry __city__.
+- __region:__ Supporté.  Stocké dans le champ d'adresse BlackBerry __stateProvince__.
+- __postalCode:__ Supporté.  Stocké dans le champ d'adresse BlackBerry __zipPostal__.
+
+Singularités iOS
+----------------
+- __pref:__ Cette propriété n'est pas supportée sur iOS et vaudra toujours `false`.
+- __formatted:__ Cette propriété n'est pas encore supportée.

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/ContactError/contactError.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/ContactError/contactError.md b/docs/fr/1.3.0/phonegap/contacts/ContactError/contactError.md
new file mode 100644
index 0000000..2489c8b
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/ContactError/contactError.md
@@ -0,0 +1,26 @@
+ContactError
+========
+
+Un objet `ContactError` est passé à la fonction de callback `contactError` lorsqu'une erreur survient.
+
+Propriétés
+----------
+
+- __code:__ Un des codes d'erreur prédéfinis listés ci-dessous.
+
+Constantes
+----------
+
+- `ContactError.UNKNOWN_ERROR`
+- `ContactError.INVALID_ARGUMENT_ERROR`
+- `ContactError.TIMEOUT_ERROR`
+- `ContactError.PENDING_OPERATION_ERROR`
+- `ContactError.IO_ERROR`
+- `ContactError.NOT_SUPPORTED_ERROR`
+- `ContactError.PERMISSION_DENIED_ERROR`
+
+Description
+-----------
+
+L'objet `ContactError` est renvoyé à l'utilisateur en tant qu'argument d'appel de la fonction de callback `contactError` lorsqu'une erreur survient.
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/ContactField/contactfield.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/ContactField/contactfield.md b/docs/fr/1.3.0/phonegap/contacts/ContactField/contactfield.md
new file mode 100644
index 0000000..c1a57aa
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/ContactField/contactfield.md
@@ -0,0 +1,121 @@
+ContactField
+============
+
+Conteneur générique d'une propriété d'un objet `Contact`. Parmi les propriétés portées par des objets `ContactField`, on peut trouver les adresses e-mails, les numéros de téléphone et les URLs.
+
+Propriétés
+----------
+
+- __type:__ Une chaîne de caractère indiquant de quel type de propriété il s'agit (exemple: 'home'). _(DOMString)_
+- __value:__ La valeur de la propriété (par exemple un numéro de téléphone ou une adresse e-mail). _(DOMString)_
+- __pref:__ Valorisé à `true` si cet objet `ContactField` correspond à la valeur préférée par l'utilisateur. _(boolean)_
+
+Détails
+-------
+
+L'objet `ContactField` est un composant réutilisable destiné à contenir une propriété d'un contact de manière générique. Chaque objet `ContactField` contient un attribut value, type et pref.  Un objet `Contact` contient plusieurs propriétés à l'interieur de tableaux `ContactField[]`, comme par exemple des numéros de téléphone et des adresses e-mail.
+
+Dans la plupart des cas, il n'y a pas de valeur pré-déterminée pour l'attribut __type__ d'un objet `ContactField`.  Par exemple, un numéro de téléphone peut avoir un __type__ valant 'home', 'work', 'mobile', 'iPhone', ou tout autre valeur qui est supportée par la base de contacts de la plateforme mobile utilisée.  Ceci dit, dans le cas précis de la propriété __photos__ de `Contact`, PhoneGap se sert de l'attribut __type__ pour indiquer le format de retour de l'image.  PhoneGap retourne __type: 'url'__ lorsque l'attribut __value__ contient une URI de fichier image, ou __type: 'base64'__ lorsque l'attribut __value__ contient un flux image encodé en Base64.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+	// Créer un nouveau contact
+	var contact = navigator.contacts.create();
+	
+	// Enregistrer les numéros de téléphone du contact dans un tableau ContactField[]
+	var phoneNumbers = [3];
+	phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+	phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // Numéro préféré
+	phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+	contact.phoneNumbers = phoneNumbers;
+	
+	// Enregistrer le contact
+	contact.save();
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+			// Créer un nouveau contact
+		    var contact = navigator.contacts.create();
+
+			// Enregistrer les numéros de téléphone du contact dans un tableau ContactField[]
+			var phoneNumbers = [3];
+			phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+			phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // Numéro préféré
+			phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+			contact.phoneNumbers = phoneNumbers;
+
+			// Enregistrer le contact
+			contact.save();
+
+			// Rechercher les contacts, et retourner leur nom d'affichage et leurs numéros de téléphone respectifs
+			var options = new ContactFindOptions();
+			options.filter="";
+			filter = ["displayName","phoneNumbers"];
+			navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Affichage de tous les numéros de téléphone des contacts trouvés
+        //
+		function onSuccess(contacts) {
+			for (var i=0; i<contacts.length; i++) {
+				// Affichage des numéros de téléphone
+				for (var j=0; j<contacts[i].phoneNumbers.length; j++) {
+					alert("Type : " + contacts[i].phoneNumbers[j].type + "\n" + 
+							"Valeur : "  + contacts[i].phoneNumbers[j].value + "\n" + 
+							"Préféré : "  + contacts[i].phoneNumbers[j].pref);
+				}
+			}
+		};
+    
+        // onError: Echec de récupération des contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Recherche des contacts</p>
+      </body>
+    </html>
+
+Singularités Android
+--------------------
+
+- __pref:__ Cette propriété n'est pas supportée sur Android 2.X et vaudra toujours `false`.
+
+Singularités BlackBerry WebWorks (OS 5.0 et plus récent)
+--------------------------------------------------------
+
+- __type:__ Partiellement supporté.  Utilisé pour les numéros de téléphone.
+- __pref:__ Cette propriété n'est pas supportée sur BlackBerry et vaudra toujours `false`.
+
+Singularités iOS
+----------------
+- __pref:__ Cette propriété n'est pas supportée sur iOS et vaudra toujours `false`.

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/ContactFindOptions/contactfindoptions.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/ContactFindOptions/contactfindoptions.md b/docs/fr/1.3.0/phonegap/contacts/ContactFindOptions/contactfindoptions.md
new file mode 100644
index 0000000..9f3e791
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/ContactFindOptions/contactfindoptions.md
@@ -0,0 +1,93 @@
+ContactFindOptions
+==================
+
+Contient des propriétés qui peuvent être utilisées pour filtrer les résultats d'une recherche `contacts.find`. 
+
+Propriétés
+----------
+
+- __filter:__ La chaîne de caractères utilisée pour la recherche de contacts. _(DOMString)_ (Default: "")
+- __multiple:__ Indique s'il faut que la recherche retourne plusieurs contacts. _(Boolean)_ (Default: false)
+
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+	// Callback de succès
+    function onSuccess(contacts) {
+		for (var i=0; i<contacts.length; i++) {
+			alert(contacts[i].displayName);
+		}
+    };
+
+	// Callback d'erreur
+    function onError(contactError) {
+        alert('onError!');
+    };
+
+	// Spécifier des critères de recherche de contacts
+    var options = new ContactFindOptions();
+	options.filter="";			// une chaine vide permet de retrouver tous les contacts
+	options.multiple=true;		// on veut que plusieurs résultats soient retournés
+	filter = ["displayName"];	// on veut obtenir uniquement l'attribut contact.displayName des résultats
+	
+	// Lancer la recherche des contacts
+    navigator.contacts.find(filter, onSuccess, onError, options);
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+			// Spécifier des critères de recherche de contacts
+		    var options = new ContactFindOptions();
+			options.filter="";			// une chaine vide permet de retrouver tous les contacts
+			options.multiple=true;		// on veut que plusieurs résultats soient retournés
+			filter = ["displayName"];	// on veut obtenir uniquement l'attribut contact.displayName des résultats
+
+			// Lancer la recherche des contacts
+		    navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Afficher les noms de tous les contacts trouvés
+        //
+		function onSuccess(contacts) {
+			for (var i=0; i<contacts.length; i++) {
+				alert(contacts[i].displayName);
+			}
+		};
+    
+        // onError: Echec de récupération des contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Recherche de Contacts</p>
+      </body>
+    </html>
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/ContactName/contactname.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/ContactName/contactname.md b/docs/fr/1.3.0/phonegap/contacts/ContactName/contactname.md
new file mode 100644
index 0000000..58815c4
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/ContactName/contactname.md
@@ -0,0 +1,118 @@
+ContactName
+===========
+
+Contient les propriétés relatives au nom, pour un objet `Contact`.
+
+Propriétés
+----------
+
+- __formatted:__ Le nom complet du contact. _(DOMString)_
+- __familyName:__ Le nom de famille. _(DOMString)_
+- __givenName:__ Le prénom. _(DOMString)_
+- __middleName:__ Le deuxième prénom. _(DOMString)_
+- __honorificPrefix:__ Un préfixe (par exemple Mr. ou Dr.) _(DOMString)_
+- __honorificSuffix:__ Un suffixe (par exemple Esq. ou Jr.). _(DOMString)_
+
+Détails
+-------
+
+L'objet `ContactName` contient les propriétés relatives au nom d'un contact.
+
+Plateformes supportées
+----------------------
+
+- Android 2.X
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+    function onSuccess(contacts) {
+		for (var i=0; i<contacts.length; i++) {
+			alert("Nom complet : " + contacts[i].name.formatted + "\n" + 
+					"Nom de famille : "  + contacts[i].name.familyName + "\n" + 
+					"Prénom : "  + contacts[i].name.givenName + "\n" + 
+					"Deuxième prénom : "  + contacts[i].name.middleName + "\n" + 
+					"Suffixe : "  + contacts[i].name.honorificSuffix + "\n" + 
+					"Préfixe : "  + contacts[i].name.honorificPrefix);
+		}
+    };
+
+    function onError(contactError) {
+        alert('onError!');
+    };
+
+    var options = new ContactFindOptions();
+	options.filter="";
+	filter = ["displayName","name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+			var options = new ContactFindOptions();
+			options.filter="";
+			filter = ["displayName","name"];
+			navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Afficher le nom de tous les contacts
+        //
+		function onSuccess(contacts) {
+			for (var i=0; i<contacts.length; i++) {
+				alert("Nom complet : " + contacts[i].name.formatted + "\n" + 
+						"Nom de famille : "  + contacts[i].name.familyName + "\n" + 
+						"Prénom : "  + contacts[i].name.givenName + "\n" + 
+						"Deuxième prénom : "  + contacts[i].name.middleName + "\n" + 
+						"Suffixe : "  + contacts[i].name.honorificSuffix + "\n" + 
+						"Préfixe : "  + contacts[i].name.honorificPrefix);
+			}
+		};
+    
+        // onError: Echec de récupération des contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Nom des contacts</p>
+      </body>
+    </html>
+
+Singularités Android
+--------------------
+- __formatted:__ Partiellement supporté.  Retournera la concaténation de honorificPrefix, givenName, middleName, familyName et honorificSuffix mais ne sera pas stocké.
+
+Singularités BlackBerry WebWorks (OS 5.0 et plus récent)
+--------------------------------------------------------
+
+- __formatted:__ Partiellement supporté.  Retournera la concaténation des champs BlackBerry __firstName__ et __lastName__.
+- __familyName:__ Supporté.  Stocké dans le champ BlackBerry __lastName__.
+- __givenName:__ Supporté.  Stocké dans le champ BlackBerry __firstName__.
+- __middleName:__ Cette propriété n'est pas supportée et vaudra toujours `null`.
+- __honorificPrefix:__ Cette propriété n'est pas supportée et vaudra toujours `null`.
+- __honorificSuffix:__ Cette propriété n'est pas supportée et vaudra toujours `null`.
+
+Singularités iOS
+----------------
+- __formatted:__ Partiellement supporté.  Retournera le Composite Name iOS et ne sera pas stocké.

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/ContactOrganization/contactorganization.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/ContactOrganization/contactorganization.md b/docs/fr/1.3.0/phonegap/contacts/ContactOrganization/contactorganization.md
new file mode 100644
index 0000000..c785d6e
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/ContactOrganization/contactorganization.md
@@ -0,0 +1,131 @@
+ContactOrganization
+===================
+
+Contient les propriétés relatives à l'organisation, pour un objet `Contact`.
+
+Propriétés
+----------
+- __pref:__ Valorisé à `true` si cet objet `ContactOrganization` correspond à l'organisation préférée par l'utilisateur. _(boolean)_
+- __type:__ Chaîne de caractères indiquant de quel type d'organisation il s'agit (exemple: 'home'). _(DOMString)
+- __name:__ Le nom de l'organisation. _(DOMString)_
+- __department:__ Le département pour lequel le contact travaille. _(DOMString)_
+- __title:__ Le poste que le contact occupe dans cette organisation. _(DOMString)_
+
+Détails
+-------
+
+L'objet `ContactOrganization` stocke les propriétés relatives à l'organisation à laquelle un contact appartient.  Un objet `Contact` peut contenir un ou plusieurs objets `ContactOrganization` dans un tableau.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+    function onSuccess(contacts) {
+		for (var i=0; i<contacts.length; i++) {
+			for (var j=0; j<contacts[i].organizations.length; j++) {
+				alert("Pref : " + contacts[i].organizations[j].pref + "\n" +
+						"Type : " + contacts[i].organizations[j].type + "\n" +
+						"Nom : " + contacts[i].organizations[j].name + "\n" + 
+						"Département : "  + contacts[i].organizations[j].department + "\n" + 
+						"Poste : "  + contacts[i].organizations[j].title);
+			}
+		}
+    };
+
+    function onError(contactError) {
+        alert('onError!');
+    };
+
+    var options = new ContactFindOptions();
+	options.filter="";
+	filter = ["displayName","organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+			var options = new ContactFindOptions();
+			options.filter="";
+			filter = ["displayName","organizations"];
+			navigator.contacts.find(filter, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Afficher toutes les organisations de tous les contacts
+        //
+		function onSuccess(contacts) {
+			for (var i=0; i<contacts.length; i++) {
+				for (var j=0; j<contacts[i].organizations.length; j++) {
+					alert("Pref : " + contacts[i].organizations[j].pref + "\n" +
+							"Type : " + contacts[i].organizations[j].type + "\n" +
+							"Nom : " + contacts[i].organizations[j].name + "\n" + 
+							"Département : "  + contacts[i].organizations[j].department + "\n" + 
+							"Poste : "  + contacts[i].organizations[j].title);
+				}
+			}
+		};
+    
+        // onError: Echec de récupération des contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Organisations des contacts</p>
+      </body>
+    </html>
+	
+
+Singularités Android 2.X
+------------------------
+
+- __pref:__ Cette propriété n'est pas supportée sur Android 2.X et vaudra toujours `false`.
+
+Singularités Android 1.X
+------------------------
+
+- __pref:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `false`.
+- __type:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+- __title:__ Cette propriété n'est pas supportée sur Android 1.X et vaudra toujours `null`.
+
+Singularités BlackBerry WebWorks (OS 5.0 et plus récent)
+--------------------------------------------------------
+- __pref:__ Cette propriété n'est pas supportée sur Blackberry et vaudra toujours `false`.
+- __type:__ Cette propriété n'est pas supportée sur Blackberry et vaudra toujours `null`.
+- __name:__ Partiellement supporté.  Le nom de la première organisation sera stocké dans le champ BlackBerry __company__.
+- __department:__ Cette propriété n'est pas supportée sur Blackberry et vaudra toujours `null`.
+- __title:__ Partiellement supporté.  Le poste occupé dans la première organisation sera stocké dans le champ BlackBerry __jobTitle__.
+
+Singularités iOS
+----------------
+- __pref:__ Cette propriété n'est pas supportée sur iOS et vaudra toujours `false`.
+- __type:__ Cette propriété n'est pas supportée sur iOS et vaudra toujours `null`.
+- __name:__ Partiellement supporté.  Le nom de la première organisation sera stocké dans le champ iOS __kABPersonOrganizationProperty__.
+- __department__: Partiellement supporté.  Le département du contact dans la première organisation sera stocké dans le champ iOS __kABPersonDepartmentProperty__.
+- __title__: Partiellement supporté.  Le poste occupé dans la première organisation sera stocké dans le champ iOS __kABPersonJobTitleProperty__.
+
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/contacts.create.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/contacts.create.md b/docs/fr/1.3.0/phonegap/contacts/contacts.create.md
new file mode 100644
index 0000000..76be749
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/contacts.create.md
@@ -0,0 +1,57 @@
+contacts.create
+===============
+
+Retourne un nouvel objet Contact.
+
+    var contact = navigator.contacts.create(properties);
+
+Description
+-----------
+
+contacts.create est une fonction synchrone retournant un nouvel objet `Contact`.
+
+Cette fonction n'insert pas l'objet Contact ainsi créé dans la base de contacts du mobile.  Pour insérer l'objet dnas la base du mobile, il faut appeler la méthode `Contact.save`.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+    var myContact = navigator.contacts.create({"displayName": "Utilisateur test"});
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+			var myContact = navigator.contacts.create({"displayName": "Utilisateur test"});
+			myContact.gender = "masculin";
+			console.log("Le contact, " + myContact.displayName + ", est de sexe " + myContact.gender);
+        }
+    
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Création d'un contact</p>
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/contacts.find.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/contacts.find.md b/docs/fr/1.3.0/phonegap/contacts/contacts.find.md
new file mode 100644
index 0000000..2937916
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/contacts.find.md
@@ -0,0 +1,96 @@
+contacts.find
+=============
+
+Interroge la base de contacts du mobile et retourne un ou plusieurs objets `Contact`, à l'interieur desquels seuls les quelques attributs choisis sont valorisés.
+
+    navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
+
+Description
+-----------
+
+`contacts.find` est une fonction qui interroge de manière asynchrone la base de contacts du mobile et qui retourne un tableau d'objets `Contact`.  Les objets ainsi obtenus sont passés à la fonction de callback `contactSuccess` spécifiée via le paramètre __contactSuccess__.  
+
+L'utilisateur doit préciser les champs qu'il souhaite cibler dans sa recherche via le paramètre __contactFields__. Seuls les champs précisés dans le paramètre __contactFields__ seront valorisés à l'intérieur les objets `Contact` passés à la fonction de callback __contactSuccess__. Un paramètre __contactFields__ égal à [] aura pour effet d'obtenir un tableau d'objets `Contact` dont seul l'attribut `id` est rempli. Un __contactFields__ égal à ["*"] permet d'obtenir la valorisation de tous les attributs.  
+
+La chaîne de caractères __contactFindOptions.filter__ peut être utilisée comme un filtre de recherche lors de l'interrogation de la base de contacts. Si fourni, il y a recherche de correspondance, partielle et insensible à la casse, avec chaque champ listé dans le paramètre __contactFields__. Si une correspondance est trouvée avec l'un des champs spécifiés, le contact est retourné.
+
+Paramètres
+----------
+
+- __contactFields:__ Attributs de `Contact` qui sont ciblés par la recherche. Seuls ces champs seront valorisés à l'intérieur les objets `Contact`. _(DOMString[])_ [Obligatoire]
+- __contactSuccess:__ Fonction de callback en succès qui sera invoquée avec les contacts retournés par la recherche. [Obligatoire]
+- __contactError:__ Fonction de callback d'erreur. Invoquée lorsqu'une erreur survient. [Facultatif]
+- __contactFindOptions:__ Options de filtrage des contacts. [Facultatif]
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 et plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+    function onSuccess(contacts) {
+        alert(contacts.length + ' contacts trouvés.');
+    };
+
+    function onError(contactError) {
+        alert('onError!');
+    };
+
+    // Rechercher tous les contacts qui ont 'Bob' dans l'un de leurs champs de nom
+    var options = new ContactFindOptions();
+	options.filter="Bob"; 
+	var fields = ["displayName", "name"];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Contact</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+		    // Rechercher tous les contacts qui ont 'Bob' dans l'un de leurs champs de nom
+		    var options = new ContactFindOptions();
+			options.filter="Bob"; 
+			var fields = ["displayName", "name"];
+		    navigator.contacts.find(fields, onSuccess, onError, options);
+        }
+    
+        // onSuccess: Afficher le nom de tous les contacts trouvés
+        //
+        function onSuccess(contacts) {
+			for (var i=0; i<contacts.length; i++) {
+				console.log("Nom d'affichage = " + contacts[i].displayName);
+			}
+        }
+    
+        // onError: Echec de récupération des contacts
+        //
+        function onError(contactError) {
+            alert('onError!');
+        }
+
+        </script>
+      </head>
+      <body>
+        <h1>Exemple</h1>
+        <p>Recherche de contacts</p>
+      </body>
+    </html>
+    
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/contacts.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/contacts.md b/docs/fr/1.3.0/phonegap/contacts/contacts.md
new file mode 100644
index 0000000..967634a
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/contacts.md
@@ -0,0 +1,29 @@
+Contacts
+========
+
+> L'objet `contacts` donne accès à la base de contacts du mobile.  
+
+Méthodes
+--------
+
+- contacts.create
+- contacts.find
+
+Arguments
+---------
+
+- contactFields
+- contactSuccess
+- contactError
+- contactFindOptions
+
+Objets
+------
+
+- Contact
+- ContactName
+- ContactField
+- ContactAddress
+- ContactOrganization
+- ContactFindOptions
+- ContactError
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/parameters/contactError.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/parameters/contactError.md b/docs/fr/1.3.0/phonegap/contacts/parameters/contactError.md
new file mode 100644
index 0000000..645865e
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/parameters/contactError.md
@@ -0,0 +1,8 @@
+contactError
+============
+
+Fonction de callback onError pour les fonctions de `Contact`. 
+
+    function(error) {
+        // Gérer l'erreur
+    }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/parameters/contactFields.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/parameters/contactFields.md b/docs/fr/1.3.0/phonegap/contacts/parameters/contactFields.md
new file mode 100644
index 0000000..f5e2273
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/parameters/contactFields.md
@@ -0,0 +1,6 @@
+contactFields
+=============
+
+Paramètre obligatoire pour la méthode `contacts.find`.  Utiliser ce paramètre pour préciser quels champs des objets `Contact` doivent être remplis en retour d'une recherche.
+
+    ["name", "phoneNumbers", "emails"]

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/parameters/contactFindOptions.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/parameters/contactFindOptions.md b/docs/fr/1.3.0/phonegap/contacts/parameters/contactFindOptions.md
new file mode 100644
index 0000000..4b1d70c
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/parameters/contactFindOptions.md
@@ -0,0 +1,16 @@
+contactFindOptions
+==================
+
+Paramètre optionnel de la méthode `contacts.find`.  Utiliser ce paramètre pour filtrer les contacts à récupérer de la base de contacts.
+
+    { 
+		filter: "",
+		multiple: true,
+	};
+
+Options
+-------
+
+- __filter:__ La chaîne de caractères utilisée pour filtrer les contacts. _(DOMString)_ (Default: "")
+- __multiple:__ Indique si la recherche doit retourner plusieurs contacts. _(Boolean)_ (Default: false)
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/contacts/parameters/contactSuccess.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/contacts/parameters/contactSuccess.md b/docs/fr/1.3.0/phonegap/contacts/parameters/contactSuccess.md
new file mode 100644
index 0000000..b3a8e6f
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/contacts/parameters/contactSuccess.md
@@ -0,0 +1,21 @@
+contactSuccess
+==============
+
+Fonction de callback onSuccess qui fournit un tableau de `Contact` résultant d'un appel à `contacts.find`.
+
+    function(contacts) {
+        // Faire quelquechose
+    }
+
+Paramètres
+----------
+
+- __contacts:__ Le tableau de `Contact` résultant d'une recherche. (`Contact`)
+
+Exemple
+-------
+
+    function contactSuccess(contacts) {
+		for (var i=0; i<contacts.length; i++) {
+			console.log("Nom d'affichage du contact = " + contacts[i].displayName;
+    }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/device/device.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/device/device.md b/docs/fr/1.3.0/phonegap/device/device.md
new file mode 100644
index 0000000..905e175
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/device/device.md
@@ -0,0 +1,23 @@
+Device
+======
+
+> L'objet `device` fournit des informations sur les aspects matériels et logiciels du mobile.
+
+Propriétés
+----------
+
+- device.name
+- device.phonegap
+- device.platform
+- device.uuid
+- device.version
+
+Portée de la variable
+---------------------
+
+Puisque `device` est attaché à l'objet `window`, il a implicitement une portée globale.
+
+    // Ces deux exemples pointent vers le même `device`
+    //
+    var phoneName = window.device.name;
+    var phoneName = device.name;
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/device/device.name.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/device/device.name.md b/docs/fr/1.3.0/phonegap/device/device.name.md
new file mode 100644
index 0000000..b54089c
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/device/device.name.md
@@ -0,0 +1,79 @@
+device.name
+===========
+
+Récupère le nom de modèle du mobile.
+
+    var string = device.name;
+    
+Description
+-----------
+
+`device.name` retourne le nom du modèle du mobile ou du produit. Cette valeur est renseignée par le constructeur et peut différer d'une version à une autre d'un même produit.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+- Windows Phone 7 ( Mango )
+
+Exemple rapide
+--------------
+
+    // Android:    Nexus One       retourne "Passion" (nom de code de Nexus One)
+    //             Motorola Droid  retourne "voles"
+    // BlackBerry: Bold 8900       retourne "8900"
+    // iOS:        Tous modèles    retourne le nom défini via iTunes, par exemple "iPhone de Joe"
+    //
+    var name = device.name;
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Device</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+    
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' + 
+                                'Device PhoneGap: ' + device.phonegap + '<br />' + 
+                                'Device Platform: ' + device.platform + '<br />' + 
+                                'Device UUID: '     + device.uuid     + '<br />' + 
+                                'Device Version: '  + device.version  + '<br />';
+        }
+
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Chargement des propriétés du mobile...</p>
+      </body>
+    </html>
+
+
+Singularités Android
+--------------------
+
+- Récupère le nom de produit [product](http://developer.android.com/reference/android/os/Build.html#PRODUCT) au lieu du nom de modèle [model](http://developer.android.com/reference/android/os/Build.html#MODEL).
+    - Le nom de produit correspond souvent au nom de code donné au modèle lors de sa production.
+    - Par exemple Nexus One retourne "Passion", Motorola Droid retourne "voles"
+
+Singularités iOS
+----------------
+
+- Récupère le nom du mobile [name](http://developer.apple.com/library/ios/#documentation/uikit/reference/UIDevice_Class/Reference/UIDevice.html#//apple_ref/doc/uid/TP40006902-CH3-SW13) au lieu du nom de modèle [model](http://developer.apple.com/library/ios/#documentation/uikit/reference/UIDevice_Class/Reference/UIDevice.html#//apple_ref/doc/uid/TP40006902-CH3-SW1).
+    - Le nom du mobile est défini par son propriétaire via iTunes.
+    - Par exemple "iPhone de Joe"
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/device/device.phonegap.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/device/device.phonegap.md b/docs/fr/1.3.0/phonegap/device/device.phonegap.md
new file mode 100644
index 0000000..673dda1
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/device/device.phonegap.md
@@ -0,0 +1,60 @@
+device.phonegap
+===============
+
+Récupère la version de PhoneGap de l'application.
+
+    var string = device.phonegap;
+    
+Description
+-----------
+
+`device.phonegap` retourne la version de PhoneGap de l'application.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+- Windows Phone 7 ( Mango )
+
+Exemple rapide
+--------------
+
+    var name = device.phonegap;
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Device</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+    
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' + 
+                                'Device PhoneGap: ' + device.phonegap + '<br />' + 
+                                'Device Platform: ' + device.platform + '<br />' + 
+                                'Device UUID: '     + device.uuid     + '<br />' + 
+                                'Device Version: '  + device.version  + '<br />';
+        }
+
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Chargement des propriétés du mobile...</p>
+      </body>
+    </html>
+    
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/device/device.platform.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/device/device.platform.md b/docs/fr/1.3.0/phonegap/device/device.platform.md
new file mode 100644
index 0000000..b81dae2
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/device/device.platform.md
@@ -0,0 +1,70 @@
+device.platform
+===============
+
+Récupère le nom du système d'exploitation du mobile.
+
+    var string = device.platform;
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+- Windows Phone 7 ( Mango )
+
+Exemple rapide
+--------------
+
+    // Exemples de valeurs retournées en fonction du mobile :
+    //   - "Android"
+    //   - "BlackBerry"
+    //   - "iPhone"
+    //   - "webOS"
+    //   - "WinCE"
+    var devicePlatform = device.platform;
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Device</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+    
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' + 
+                                'Device PhoneGap: ' + device.phonegap + '<br />' + 
+                                'Device Platform: ' + device.platform + '<br />' + 
+                                'Device UUID: '     + device.uuid     + '<br />' + 
+                                'Device Version: '  + device.version  + '<br />';
+        }
+
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Chargement des propriétés du mobile...</p>
+      </body>
+    </html>
+    
+Singularités iOS
+----------------
+
+C'est le nom du produit (`iPhone`, `iPad` ou `iPod touch`) qui est retourné et non le nom du système d'exploitation, à savoir `iOS`.
+
+Singularités BlackBerry
+-----------------------
+
+Sur certains mobiles, c'est la version de la plateforme qui est retournée et non le nom du système d'exploitation.  Par exemple, le Storm2 9550 retourne une valeur du style '2.13.0.95'. 
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/device/device.uuid.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/device/device.uuid.md b/docs/fr/1.3.0/phonegap/device/device.uuid.md
new file mode 100644
index 0000000..985c19e
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/device/device.uuid.md
@@ -0,0 +1,71 @@
+device.uuid
+===========
+
+Récupère le Universally Unique Identifier ([UUID](http://fr.wikipedia.org/wiki/Universal_Unique_Identifier)) du mobile.
+
+    var string = device.uuid;
+    
+Description
+-----------
+
+Les détails sur la façon dont un UUID est généré sont déterminés par le fabricant et spécifiques à la plateforme ou au modèle de l'appareil.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+- Windows Phone 7 ( Mango )
+
+Exemple rapide
+--------------
+
+    // Android: Retourne un entier aléatoire de 64 bits (sous forme de chaîne de caractères !)
+    //          Cet entier est généré au premier démarrage du mobile.
+    //
+    // BlackBerry: Retourne le numéro PIN du mobile.
+    //             Il s'agit d'un entier unique à neuf chiffres (mais sous forme de chaîne de caractères !)
+    //
+    // iPhone: (Tiré de la documentation de la classe UIDevice)
+    //         Retourne une chaîne de hachage produite à partir de multiples identifiants matériels.
+    //         Son unicité est garantie pour chaque mobile et ne peut être liée au compte utilisateur.
+    // Windows Phone 7 : Retourne un hachage du mobile+utilisateur,
+    // si l'utilisateur n'est pas défini, un GUID est généré et sera conservé jusqu'à ce que l'application soit désinstallée.
+    // 
+    var deviceID = device.uuid;
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Device</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+    
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' + 
+                                'Device PhoneGap: ' + device.phonegap + '<br />' + 
+                                'Device Platform: ' + device.platform + '<br />' + 
+                                'Device UUID: '     + device.uuid     + '<br />' + 
+                                'Device Version: '  + device.version  + '<br />';
+        }
+
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Chargement des propriétés du mobile...</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/device/device.version.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/device/device.version.md b/docs/fr/1.3.0/phonegap/device/device.version.md
new file mode 100644
index 0000000..07a512a
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/device/device.version.md
@@ -0,0 +1,63 @@
+device.version
+==============
+
+Récupère la version du système d'exploitation.
+
+    var string = device.version;
+
+Plateformes supportées
+----------------------
+
+- Android 2.1+
+- BlackBerry
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+- Windows Phone 7 ( Mango )
+
+Exemple rapide
+--------------
+
+    // Android:    Froyo retourne "2.2"
+    //             Eclair retourne "2.1", "2.0.1", or "2.0"
+    //             La version peut aussi retourner la mise à jour "2.1-update1" 
+    //
+    // BlackBerry: Bold 9000 sous OS 4.6 retourne "4.6.0.282"
+    //
+    // iOS:        iOS 3.2 retourne "3.2"
+    //
+    // Windows Phone 7: retourne le numéro de version courant du système d'exploitation, par exemple "7.10.7720" sous Mango.
+    var deviceVersion = device.version;
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple Device</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Attendre que PhoneGap soit prêt
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+
+        // PhoneGap est prêt
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+    
+            element.innerHTML = 'Device Name: '     + device.name     + '<br />' + 
+                                'Device PhoneGap: ' + device.phonegap + '<br />' + 
+                                'Device Platform: ' + device.platform + '<br />' + 
+                                'Device UUID: '     + device.uuid     + '<br />' + 
+                                'Device Version: '  + device.version  + '<br />';
+        }
+
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Chargement des propriétés du mobile...</p>
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.backbutton.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.backbutton.md b/docs/fr/1.3.0/phonegap/events/events.backbutton.md
new file mode 100644
index 0000000..1f993e3
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.backbutton.md
@@ -0,0 +1,67 @@
+backbutton
+===========
+
+Cet évènement est déclenché lorsque l'utilisateur appuie sur le bouton retour.
+
+    document.addEventListener("backbutton", yourCallbackFunction, false);
+
+Détails
+-------
+
+Si vous avez besoin de redéfinir le comportement par défaut du bouton retour, il vous suffit d'associer une fonction à l'évènement 'backbutton'. Il n'est désormais plus nécessaire de faire appel à d'autres fonctions pour redéfinir le comportement du bouton retour. Maintenant, il suffit d'associer une fonction à l'évènement 'backbutton'.
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `document.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+
+Exemple rapide
+--------------
+
+    document.addEventListener("backbutton", onBackKeyDown, false);
+
+    function onBackKeyDown() {
+        // Gérer le bouton retour
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement backbutton PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+            // Ajout d'un écouteur d'évènement
+            document.addEventListener("backbutton", onBackKeyDown, false);
+        }
+        
+        // Gérer le bouton retour
+        //
+        function onBackKeyDown() {
+        }
+
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.batterycritical.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.batterycritical.md b/docs/fr/1.3.0/phonegap/events/events.batterycritical.md
new file mode 100644
index 0000000..6b6b65c
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.batterycritical.md
@@ -0,0 +1,74 @@
+batterycritical
+===============
+
+Cet évènement est déclenché lorsqu'une application PhoneGap détecte que la batterie a atteint le seuil de niveau critique.
+
+    window.addEventListener("batterycritical", yourCallbackFunction, false);
+
+Détails
+-------
+
+Cet évènement est déclenché lorsqu'une application PhoneGap détecte que le pourcentage du niveau de batterie est passé sous le seuil critique. Ce seuil est spécifique au mobile.
+
+La fonction associée à l'évènement batterycritical est appelée avec en argument un objet contenant deux propriétés :
+
+- __level:__ Le pourcentage de batterie restante (0-100). _(Number)_
+- __isPlugged:__ Un booléen indiquant si le mobile est branché ou non. _(Boolean)_
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `window.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- iOS
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+
+Exemple rapide
+--------------
+
+    window.addEventListener("batterycritical", onBatteryCritical, false);
+
+    function onBatteryCritical(info) {
+        // Gérer l'évènement batterycritical
+       	alert("Niveau de batterie critique " + info.level + "%\nRechargez vite!"); 
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement batterycritical PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        // 
+	    function onLoad() {
+    	    document.addEventListener("deviceready", onDeviceReady, false);
+    	}
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+		    window.addEventListener("batterycritical", onBatteryCritical, false);
+        }
+
+        // Gérer l'évènement batterycritical
+        //
+        function onBatteryCritical(info) {
+	       	alert("Niveau de batterie critique " + info.level + "%\nRechargez vite!"); 
+        }
+        
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.batterylow.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.batterylow.md b/docs/fr/1.3.0/phonegap/events/events.batterylow.md
new file mode 100644
index 0000000..d8b0561
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.batterylow.md
@@ -0,0 +1,74 @@
+batterylow
+==========
+
+Cet évènement est déclenché lorsqu'une application PhoneGap détecte que la batterie a atteint le seuil de niveau bas.
+
+    window.addEventListener("batterylow", yourCallbackFunction, false);
+
+Détails
+-------
+
+Cet évènement est déclenché lorsqu'une application PhoneGap détecte que le pourcentage du niveau de batterie est passé sous le seuil bas. Ce seuil est spécifique au mobile.
+
+La fonction associée à l'évènement batterylow est appelée avec en argument un objet contenant deux propriétés :
+
+- __level:__ Le pourcentage de batterie restante (0-100). _(Number)_
+- __isPlugged:__ Un booléen indiquant si le mobile est branché ou non. _(Boolean)_
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `window.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- iOS
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+
+Exemple rapide
+--------------
+
+    window.addEventListener("batterylow", onBatteryLow, false);
+
+    function onBatteryLow(info) {
+        // Gérer l'évènement batterylow
+       	alert("Niveau de batterie bas " + info.level + "%"); 
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement batterylow PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        // 
+	    function onLoad() {
+    	    document.addEventListener("deviceready", onDeviceReady, false);
+    	}
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+		    window.addEventListener("batterylow", onBatteryLow, false);
+        }
+
+        // Gérer l'évènement batterylow
+        //
+        function onBatteryLow(info) {
+	       	alert("Niveau de batterie bas " + info.level + "%"); 
+        }
+        
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.batterystatus.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.batterystatus.md b/docs/fr/1.3.0/phonegap/events/events.batterystatus.md
new file mode 100644
index 0000000..6e646a5
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.batterystatus.md
@@ -0,0 +1,74 @@
+batterystatus
+=============
+
+Cet évènement est déclenché lorsqu'une application PhoneGap détecte que le niveau de la batterie a bougé.
+
+    window.addEventListener("batterystatus", yourCallbackFunction, false);
+
+Détails
+-------
+
+Cet évènement est déclenché lorsqu'une application PhoneGap détecte que le niveau de batterie a changé d'au moins 1 pourcent. Il est également déclenché lorsque le mobile est branché ou débranché.
+
+La fonction associée à l'évènement batterystatus est appelée avec en argument un objet contenant deux propriétés :
+
+- __level:__ Le pourcentage de batterie restante (0-100). _(Number)_
+- __isPlugged:__ Un booléen indiquant si le mobile est branché ou non. _(Boolean)_
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `window.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- iOS
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+
+Exemple rapide
+--------------
+
+    window.addEventListener("batterystatus", onBatteryStatus, false);
+
+    function onBatteryStatus(info) {
+        // Gérer l'évènement batterystatus
+       	console.log("Level : " + info.level + " isPlugged : " + info.isPlugged); 
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement batterystatus PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        // 
+	    function onLoad() {
+    	    document.addEventListener("deviceready", onDeviceReady, false);
+    	}
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+		    window.addEventListener("batterystatus", onBatteryStatus, false);
+        }
+
+        // Gérer l'évènement batterystatus
+        //
+        function onBatteryStatus(info) {
+        	console.log("Level: " + info.level + " isPlugged: " + info.isPlugged); 
+        }
+        
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.deviceready.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.deviceready.md b/docs/fr/1.3.0/phonegap/events/events.deviceready.md
new file mode 100644
index 0000000..d32abdb
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.deviceready.md
@@ -0,0 +1,92 @@
+deviceready
+===========
+
+Cet évènement est déclenché lorsque PhoneGap est entièrement chargé.
+
+    document.addEventListener("deviceready", yourCallbackFunction, false);
+
+Détails
+-------
+
+Il s'agit d'un évènement très important que toute application PhoneGap devrait utiliser.
+
+Le code de PhoneGap est composé de deux parties : la partie native et JavaScript. Pendant le chargement de la partie native, une image de chargement est affichée. En revanche, la partie JavaScript est chargée uniquement avec le DOM. Cela signifie que votre application web pourait , éventuellement, faire appel à des fonctions de PhoneGap avant que celui-ci ne soit chargé.
+
+L'évènement PhoneGap `deviceready` est déclenché une fois PhoneGap entièrement chargé. Une fois cet évènement déclenché, vous pouvez sans crainte faire appel aux fonctions PhoneGap.
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `document.addEventListener` dès le chargement du DOM de la page HTML chargé.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+
+    function onDeviceReady() {
+        // L'API PhoneGap est maintenant utilisable sans risque.
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement deviceready PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+        	// L'API PhoneGap est maintenant utilisable sans risque.
+        }
+
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
+    
+Singularités BlackBerry (OS 4.6)
+--------------------------------
+
+Les évènements personnalisés ne sont pas supportés par le RIM BrowserField (vue navigateur web), l'évènement `deviceready` ne sera donc jamais déclenché. 
+
+Une solution de contournement consiste à scruter manuellement `PhoneGap.available` jusqu'à ce que PhoneGap soit entièrement chargé.
+
+    function onLoad() {
+        // Le navigateur de BlackBerry OS 4 ne gère pas les évènements personnalisés.
+        // On va donc attendre manuellement que PhoneGap soit disponible.
+        //
+        var intervalID = window.setInterval(
+          function() {
+              if (PhoneGap.available) {
+                  window.clearInterval(intervalID);
+                  onDeviceReady();
+              }
+          },
+          500
+        );
+    }
+
+    function onDeviceReady() {
+        // L'API PhoneGap est maintenant utilisable sans risque.
+    }

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.endcallbutton.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.endcallbutton.md b/docs/fr/1.3.0/phonegap/events/events.endcallbutton.md
new file mode 100644
index 0000000..5cc04ed
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.endcallbutton.md
@@ -0,0 +1,66 @@
+endcallbutton
+===========
+
+Cet évènement est déclenché lorsque l'utilisateur appuie sur le bouton raccrocher.
+
+    document.addEventListener("endcallbutton", yourCallbackFunction, false);
+
+Détails
+-------
+
+Si vous avez besoin de redéfinir le comportement par défaut du bouton raccrocher, il vous suffit d'associer une fonction à l'évènement 'endcallbutton'.
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `document.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+
+Exemple rapide
+--------------
+
+    document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+
+    function onEndCallKeyDown() {
+        // Gérer le bouton raccrocher
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement endcallbutton PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+            // Ajout d'un écouteur d'évènement
+            document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+        }
+
+        // Gérer le bouton raccrocher
+        //
+        function onEndCallKeyDown() {
+        }
+
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.md b/docs/fr/1.3.0/phonegap/events/events.md
new file mode 100644
index 0000000..3aad923
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.md
@@ -0,0 +1,24 @@
+Events
+======
+
+> Évènements PhoneGap.
+
+Types d'évènements
+------------------
+
+- deviceready
+- pause
+- resume
+- online
+- offline
+- backbutton
+- batterycritical
+- batterylow
+- batterystatus
+- menubutton
+- searchbutton
+- startcallbutton
+- endcallbutton
+- volumedownbutton
+- volumeupbutton
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.menubutton.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.menubutton.md b/docs/fr/1.3.0/phonegap/events/events.menubutton.md
new file mode 100644
index 0000000..485d884
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.menubutton.md
@@ -0,0 +1,67 @@
+menubutton
+===========
+
+Cet évènement est déclenché lorsque l'utilisateur appuie sur le bouton menu.
+
+    document.addEventListener("menubutton", yourCallbackFunction, false);
+
+Détails
+-------
+
+Si vous avez besoin de redéfinir le comportement par défaut du bouton raccrocher, il vous suffit d'associer une fonction à l'évènement 'menubutton'.
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `document.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+
+Exemple rapide
+--------------
+
+    document.addEventListener("menubutton", onMenuKeyDown, false);
+
+    function onMenuKeyDown() {
+        // Gérer le bouton menu
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement menubutton PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("menubutton", onMenuKeyDown, false);
+        }
+
+        // Gérer le bouton menu
+        //
+        function onMenuKeyDown() {
+        }
+
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.offline.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.offline.md b/docs/fr/1.3.0/phonegap/events/events.offline.md
new file mode 100644
index 0000000..ae3d819
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.offline.md
@@ -0,0 +1,71 @@
+offline
+=======
+
+Cet évènement est déclenché lorsque l'application PhoneGap est offline (déconnectée d'internet).
+
+    document.addEventListener("offline", yourCallbackFunction, false);
+
+Détails
+-------
+
+Lorsque la connexion réseau de l'application change d'état et devient indisponible, l'évènement 'offline' est déclenché.
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `document.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+    document.addEventListener("offline", onOffline, false);
+
+    function onOffline() {
+        // Gérer l'évènement offline
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement offline PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+		    document.addEventListener("offline", onOffline, false);
+        }
+
+        // Gérer l'évènement offline
+        //
+        function onOffline() {
+        }
+
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
+
+Singularités iOS
+----------------
+Lors du démarrage initial, le premier événement offline (si applicable) prend au moins une seconde à être déclenché.

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/01675109/docs/fr/1.3.0/phonegap/events/events.online.md
----------------------------------------------------------------------
diff --git a/docs/fr/1.3.0/phonegap/events/events.online.md b/docs/fr/1.3.0/phonegap/events/events.online.md
new file mode 100644
index 0000000..dfca53a
--- /dev/null
+++ b/docs/fr/1.3.0/phonegap/events/events.online.md
@@ -0,0 +1,71 @@
+online
+======
+
+Cet évènement est déclenché lorsque l'application PhoneGap est online (connectée à internet).
+
+    document.addEventListener("online", yourCallbackFunction, false);
+
+Détails
+-------
+
+Lorsque la connexion réseau de l'application change d'état et devient disponible, l'évènement 'online' est déclenché.
+
+Généralement, il vous faudra ajouter un écouteur d'évènement via `document.addEventListener` après réception de l'évènement PhoneGap 'deviceready'.
+
+Plateformes supportées
+----------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 ou plus récent)
+- iOS
+
+Exemple rapide
+--------------
+
+    document.addEventListener("online", onOnline, false);
+
+    function onOnline() {
+        // Gérer l'évènement online
+    }
+
+Exemple complet
+---------------
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Exemple évènement online PhoneGap</title>
+
+        <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
+        <script type="text/javascript" charset="utf-8">
+
+        // Appeler onDeviceReady lorsque PhoneGap est prêt.
+        //
+        // Pour le moment, le document est chargé mais pas phonegap.js.
+        // Lorsque PhoneGap sera chargé et capable de communiquer avec la partie native du mobile,
+        // il déclenchera l'évènement `deviceready`.
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+
+        // PhoneGap est chargé et il est maintenant possible d'appeler des fonctions PhoneGap
+        //
+        function onDeviceReady() {
+		    document.addEventListener("online", onOnline, false);
+        }
+
+        // Gérer l'évènement online
+        //
+        function onOnline() {
+        }
+
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
+
+Singularités iOS
+----------------
+Lors du démarrage initial, le premier événement online (si applicable) prend au moins une seconde à être déclenché.


Mime
View raw message