[github/wallabag/wallabag.git] / docs / en / User / organize_articles.rst

.. _`Organize articles`:

Organize articles
=================

To be able to find more easily your articles, several methods are
available.

Tags
----

Assign a tag
~~~~~~~~~~~~

When saving an article
^^^^^^^^^^^^^^^^^^^^^^

To tag an article when saving it, just click on the tag icon next to the
URL field before hitting the Save button. At the moment, it is possible
only to do this from the web interface, but it could come to some apps
or extensions.

From the article
^^^^^^^^^^^^^^^^

To tag an already-saved article, go to the reading page of the article.
There is a part ``tags`` followed with a pencil. Click on the pencil.

Input in the box the tags you want to assign. Add as many tags as you
want. They need to be separated by commas and not spaces.
Auto-completion is available here: when you type the first letters of an
existing tag, it is not necessary to type the whole word. Select it in
the drop-down list. Once all your tags are inputted, click on the button
**Tag**.

Then, you can go back to your article and read it.

From the search
^^^^^^^^^^^^^^^

A full chapter on search is available. Here, we will describe only how
to assign a tag from your search.

When your search displays results, there is a link
``Apply the tag ABCD to this search`` at the bottom of the page. Click
on it: a tad depending on your search (here ``ABCD``) will be assigned
to all the articles found.

Find all the articles with a given tag
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In the wallabag menu, click on **Tags**. Then, all the tags you have
created are displayed, sorted by the number of articles for each tag.
Click on one of these tags to find all the articles with this tag.

Preferred articles
------------------

When you wish to set aside an article, you can mark it as preferred.

Set an article as favorite
~~~~~~~~~~~~~~~~~~~~~~~~~~

From the reading page of an article, or from a list of articles (such as
the list of unread articles), you can set an article as favorite simply
by a click on the star which is displayed. Click again on the star will
remove the **favorite** status of this article.

Find all the favorite articles
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In the wallabag menu, click on **Favorites** to display the list of all
the articles that you have set as favorite.

Archived articles
-----------------

When you have read an article, you can archive it: hence it will not be
displayed in your list of unread articles.

Archiving an article does not remove it from wallabag.

Archive an article
~~~~~~~~~~~~~~~~~~

| From the reading page of an article, or from a list of articles (such
as the list of unread articles), you can archive an article simply by
clicking on the icon ✓.
| Click again on this icon will set back the **unread** status of the
article.

Find all the archived articles
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In the wallabag menu, click on **Archive** to find all the articles that
you have archived.

Delete an article
-----------------

Be cautious: the deletion of an article is **definitive**. It is deleted
from the wallabag database.

To delete an article, a trash icon is displayed on the page of an
article or of a list of articles (unread articles, favorites or
archived, for example).

We trust you: that is why there is no confirmation message during the
deletion.
Commit	Line	Data
59e91bc8 NL	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.