diff options
author | Jeremy Benoist <jeremy.benoist@gmail.com> | 2017-03-28 14:07:42 +0200 |
---|---|---|
committer | Jeremy Benoist <jeremy.benoist@gmail.com> | 2017-03-28 14:07:42 +0200 |
commit | 7d1d961267c129e2110ce9cc14c5a9d0a7d255cb (patch) | |
tree | d260d7b4ffc8466d7d410ec61bd896bdadd8456e /docs/en/user | |
parent | e1cc8fd79921fdff9999087ba896c88b14ffc0cd (diff) | |
parent | 6ae579e43f6a4ffe607a6361191366410d19f806 (diff) | |
download | wallabag-7d1d961267c129e2110ce9cc14c5a9d0a7d255cb.tar.gz wallabag-7d1d961267c129e2110ce9cc14c5a9d0a7d255cb.tar.zst wallabag-7d1d961267c129e2110ce9cc14c5a9d0a7d255cb.zip |
Merge remote-tracking branch 'origin/master' into 2.3
Diffstat (limited to 'docs/en/user')
-rw-r--r-- | docs/en/user/configuration.rst | 4 | ||||
-rw-r--r-- | docs/en/user/configuring_mobile.rst | 14 | ||||
-rw-r--r-- | docs/en/user/first_article.rst | 66 | ||||
-rw-r--r-- | docs/en/user/installation.rst | 25 | ||||
-rw-r--r-- | docs/en/user/share.rst | 17 |
5 files changed, 34 insertions, 92 deletions
diff --git a/docs/en/user/configuration.rst b/docs/en/user/configuration.rst index caca834f..bba12cb9 100644 --- a/docs/en/user/configuration.rst +++ b/docs/en/user/configuration.rst | |||
@@ -68,7 +68,9 @@ Two factor authentication (2FA) | |||
68 | Two-factor authentication (also known as 2FA) is a technology patented in 1984 | 68 | Two-factor authentication (also known as 2FA) is a technology patented in 1984 |
69 | that provides identification of users by means of the combination of two different components. | 69 | that provides identification of users by means of the combination of two different components. |
70 | 70 | ||
71 | https://en.wikipedia.org/wiki/Two-factor_authentication | 71 | https://en.wikipedia.org/wiki/Two-factor_authentication |
72 | |||
73 | **Warning**: enabling 2FA from the configuration interface is only possible if it has been authorized before in `app/config/parameters.yml` by setting the *twofactor_auth* property to `true` (do not forget to run `php bin/console cache:clear -e=prod` after modification). | ||
72 | 74 | ||
73 | If you enable 2FA, each time you want to login to wallabag, you'll receive | 75 | If you enable 2FA, each time you want to login to wallabag, you'll receive |
74 | a code by email. You have to put this code on the following form. | 76 | a code by email. You have to put this code on the following form. |
diff --git a/docs/en/user/configuring_mobile.rst b/docs/en/user/configuring_mobile.rst index 2bcf3bcb..7229aed6 100644 --- a/docs/en/user/configuring_mobile.rst +++ b/docs/en/user/configuring_mobile.rst | |||
@@ -1,13 +1,13 @@ | |||
1 | Configuring Mobile Apps to Work With wallabag.it | 1 | Configuring mobile apps to work with wallabag |
2 | ================================================ | 2 | ============================================= |
3 | 3 | ||
4 | Steps to configure the app | 4 | Steps to configure the app |
5 | --------------------------- | 5 | -------------------------- |
6 | 6 | ||
7 | - First *create a new client* in the ``Developer`` section. The name of your app doesn't matter as much as the ``Client ID`` and the ``Client secret``. Write these two values down. | 7 | - First *create a new client* in the ``API clients management`` section. The name of your app doesn't matter as much as the ``Client ID`` and the ``Client secret``. Write these two values down. |
8 | - When you download a mobile app, it's going to ask for the server address of the hosted wallabag instance. With wallabag.it that is: ``https://app.wallabag.it``. | 8 | - When you download a mobile app, it's going to ask for the server address of the hosted wallabag instance. For example, with wallabag.it that is: ``https://app.wallabag.it``. |
9 | - It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. | 9 | - It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. |
10 | - Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag.it. | 10 | - Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag. |
11 | 11 | ||
12 | Please also have a look at `Android <android>`_. Especially the section on *known limitations*. | 12 | Please also have a look at `Android <android.html>`_ page. Especially the section on *known limitations*. |
13 | 13 | ||
diff --git a/docs/en/user/first_article.rst b/docs/en/user/first_article.rst deleted file mode 100644 index 1400e1e8..00000000 --- a/docs/en/user/first_article.rst +++ /dev/null | |||
@@ -1,66 +0,0 @@ | |||
1 | Save your first article | ||
2 | ======================= | ||
3 | |||
4 | The main purpose of wallabag is to save web articles. You have many ways to do it. | ||
5 | |||
6 | .. note:: | ||
7 | |||
8 | A quickstart will be displayed in the application until you save your first article. | ||
9 | |||
10 | By using a bookmarklet | ||
11 | ---------------------- | ||
12 | |||
13 | On the ``Howto`` page, you have a ``Bookmarklet`` tab. Drag and drop the ``bag it!`` | ||
14 | link to your bookmarks bar of your browser. | ||
15 | |||
16 | Now, each time you're reading an article on the web and you want to save it, | ||
17 | click on the ``bag it!`` link in your bookmarks bar. The article is saved. | ||
18 | |||
19 | By using the classic form | ||
20 | ------------------------- | ||
21 | |||
22 | In the top bar of your screen, you have 3 icons. With the first one, a plus sign, | ||
23 | you can easily save a new article. | ||
24 | |||
25 | .. image:: ../../img/user/topbar.png | ||
26 | :alt: Top bar | ||
27 | :align: center | ||
28 | |||
29 | Click on it to display a new field, paste the article URL inside and press your | ||
30 | ``Return`` key. The article is saved. | ||
31 | |||
32 | By using a browser add-on | ||
33 | ------------------------- | ||
34 | |||
35 | Firefox | ||
36 | ~~~~~~~ | ||
37 | |||
38 | *This addon is not yet available for wallabag v2*. | ||
39 | |||
40 | Chrome | ||
41 | ~~~~~~ | ||
42 | |||
43 | *This addon is not yet available for wallabag v2*. | ||
44 | |||
45 | By using your smarphone application | ||
46 | ----------------------------------- | ||
47 | |||
48 | Android | ||
49 | ~~~~~~~ | ||
50 | |||
51 | *This application is not yet available for wallabag v2*. | ||
52 | |||
53 | Firefox OS | ||
54 | ~~~~~~~~~~ | ||
55 | |||
56 | *This application is not yet available for wallabag v2*. | ||
57 | |||
58 | Windows Phone | ||
59 | ~~~~~~~~~~~~~ | ||
60 | |||
61 | *This application is not yet available for wallabag v2*. | ||
62 | |||
63 | iOS | ||
64 | ~~~ | ||
65 | |||
66 | *This application is not yet available for wallabag v2*. | ||
diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst index 7d3bcf61..2c4b8749 100644 --- a/docs/en/user/installation.rst +++ b/docs/en/user/installation.rst | |||
@@ -4,7 +4,7 @@ Install wallabag | |||
4 | Requirements | 4 | Requirements |
5 | ------------ | 5 | ------------ |
6 | 6 | ||
7 | wallabag is compatible with PHP >= 5.5, including PHP 7. | 7 | wallabag is compatible with **PHP >= 5.6**, including PHP 7. |
8 | 8 | ||
9 | .. note:: | 9 | .. note:: |
10 | 10 | ||
@@ -110,6 +110,12 @@ Virtual hosts | |||
110 | Configuration on Apache | 110 | Configuration on Apache |
111 | ~~~~~~~~~~~~~~~~~~~~~~~ | 111 | ~~~~~~~~~~~~~~~~~~~~~~~ |
112 | 112 | ||
113 | Do not forget to active the *rewrite* mod of Apache | ||
114 | |||
115 | .. code-block:: bash | ||
116 | |||
117 | a2enmod rewrite && systemctl reload apache2 | ||
118 | |||
113 | Assuming you install wallabag in the ``/var/www/wallabag`` folder and that you want to use PHP as an Apache module, here's a vhost for wallabag: | 119 | Assuming you install wallabag in the ``/var/www/wallabag`` folder and that you want to use PHP as an Apache module, here's a vhost for wallabag: |
114 | 120 | ||
115 | :: | 121 | :: |
@@ -149,6 +155,23 @@ Assuming you install wallabag in the ``/var/www/wallabag`` folder and that you w | |||
149 | ErrorLog /var/log/apache2/wallabag_error.log | 155 | ErrorLog /var/log/apache2/wallabag_error.log |
150 | CustomLog /var/log/apache2/wallabag_access.log combined | 156 | CustomLog /var/log/apache2/wallabag_access.log combined |
151 | </VirtualHost> | 157 | </VirtualHost> |
158 | |||
159 | |||
160 | .. tip:: Note for Apache 2.4, in the section `<Directory /var/www/wallabag/web>` you have to replace the directives : | ||
161 | |||
162 | :: | ||
163 | |||
164 | AllowOverride None | ||
165 | Order Allow,Deny | ||
166 | Allow from All | ||
167 | |||
168 | |||
169 | by | ||
170 | |||
171 | :: | ||
172 | |||
173 | Require All granted | ||
174 | |||
152 | 175 | ||
153 | After reloading or restarting Apache, you should now be able to access wallabag at http://domain.tld. | 176 | After reloading or restarting Apache, you should now be able to access wallabag at http://domain.tld. |
154 | 177 | ||
diff --git a/docs/en/user/share.rst b/docs/en/user/share.rst deleted file mode 100644 index e99e51ab..00000000 --- a/docs/en/user/share.rst +++ /dev/null | |||
@@ -1,17 +0,0 @@ | |||
1 | Share articles | ||
2 | ============== | ||
3 | |||
4 | When you're reading an article, you can share it. Just click on the share button: | ||
5 | |||
6 | .. image:: ../../img/user/share.png | ||
7 | :alt: share article | ||
8 | :align: center | ||
9 | |||
10 | Now, you can share the article: | ||
11 | |||
12 | - with a public URL (you'll have a light view of the article) | ||
13 | - with a tweet | ||
14 | - into your Shaarli | ||
15 | - with a post in Diaspora* | ||
16 | - to Carrot | ||
17 | - with an email | ||