docs/en/user/articles.rst

   1 Articles
   2 ========
   3
   4 Save your first article
   5 -----------------------
   6
   7 The main purpose of wallabag is to save web articles. You have many ways to do it. If you think that the article is wrong displayed, `you can read this documentation <http://doc.wallabag.org/en/master/user/errors_during_fetching.html>`_.
   8
   9 By using a bookmarklet
  10 ^^^^^^^^^^^^^^^^^^^^^^
  11
  12 On the ``Howto`` page, you have a ``Bookmarklet`` tab. Drag and drop the ``bag it!``
  13 link to your bookmarks bar of your browser.
  14
  15 Now, each time you're reading an article on the web and you want to save it,
  16 click on the ``bag it!`` link in your bookmarks bar. The article is saved.
  17
  18 By using the classic form
  19 ^^^^^^^^^^^^^^^^^^^^^^^^^
  20
  21 In the top bar of your screen, you have 3 icons. With the first one, a plus sign,
  22 you can easily save a new article.
  23
  24 .. image:: ../../img/user/topbar.png
  25    :alt: Top bar
  26    :align: center
  27
  28 Click on it to display a new field, paste the article URL inside and press your
  29 ``Return`` key. The article is saved.
  30
  31 By using a browser add-on
  32 ^^^^^^^^^^^^^^^^^^^^^^^^^
  33
  34 Firefox
  35 """""""
  36
  37 You can download the `Firefox addon here <https://addons.mozilla.org/firefox/addon/wallabag-v2/>`_.
  38
  39 Chrome
  40 """"""
  41
  42 You can download the `Chrome addon here <https://chrome.google.com/webstore/detail/wallabagger/gbmgphmejlcoihgedabhgjdkcahacjlj?hl=fr>`_.
  43
  44 By using your smarphone application
  45 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  46
  47 Android
  48 """""""
  49
  50 You can download the `Android application here <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_.
  51
  52 Windows Phone
  53 """""""""""""
  54
  55 You can downlaod the `Windows Phone application here <https://www.microsoft.com/store/apps/9nblggh5x3p6>`_.
  56
  57 Download your articles
  58 ----------------------
  59
  60 You can download each article in several formats: ePUB, MOBI, PDF, XML, JSON, CSV.
  61
  62 On the article view, click on this icon, in the sidebar:
  63
  64 .. image:: ../../img/user/download_article.png
  65    :alt: download article
  66    :align: center
  67
  68 You can also download a full category (unread, starred, archive) in these formats.
  69 For example, on **Unread** view, click on this icon in the top bar:
  70
  71 .. image:: ../../img/user/download_articles.png
  72    :alt: download articles
  73    :align: center
  74
  75 Share your articles
  76 -------------------
  77
  78 When you're reading an article, you can share it. Just click on the share button:
  79
  80 .. image:: ../../img/user/share.png
  81    :alt: share article
  82    :align: center
  83
  84 Now, you can share the article:
  85
  86 - with a public URL (you'll have a light view of the article)
  87 - with a tweet
  88 - into your Shaarli
  89 - with a post in Diaspora*
  90 - to Carrot
  91 - with an email
  92
  93 Annotate your articles
  94 ----------------------
  95
  96 In each article you read, you can write annotations. It's easier to understand with some pictures.
  97
  98 Select the part of the article that you want to annotate and click on the pencil:
  99
 100 .. image:: ../../img/user/annotations_1.png
 101    :alt: Select your text
 102    :align: center
 103
 104 Then, write your annotation:
 105
 106 .. image:: ../../img/user/annotations_2.png
 107    :alt: Write your annotation
 108    :align: center
 109
 110 The text is now highlighted and you can read your annotation if you move the mouse cursor over it.
 111
 112 .. image:: ../../img/user/annotations_3.png
 113    :alt: Read your annotation
 114    :align: center
 115
 116 You can create as many annotations as you wish.