diff options
Diffstat (limited to 'docs/en/user/configuration.rst')
-rw-r--r-- | docs/en/user/configuration.rst | 42 |
1 files changed, 27 insertions, 15 deletions
diff --git a/docs/en/user/configuration.rst b/docs/en/user/configuration.rst index 369c977a..70d960ff 100644 --- a/docs/en/user/configuration.rst +++ b/docs/en/user/configuration.rst | |||
@@ -3,7 +3,8 @@ Configuration | |||
3 | 3 | ||
4 | Now you're logged in, it's time to configure your account as you want. | 4 | Now you're logged in, it's time to configure your account as you want. |
5 | 5 | ||
6 | Click on ``Config`` menu. You have five tabs: ``Settings``, ``RSS``, ``User information``, ``Password`` and ``Tagging rules``. | 6 | Click on ``Config`` menu. You have five tabs: ``Settings``, ``RSS``, |
7 | ``User information``, ``Password`` and ``Tagging rules``. | ||
7 | 8 | ||
8 | Settings | 9 | Settings |
9 | -------- | 10 | -------- |
@@ -11,7 +12,9 @@ Settings | |||
11 | Theme | 12 | Theme |
12 | ~~~~~ | 13 | ~~~~~ |
13 | 14 | ||
14 | wallabag is customizable. You can choose your prefered theme here. You can also create a new one, a chapter is dedicated for this. The default theme is ``Material``, it's the theme used in the documentation screenshots. | 15 | wallabag is customizable. You can choose your prefered theme here. You can also |
16 | create a new one, a chapter will be dedicated for this. The default theme is | ||
17 | ``Material``, it's the theme used in the documentation screenshots. | ||
15 | 18 | ||
16 | Items per page | 19 | Items per page |
17 | ~~~~~~~~~~~~~~ | 20 | ~~~~~~~~~~~~~~ |
@@ -21,7 +24,8 @@ You can change the number of articles displayed on each page. | |||
21 | Language | 24 | Language |
22 | ~~~~~~~~ | 25 | ~~~~~~~~ |
23 | 26 | ||
24 | You can change the language of wallabag interface. | 27 | You can change the language of wallabag interface. You need to logout for this change |
28 | to take effect. | ||
25 | 29 | ||
26 | RSS | 30 | RSS |
27 | --- | 31 | --- |
@@ -43,41 +47,49 @@ You can change your name, your email address and enable ``Two factor authenticat | |||
43 | Two factor authentication | 47 | Two factor authentication |
44 | ~~~~~~~~~~~~~~~~~~~~~~~~~ | 48 | ~~~~~~~~~~~~~~~~~~~~~~~~~ |
45 | 49 | ||
46 | 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. | 50 | Two-factor authentication (also known as 2FA) is a technology patented in 1984 |
51 | that provides identification of users by means of the combination of two different components. | ||
47 | 52 | ||
48 | https://en.wikipedia.org/wiki/Two-factor_authentication | 53 | https://en.wikipedia.org/wiki/Two-factor_authentication |
49 | 54 | ||
50 | 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. | 55 | If you enable 2FA, each time you want to login to wallabag, you'll receive |
56 | a code by email. You have to put this code on the following form. | ||
51 | 57 | ||
52 | .. image:: ../../img/user/2FA_form.png | 58 | .. image:: ../../img/user/2FA_form.png |
53 | :alt: Two factor authentication | 59 | :alt: Two factor authentication |
54 | :align: center | 60 | :align: center |
55 | 61 | ||
56 | 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. | 62 | If you don't want to receive a code each time you want to login, you can check |
63 | the ``I'm on a trusted computer`` checkbox: wallabag will remember you for 15 days. | ||
57 | 64 | ||
58 | Password | 65 | Password |
59 | -------- | 66 | -------- |
60 | 67 | ||
61 | You can change your password here. | 68 | You can change your password here (8 characters minimum). |
62 | 69 | ||
63 | Tagging rules | 70 | Tagging rules |
64 | ------------- | 71 | ------------- |
65 | 72 | ||
66 | If you want to automatically assign a tag to new articles, this part of the configuration is for you. | 73 | If you want to automatically assign a tag to new articles, this part |
74 | of the configuration is for you. | ||
67 | 75 | ||
68 | What does « tagging rules » mean? | 76 | What does « tagging rules » mean? |
69 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 77 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
70 | 78 | ||
71 | They are rules used by wallabag to automatically tag new entries. | 79 | They are rules used by wallabag to automatically tag new entries. |
72 | 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. | 80 | Each time a new entry is added, all the tagging rules will be used to add |
81 | the tags you configured, thus saving you the trouble to manually classify your entries. | ||
73 | 82 | ||
74 | How do I use them? | 83 | How do I use them? |
75 | ~~~~~~~~~~~~~~~~~~ | 84 | ~~~~~~~~~~~~~~~~~~ |
76 | 85 | ||
77 | Let assume you want to tag new entries as *« short reading »* when the reading time is inferior to 3 minutes. | 86 | Let assume you want to tag new entries as *« short reading »* when |
78 | In that case, you should put « readingTime <= 3 » in the **Rule** field and *« short reading »* in the **Tags** field. | 87 | the reading time is inferior to 3 minutes. |
88 | In that case, you should put « readingTime <= 3 » in the **Rule** field | ||
89 | and *« short reading »* in the **Tags** field. | ||
79 | Several tags can added simultaneously by separating them by a comma: *« short reading, must read »*. | 90 | Several tags can added simultaneously by separating them by a comma: *« short reading, must read »*. |
80 | Complex rules can be written by using predefined operators: if *« readingTime >= 5 AND domainName = "github.com" »* then tag as *« long reading, github »*. | 91 | Complex rules can be written by using predefined operators: |
92 | if *« readingTime >= 5 AND domainName = "github.com" »* then tag as *« long reading, github »*. | ||
81 | 93 | ||
82 | Which variables and operators can I use to write rules? | 94 | Which variables and operators can I use to write rules? |
83 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 95 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
@@ -96,4 +108,4 @@ language The entry's language != Not equal | |||
96 | mimetype The entry's mime-type OR One rule or another | 108 | mimetype The entry's mime-type OR One rule or another |
97 | readingTime The estimated entry's reading time, in minutes AND One rule and another | 109 | readingTime The estimated entry's reading time, in minutes AND One rule and another |
98 | domainName The domain name of the entry matches Tests that a subject is matches a search (case-insensitive). Example: title matches "football" | 110 | domainName The domain name of the entry matches Tests that a subject is matches a search (case-insensitive). Example: title matches "football" |
99 | =========== ============================================== ======== ========== \ No newline at end of file | 111 | =========== ============================================== ======== ========== |