docs/en/User/import_export.rst

   1 .. _`Import / Export`:
   2
   3 Import and export data
   4 ======================
   5
   6 Import
   7 ------
   8
   9 To import data in wallabag, go to the page **Configuration**.
  10
  11 Caution
  12 ~~~~~~~
  13
  14 Data import can be a **demanding process** for your server. Hence, it is
  15 done in two steps:
  16
  17 -  Insertion of the URL in the wallabag database
  18 -  in the second step, the retrieval, for each article, of its full
  19    content.
  20
  21 These two steps cannot be done concurrently, because it let us the
  22 possibility to import thousands of links, but today, wallabag does not
  23 have sufficient technical capabilities to do this task automatically.
  24
  25 From Pocket
  26 ~~~~~~~~~~~
  27
  28 Export your data from Pocket
  29 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  30
  31 From your Pocket account, go to the options. TODO
  32
  33 Import your Pocket data
  34 ^^^^^^^^^^^^^^^^^^^^^^^
  35
  36 From the configuration page of wallabag, section **Import**, select the
  37 file ``ril_export.html`` generated by Pocket, then click on **Import**.
  38 Wallabag only insert these links in the database. Now, you have to get
  39 the content of each article.
  40
  41 For this, click on ``Click to finish import``: wallabag will fetch the
  42 content of 10 articles at a time.
  43
  44 TODO
  45
  46 TODO new ticket: why when a click is done, this does not load in a loop?
  47 I believe this was doing this ping @mariroz
  48
  49 From Instapaper
  50 ~~~~~~~~~~~~~~~
  51
  52 Export your data from Instapaper
  53 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  54
  55 TODO
  56
  57 Import your Instapaper data
  58 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  59
  60 TODO
  61
  62 From Readability
  63 ~~~~~~~~~~~~~~~~
  64
  65 Export your data from Readability
  66 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  67
  68 TODO
  69
  70 Import your Readability data
  71 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  72
  73 TODO
  74
  75 From wallabag
  76 ~~~~~~~~~~~~~
  77
  78 Since you can export your data from wallabag (see below), it is of
  79 course possible to re-import them.
  80
  81 In the import form, select your wallabag-exported file (format JSON).
  82 Start the import, et voilà.
  83
  84 Unlike the above imports, this process is shorter because all the data
  85 (title and content of the articles) are already included in the file.
  86 Hence wallabag does not have to access each URL. However, the import
  87 file is necessarily bigger.
  88
  89 From a HTML or JSON file
  90 ~~~~~~~~~~~~~~~~~~~~~~~~
  91
  92 TODO
  93
  94 Export
  95 ------
  96
  97 It is possible to export your data from the page **Configuration** of
  98 wallabag. Several reasons to do this:
  99
 100 -  re-install of wallabag
 101 -  leave the Framabag service to install your own wallabag
 102 -  a user with an account on a multi-user wallabag want to have his/her
 103    own wallabag installation
 104 -  ...
 105
 106 This will lead you to download a file `at the JSON
 107 format <http://en.wikipedia.org/wiki/JavaScript_Object_Notation>`__. As detailed above, you can import this file in wallabag.