docs/fr/user/import.rst

   1 Migrer depuis ...
   2 =================
   3
   4 Dans wallabag 2.x, vous pouvez importer des données depuis :
   5
   6 - `Pocket <#id1>`_
   7 - `Readability <#id2>`_
   8 - `Instapaper <#id4>`_
   9 - `wallabag 1.x <#id6>`_
  10 - `wallabag 2.x <#id7>`_
  11
  12 Nous avons aussi développé `un script pour exécuter des migrations via la ligne de commande <#import-via-la-ligne-de-commande-cli>`_.
  13
  14 Puisque les imports peuvent gourmands en ressource, nous avons mis en place un système de tâche asynchrone. `Vous trouverez la documentation ici <http://doc.wallabag.org/fr/master/developer/asynchronous.html>`_ (niveau expert).
  15
  16 Pocket
  17 ------
  18
  19 Créer une nouvelle application dans Pocket
  20 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  21
  22 Pour importer vos données depuis Pocket, nous utilisons l'API de Pocket.
  23 Vous devez créer une nouvelle application sur leur site dédié aux développeurs pour continuer.
  24
  25 * Créez une nouvelle application `sur leur site Développeurs <https://getpocket.com/developer/apps/new>`_
  26 * Remplissez les champs requis : nom de l'application, description de l'application,
  27   permissions (seulement **retrieve**), la plateforme (**web**), acceptez les
  28   termes d'utilisation du service et soumettez votre application
  29
  30 Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`).
  31 Vous devez configurer la ``pocket_consumer_key`` dans le menu ``Configuration``.
  32
  33 Maintenant, tout est bien configuré pour migrer depuis Pocket.
  34
  35 Importez vos données dans wallabag 2.x
  36 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  37
  38 Cliquez sur le lien ``Importer`` dans le menu, sur  ``Importer les contenus`` dans
  39 la section Pocket puis sur ``Se connecter à Pocket et importer les données``.
  40
  41 Vous devez autoriser wallabag à se connecter à votre compte Pocket.
  42 Vos données vont être importées. L'import de données est une action qui peut être couteuse
  43 pour votre serveur.
  44
  45 Readability
  46 -----------
  47
  48 Exportez vos données de Readability
  49 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50
  51 Sur la page des outils (`https://www.readability.com/tools/ <https://www.readability.com/tools/>`_), cliquez sur "Export your data" dans la section "Data Export". Vous allez recevoir un email avec un lien pour télécharger le json.
  52
  53 Importez vos données dans wallabag 2.x
  54 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55
  56 Cliquez sur le lien ``Importer`` dans le menu, sur  ``Importer les contenus`` dans
  57 la section Readability et ensuite sélectionnez votre fichier json pour l'uploader.
  58
  59 Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur.
  60
  61 Depuis Pinboard
  62 ---------------
  63
  64 Exportez vos données de Pinboard
  65 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  66
  67 Sur la page « Backup » (`https://pinboard.in/settings/backup <https://pinboard.in/settings/backup>`_), cliquez sur « JSON » dans la section « Bookmarks ». Un fichier json (sans extension) sera téléchargé (``pinboard_export``).
  68
  69 Importez vos données dans wallabag 2.x
  70 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71
  72 Cliquez sur le lien ``Importer`` dans le menu, sur  ``Importer les contenus`` dans
  73 la section Pinboard et ensuite sélectionnez votre fichier json pour l'uploader.
  74
  75 Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur.
  76
  77 Depuis Instapaper
  78 -----------------
  79
  80 Exportez vos données de Instapaper
  81 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  82
  83 Sur la page des paramètres (`https://www.instapaper.com/user <https://www.instapaper.com/user>`_), cliquez sur "Download .CSV file" dans la section "Export". Un fichier CSV se téléchargera (``instapaper-export.csv``).
  84
  85 Importez vos données dans wallabag 2.x
  86 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87
  88 Cliquez sur le lien ``Importer`` dans le menu, sur  ``Importer les contenus`` dans
  89 la section Instapaper et ensuite sélectionnez votre fichier CSV pour l'uploader.
  90
  91 Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur.
  92
  93 wallabag 1.x
  94 ------------
  95
  96 Si vous utilisiez wallabag v1.x, vous devez exporter vos données avant de migrer à wallabag v2.x, à cause du changement complet de l'application et de sa base de données. Sur votre ancienne instance de wallabag v1, vous pouvez exporter vos données en allant sur la page de configuration de l'application.
  97
  98 .. image:: ../../img/user/export_v1.png
  99    :alt: Export depuis wallabag v1
 100    :align: center
 101
 102 .. note::
 103     Si vous avez plusieurs comptes sur la même instance de wallabag, chaque utilisateur doit exporter ses données depuis wallabag v1 et les importer dans la v2.
 104
 105 .. note::
 106     S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`_.
 107
 108 Une fois que vous avez récupéré le fichier json contenant vos données, vous pouvez installer wallabag v2 si c'est nécessaire en suivant `la procédure standard <http://doc.wallabag.org/fr/master/user/installation.html>`_.
 109
 110 Une fois que vous avez créé un compte utilisateur sur votre nouvelle instance de wallabag v2, rendez-vous dans la section `Import`. Vous devez choisir l'import depuis wallabag v1 puis sélectionner votre fichier json récupéré précédemment.
 111
 112 .. image:: ../../img/user/import_wallabagv1.png
 113    :alt: Import depuis wallabag v1
 114    :align: center
 115
 116 wallabag 2.x
 117 ------------
 118
 119 Depuis l'instance sur laquelle vous étiez, rendez-vous dans la section `Tous les articles`, puis exportez ces articles au format json.
 120
 121 .. image:: ../../img/user/export_v2.png
 122    :alt: Export depuis wallabag v2
 123    :align: center
 124
 125 Depuis votre nouvelle instance de wallabag, créez votre compte utilisateur puis cliquez sur le lien dans le menu pour accéder à l'import. Choisissez l'import depuis wallabag v2 puis sélectionnez votre fichier json pour l'uploader.
 126
 127 .. note::
 128     S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`_.
 129
 130 Import via la ligne de commande (CLI)
 131 -------------------------------------<http://doc.wallabag.org/en/master/user/parameters.html
 132
 133 Si vous avez accès à la ligne de commandes de votre serveur web, vous pouvez exécuter cette commande pour import votre fichier wallabag v1 :
 134
 135 ::
 136
 137     bin/console wallabag:import 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod
 138
 139 Remplacez les valeurs :
 140
 141 * ``1`` est l'identifiant de votre utilisateur en base (l'ID de votre premier utilisateur créé sur wallabag est 1)
 142 * ``~/Downloads/wallabag-export-1-2016-04-05.json`` est le chemin de votre export wallabag v1
 143
 144 Si vous voulez marquer tous ces articles comme lus, vous pouvez ajouter l'option ``--markAsRead``.
 145
 146 Pour importer un fichier wallabag v2, vous devez ajouter l'option ``--importer=v2``.
 147
 148 Vous obtiendrez :
 149
 150 ::
 151
 152     Start : 05-04-2016 11:36:07 ---
 153     403 imported
 154     0 already saved
 155     End : 05-04-2016 11:36:09 ---