By using a bookmarklet
----------------------
-On the ``Howto`` page, you have a ``Bookmarklet`` tab. Drag and drop the ``bag it!`` link to your bookmarks bar of your browser.
+On the ``Howto`` page, you have a ``Bookmarklet`` tab. Drag and drop the ``bag it!``
+link to your bookmarks bar of your browser.
-Now, each time you're reading an article on the web and you want to save it, click on the ``bag it!`` link in your bookmarks bar. The article is saved.
+Now, each time you're reading an article on the web and you want to save it,
+click on the ``bag it!`` link in your bookmarks bar. The article is saved.
By using the classic form
-------------------------
-In the top bar of your screen, you have 3 icons. With the first one, a plus sign, you can easily save a new article.
+In the top bar of your screen, you have 3 icons. With the first one, a plus sign,
+you can easily save a new article.
.. image:: ../../img/user/topbar.png
:alt: Top bar
:align: center
-Click on it to display a new field, paste the article URL inside and press your ``Return`` key. The article is saved.
+Click on it to display a new field, paste the article URL inside and press your
+``Return`` key. The article is saved.
By using a browser add-on
-------------------------
iOS
~~~
-*This application is not yet available for wallabag v2*.
\ No newline at end of file
+*This application is not yet available for wallabag v2*.
Import your data into wallabag 2.x
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Click on ``Import`` link in the menu, select your export file on your computer and import it.
+Click on ``Import`` link in the menu, choose the right wallabag version,
+select your export file on your computer and import it.
.. image:: ../../img/user/import_wllbg.png
:alt: Import from wallabag 1.x
From Pocket
-----------
-Create a new applicaton on Pocket
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Create a new application on Pocket
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-To import your data from Pocket, we use the Pocket API. You need to create a new application on their developer website to continue.
+To import your data from Pocket, we use the Pocket API. You need to create
+a new application on their developer website to continue.
* Create a new application `on the developer website <https://getpocket.com/developer/apps/new>`_
-* Fill in the required fields: application name, application description, permissions (only **retrieve**), platform (**web**), accept the terms of service and submit your new application
+* Fill in the required fields: application name, application description,
+ permissions (only **retrieve**), platform (**web**), accept the terms of service
+ and submit your new application
-Pocket will give you a **Consumer Key** (for example, `49961-985e4b92fe21fe4c78d682c1`). You need to configure the ``pocket_consumer_key`` into the ``app/config/parameters.yml`` file in wallabag.
+Pocket will give you a **Consumer Key** (for example, `49961-985e4b92fe21fe4c78d682c1`).
+You need to configure the ``pocket_consumer_key`` into the ``app/config/parameters.yml`` file in wallabag.
Now, all is fine to migrate from Pocket.
Import your data into wallabag 2.x
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Click on ``Import`` link in the menu, on ``Import contents`` in Pocket section and then on ``Connect to Pocket and import data``.
+Click on ``Import`` link in the menu, on ``Import contents`` in Pocket section
+and then on ``Connect to Pocket and import data``.
-You need to authorize wallabag to interact with your Pocket account. Your data will be imported. Data import can be a demanding process for your server (we need to work on this import to improve it).
+You need to authorize wallabag to interact with your Pocket account.
+Your data will be imported. Data import can be a demanding process for your server
+(we need to work on this import to improve it).
From Instapaper
---------------
user/create_account
user/login
user/configuration
+ user/first_article
+ user/import
user/download_articles
user/filters
user/tags
--- /dev/null
+Sauvegardez votre premier article
+=================================
+
+La fonctionnalité principale de wallabag est de sauvegarder des articles.
+Vous avez plusieurs manières de le faire.
+
+.. note::
+
+ Un guide de démarrage s'affichera dans l'application jusqu'à ce que vous
+ enregistriez votre premier article.
+
+En utilisant le bookmarklet
+---------------------------
+
+Sur la page ``Aide``, vous avez un onglet ``Bookmarklet``. Glissez/déposez le lien ``bag it!``
+dans votre barre de favoris de votre navigateur.
+
+Maintennat, à chaque fois que vous lisez un article et que vous souhaitez le sauvegarder,
+cliquez sur le lien ``bag it!`` dans votre barre de favoris. L'article est enregistré.
+
+En utilisant le formulaire classique
+------------------------------------
+
+Dans la barre haut de wallabag, vous avez trois icônes. Avec la première icône,
+un signe plus, vous pouvez facilement ajouter un nouvel article.
+
+.. image:: ../../img/user/topbar.png
+ :alt: Top bar
+ :align: center
+
+Cliquez dessus pour afficher un nouveau champ, collez-y l'URL de l'article et appuyez
+sur la touche ``Entrée``. L'article est enregistré.
+
+En utilisant l'extension de votre navigateur
+--------------------------------------------
+
+Firefox
+~~~~~~~
+
+*Cette extension n'est pas encore disponible pour wallabag v2*.
+
+Chrome
+~~~~~~
+
+*Cette extension n'est pas encore disponible pour wallabag v2*.
+
+En utilisant l'application de votre smartphone
+----------------------------------------------
+
+Android
+~~~~~~~
+
+*Cette application n'est pas encore disponible pour wallabag v2*.
+
+Firefox OS
+~~~~~~~~~~
+
+*Cette application n'est pas encore disponible pour wallabag v2*.
+
+Windows Phone
+~~~~~~~~~~~~~
+
+*Cette application n'est pas encore disponible pour wallabag v2*.
+
+iOS
+~~~
+
+*Cette application n'est pas encore disponible pour wallabag v2*.
--- /dev/null
+Migrer à wallabag
+=================
+
+Depuis wallabag
+---------------
+
+Exportez vos données de wallabag 1.x
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sur la page de configuration, cliquez sur ``Export JSON`` dans la section ``Exportez vos données wallabag``.
+
+.. image:: ../../img/user/export_wllbg_1.png
+ :alt: Export from wallabag 1.x
+ :align: center
+
+Vous obtiendrez un fichier ``wallabag-export-1-1970-01-01.json``.
+
+Exportez vos données de wallabag 2.x
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Dans la barre latérale de téléchargement, cliquez sur ``JSON``.
+
+.. image:: ../../img/user/export_wllbg_2.png
+ :alt: Export from wallabag 2.x
+ :align: center
+
+Vous obtiendrez un fichier ``Unread articles.json``.
+
+Importez vos données wallabag 2.x
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Cliquez sur le lien ``Importer`` dans le menu, choisissez la version de wallabag correspondante,
+sélectionnez votre fichier d'export sur votre ordinateur et importez-le.
+
+.. image:: ../../img/user/import_wllbg.png
+ :alt: Import from wallabag 1.x
+ :align: center
+
+Tous vos articles wallabag seront importés.
+
+Depuis Pocket
+-------------
+
+Créer une nouvelle application dans Pocket
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Pour importer vos données depuis Pocket, nous utilisons l'API de Pocket.
+Vous devez créer une nouvelle application sur leur site dédié aux développeurs pour continuer.
+
+* Créez une nouvelle application `sur leur site Développeurs <https://getpocket.com/developer/apps/new>`_
+* Remplissez les champs requis : nom de l'application, description de l'application,
+ permissions (seulement **retrieve**), la plateforme (**web**), acceptez les
+ termes d'utilisation du service et soumettez votre application
+
+Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`).
+Vous devez configurer la ``pocket_consumer_key`` dans le fichier ``app/config/parameters.yml``.
+
+Maintenant, tout est bien configuré pour migrer depuis Pocket.
+
+Importez vos données dans wallabag 2.x
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Cliquez sur le lien ``Importer`` dans le menu, sur ``Importer les contenus`` dans
+la section Pocket puis sur ``Se connecter à Pocket et importer les données``.
+
+Vous devez autoriser wallabag à se connecter à votre compte Pocket.
+Vos données vont être importées. L'import de données est une action qui peut être couteuse
+pour votre serveur (nous devons encore travailler pour améliorer cet import).
+
+Depuis Instapaper
+-----------------
+
+*Fonctionnalité pas encore implémentée dans wallabag v2.*
+
+Depuis Readability
+------------------
+
+*Fonctionnalité pas encore implémentée dans wallabag v2.*
+
+Depuis un fichier HTML ou JSON
+------------------------------
+
+*Fonctionnalité pas encore implémentée dans wallabag v2.*