docs/en/User/organize_articles.rst

   1 .. _`Organize articles`:
   2
   3 Organize articles
   4 =================
   5
   6 To be able to find more easily your articles, several methods are
   7 available.
   8
   9 Tags
  10 ----
  11
  12 Assign a tag
  13 ~~~~~~~~~~~~
  14
  15 When saving an article
  16 ^^^^^^^^^^^^^^^^^^^^^^
  17
  18 To tag an article when saving it, just click on the tag icon next to the
  19 URL field before hitting the Save button. At the moment, it is possible
  20 only to do this from the web interface, but it could come to some apps
  21 or extensions.
  22
  23 From the article
  24 ^^^^^^^^^^^^^^^^
  25
  26 To tag an already-saved article, go to the reading page of the article.
  27 There is a part ``tags`` followed with a pencil. Click on the pencil.
  28
  29 Input in the box the tags you want to assign. Add as many tags as you
  30 want. They need to be separated by commas and not spaces.
  31 Auto-completion is available here: when you type the first letters of an
  32 existing tag, it is not necessary to type the whole word. Select it in
  33 the drop-down list. Once all your tags are inputted, click on the button
  34 **Tag**.
  35
  36 Then, you can go back to your article and read it.
  37
  38 From the search
  39 ^^^^^^^^^^^^^^^
  40
  41 A full chapter on search is available. Here, we will describe only how
  42 to assign a tag from your search.
  43
  44 When your search displays results, there is a link
  45 ``Apply the tag ABCD to this search`` at the bottom of the page. Click
  46 on it: a tad depending on your search (here ``ABCD``) will be assigned
  47 to all the articles found.
  48
  49 Find all the articles with a given tag
  50 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  51
  52 In the wallabag menu, click on **Tags**. Then, all the tags you have
  53 created are displayed, sorted by the number of articles for each tag.
  54 Click on one of these tags to find all the articles with this tag.
  55
  56 Preferred articles
  57 ------------------
  58
  59 When you wish to set aside an article, you can mark it as preferred.
  60
  61 Set an article as favorite
  62 ~~~~~~~~~~~~~~~~~~~~~~~~~~
  63
  64 From the reading page of an article, or from a list of articles (such as
  65 the list of unread articles), you can set an article as favorite simply
  66 by a click on the star which is displayed. Click again on the star will
  67 remove the **favorite** status of this article.
  68
  69 Find all the favorite articles
  70 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71
  72 In the wallabag menu, click on **Favorites** to display the list of all
  73 the articles that you have set as favorite.
  74
  75 Archived articles
  76 -----------------
  77
  78 When you have read an article, you can archive it: hence it will not be
  79 displayed in your list of unread articles.
  80
  81 Archiving an article does not remove it from wallabag.
  82
  83 Archive an article
  84 ~~~~~~~~~~~~~~~~~~
  85
  86 | From the reading page of an article, or from a list of articles (such
  87 as the list of unread articles), you can archive an article simply by
  88 clicking on the icon ✓.
  89 | Click again on this icon will set back the **unread** status of the
  90 article.
  91
  92 Find all the archived articles
  93 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94
  95 In the wallabag menu, click on **Archive** to find all the articles that
  96 you have archived.
  97
  98 Delete an article
  99 -----------------
 100
 101 Be cautious: the deletion of an article is **definitive**. It is deleted
 102 from the wallabag database.
 103
 104 To delete an article, a trash icon is displayed on the page of an
 105 article or of a list of articles (unread articles, favorites or
 106 archived, for example).
 107
 108 We trust you: that is why there is no confirmation message during the
 109 deletion.