wallabag/docs/en/user/configuration.rst

130 lines
5.2 KiB
ReStructuredText
Raw Normal View History

2015-10-21 12:14:51 +00:00
Configuration
=============
Now you're logged in, it's time to configure your account as you want.
2016-02-20 07:39:08 +00:00
Click on ``Config`` menu. You have five tabs: ``Settings``, ``RSS``,
``User information``, ``Password`` and ``Tagging rules``.
2015-10-21 12:14:51 +00:00
Settings
--------
Theme
~~~~~
2016-11-12 12:18:39 +00:00
wallabag is customizable. You can choose your prefered theme here. The default theme is
2016-02-20 07:39:08 +00:00
``Material``, it's the theme used in the documentation screenshots.
2015-10-21 12:14:51 +00:00
Items per page
~~~~~~~~~~~~~~
You can change the number of articles displayed on each page.
2016-03-10 12:18:59 +00:00
Reading speed
~~~~~~~~~~~~~
wallabag calculates a reading time for each article. You can define here, thanks to this list, if you are
2016-03-10 12:18:59 +00:00
a fast or a slow reader. wallabag will recalculate the reading time for each article.
Where do you want to be redirected after mark an article as read?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Each time you'll do some actions (after marking an article as read/favorite,
after deleting an article, after removing a tag from an entry), you can be redirected:
- To the homepage
- To the current page
2015-10-21 12:14:51 +00:00
Language
~~~~~~~~
2016-11-12 12:18:39 +00:00
You can change the language of wallabag interface.
2015-10-21 12:14:51 +00:00
RSS
---
wallabag provides RSS feeds for each article status: unread, starred and archive.
Firstly, you need to create a personal token: click on ``Create your token``.
It's possible to change your token by clicking on ``Reset your token``.
Now you have three links, one for each status: add them into your favourite RSS reader.
You can also define how many articles you want in each RSS feed (default value: 50).
2016-11-20 08:46:03 +00:00
There is also a pagination available for these feeds. You can add ``?page=2`` to jump to the second page.
The pagination follow `the RFC <https://tools.ietf.org/html/rfc5005#page-4>`_ about that, which means you'll find the ``next``, ``previous`` & ``last`` page link inside the `<channel>` tag of each RSS feed.
2015-10-21 12:14:51 +00:00
User information
----------------
You can change your name, your email address and enable ``Two factor authentication``.
If the wallabag instance has more than one enabled user, you can delete your account here. **Take care, we delete all your data**.
2016-11-10 12:51:33 +00:00
Two factor authentication (2FA)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2015-10-21 12:14:51 +00:00
2016-02-20 07:39:08 +00:00
Two-factor authentication (also known as 2FA) is a technology patented in 1984
that provides identification of users by means of the combination of two different components.
2015-10-21 12:14:51 +00:00
https://en.wikipedia.org/wiki/Two-factor_authentication
2016-02-20 07:39:08 +00:00
If you enable 2FA, each time you want to login to wallabag, you'll receive
a code by email. You have to put this code on the following form.
2015-10-21 12:14:51 +00:00
.. image:: ../../img/user/2FA_form.png
2016-02-20 07:39:08 +00:00
:alt: Two factor authentication
:align: center
2015-10-21 12:14:51 +00:00
2016-02-20 07:39:08 +00:00
If you don't want to receive a code each time you want to login, you can check
the ``I'm on a trusted computer`` checkbox: wallabag will remember you for 15 days.
2015-10-21 12:14:51 +00:00
Password
--------
2016-02-20 07:39:08 +00:00
You can change your password here (8 characters minimum).
2016-01-08 14:02:51 +00:00
Tagging rules
-------------
2016-02-20 07:39:08 +00:00
If you want to automatically assign a tag to new articles, this part
of the configuration is for you.
2016-01-08 14:02:51 +00:00
What does « tagging rules » mean?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
They are rules used by wallabag to automatically tag new entries.
2016-02-20 07:39:08 +00:00
Each time a new entry is added, all the tagging rules will be used to add
the tags you configured, thus saving you the trouble to manually classify your entries.
2016-01-08 14:02:51 +00:00
How do I use them?
~~~~~~~~~~~~~~~~~~
2016-02-20 07:39:08 +00:00
Let assume you want to tag new entries as *« short reading »* when
the reading time is inferior to 3 minutes.
In that case, you should put « readingTime <= 3 » in the **Rule** field
and *« short reading »* in the **Tags** field.
2016-01-08 14:02:51 +00:00
Several tags can added simultaneously by separating them by a comma: *« short reading, must read »*.
2016-02-20 07:39:08 +00:00
Complex rules can be written by using predefined operators:
if *« readingTime >= 5 AND domainName = "github.com" »* then tag as *« long reading, github »*.
2016-01-08 14:02:51 +00:00
Which variables and operators can I use to write rules?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The following variables and operators can be used to create tagging rules (be careful, for some values, you need to add quotes, for example ``language = "en"``):
2016-01-08 14:02:51 +00:00
=========== ============================================== ======== ==========
Variable Meaning Operator Meaning
----------- ---------------------------------------------- -------- ----------
title Title of the entry <= Less than…
url URL of the entry < Strictly less than…
isArchived Whether the entry is archived or not => Greater than…
2016-05-23 19:41:00 +00:00
isStarred Whether the entry is starred or not > Strictly greater than…
2016-01-08 14:02:51 +00:00
content The entry's content = Equal to…
language The entry's language != Not equal to…
mimetype The entry's mime-type OR One rule or another
readingTime The estimated entry's reading time, in minutes AND One rule and another
domainName The domain name of the entry matches Tests that a subject is matches a search (case-insensitive). Example: title matches "football"
2016-02-20 07:39:08 +00:00
=========== ============================================== ======== ==========