]>
Commit | Line | Data |
---|---|---|
1 | Configuration | |
2 | ============= | |
3 | ||
4 | Now you're logged in, it's time to configure your account as you want. | |
5 | ||
6 | Click on ``Config`` menu. You have five tabs: ``Settings``, ``RSS``, | |
7 | ``User information``, ``Password`` and ``Tagging rules``. | |
8 | ||
9 | Settings | |
10 | -------- | |
11 | ||
12 | Theme | |
13 | ~~~~~ | |
14 | ||
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. | |
18 | ||
19 | Items per page | |
20 | ~~~~~~~~~~~~~~ | |
21 | ||
22 | You can change the number of articles displayed on each page. | |
23 | ||
24 | Language | |
25 | ~~~~~~~~ | |
26 | ||
27 | You can change the language of wallabag interface. You need to logout for this change | |
28 | to take effect. | |
29 | ||
30 | RSS | |
31 | --- | |
32 | ||
33 | wallabag provides RSS feeds for each article status: unread, starred and archive. | |
34 | ||
35 | Firstly, you need to create a personal token: click on ``Create your token``. | |
36 | It's possible to change your token by clicking on ``Reset your token``. | |
37 | ||
38 | Now you have three links, one for each status: add them into your favourite RSS reader. | |
39 | ||
40 | You can also define how many articles you want in each RSS feed (default value: 50). | |
41 | ||
42 | User information | |
43 | ---------------- | |
44 | ||
45 | You can change your name, your email address and enable ``Two factor authentication``. | |
46 | ||
47 | Two factor authentication | |
48 | ~~~~~~~~~~~~~~~~~~~~~~~~~ | |
49 | ||
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. | |
52 | ||
53 | https://en.wikipedia.org/wiki/Two-factor_authentication | |
54 | ||
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. | |
57 | ||
58 | .. image:: ../../img/user/2FA_form.png | |
59 | :alt: Two factor authentication | |
60 | :align: center | |
61 | ||
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. | |
64 | ||
65 | Password | |
66 | -------- | |
67 | ||
68 | You can change your password here (8 characters minimum). | |
69 | ||
70 | Tagging rules | |
71 | ------------- | |
72 | ||
73 | If you want to automatically assign a tag to new articles, this part | |
74 | of the configuration is for you. | |
75 | ||
76 | What does « tagging rules » mean? | |
77 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
78 | ||
79 | They are rules used by wallabag to automatically tag new 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. | |
82 | ||
83 | How do I use them? | |
84 | ~~~~~~~~~~~~~~~~~~ | |
85 | ||
86 | Let assume you want to tag new entries as *« short reading »* when | |
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. | |
90 | Several tags can added simultaneously by separating them by a comma: *« short reading, must read »*. | |
91 | Complex rules can be written by using predefined operators: | |
92 | if *« readingTime >= 5 AND domainName = "github.com" »* then tag as *« long reading, github »*. | |
93 | ||
94 | Which variables and operators can I use to write rules? | |
95 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
96 | ||
97 | The following variables and operators can be used to create tagging rules: | |
98 | ||
99 | =========== ============================================== ======== ========== | |
100 | Variable Meaning Operator Meaning | |
101 | ----------- ---------------------------------------------- -------- ---------- | |
102 | title Title of the entry <= Less than… | |
103 | url URL of the entry < Strictly less than… | |
104 | isArchived Whether the entry is archived or not => Greater than… | |
105 | isStared Whether the entry is starred or not > Strictly greater than… | |
106 | content The entry's content = Equal to… | |
107 | language The entry's language != Not equal to… | |
108 | mimetype The entry's mime-type OR One rule or another | |
109 | readingTime The estimated entry's reading time, in minutes AND One rule and another | |
110 | domainName The domain name of the entry matches Tests that a subject is matches a search (case-insensitive). Example: title matches "football" | |
111 | =========== ============================================== ======== ========== |