aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs
diff options
context:
space:
mode:
authorNicolas Lœuillet <nicolas@loeuillet.org>2016-11-10 13:51:33 +0100
committerJulian Oster <jlnostr@outlook.de>2016-11-17 19:22:16 +0100
commitbb624c02696b95881c55c8c9554e4104421dbd6e (patch)
treecba6e27089b499b770d09bb093149970285e3571 /docs
parent2e389b0b90f34d795e4bafc43d621955c05850a9 (diff)
downloadwallabag-bb624c02696b95881c55c8c9554e4104421dbd6e.tar.gz
wallabag-bb624c02696b95881c55c8c9554e4104421dbd6e.tar.zst
wallabag-bb624c02696b95881c55c8c9554e4104421dbd6e.zip
Reordered :fr: documentation
Diffstat (limited to 'docs')
-rw-r--r--docs/de/index.rst20
-rw-r--r--docs/en/index.rst2
-rw-r--r--docs/en/user/android.rst21
-rw-r--r--docs/en/user/configuration.rst4
-rw-r--r--docs/en/user/import.rst8
-rw-r--r--docs/en/user/parameters.rst2
-rw-r--r--docs/fr/developer/asynchronous.rst159
-rw-r--r--docs/fr/developer/rabbitmq.rst80
-rw-r--r--docs/fr/developer/redis.rst75
-rw-r--r--docs/fr/index.rst22
-rw-r--r--docs/fr/user/android.rst96
-rw-r--r--docs/fr/user/annotations.rst25
-rw-r--r--docs/fr/user/articles.rst123
-rw-r--r--docs/fr/user/backup.rst2
-rw-r--r--docs/fr/user/create_account.rst19
-rw-r--r--docs/fr/user/download_articles.rst17
-rw-r--r--docs/fr/user/errors_during_fetching.rst4
-rw-r--r--docs/fr/user/filters.rst4
-rw-r--r--docs/fr/user/first_article.rst68
-rw-r--r--docs/fr/user/import.rst92
-rw-r--r--docs/fr/user/login.rst13
-rw-r--r--docs/fr/user/migration.rst66
-rw-r--r--docs/fr/user/parameters.rst43
-rw-r--r--docs/fr/user/share.rst17
-rw-r--r--docs/fr/user/upgrade-2.0.x-2.1.1.rst87
-rw-r--r--docs/fr/user/upgrade-2.1.x-2.1.y.rst30
-rw-r--r--docs/fr/user/upgrade.rst102
27 files changed, 654 insertions, 547 deletions
diff --git a/docs/de/index.rst b/docs/de/index.rst
index b422bf83..28a47200 100644
--- a/docs/de/index.rst
+++ b/docs/de/index.rst
@@ -8,10 +8,6 @@ wallabag Dokumentation
8**wallabag** ist eine Read-it-later Applikation: es speichert Websites, 8**wallabag** ist eine Read-it-later Applikation: es speichert Websites,
9indem es nur den Inhalt behält. Elemente wie Navigation oder Werbung werden gelöscht. 9indem es nur den Inhalt behält. Elemente wie Navigation oder Werbung werden gelöscht.
10 10
11.. tip::
12
13 Diese Dokumentation ist über wallabag v2. Wenn du die Dokumentation für wallabag v1 lesen willst, `siehe dir bitte das hier an <https://github.com/wallabag/documentation>`__.
14
15Die Hauptdokumentation für diese Applikation ist in einigen Abschnitten organisiert: 11Die Hauptdokumentation für diese Applikation ist in einigen Abschnitten organisiert:
16 12
17* :ref:`user-docs` 13* :ref:`user-docs`
@@ -28,24 +24,19 @@ Die Dokumentation ist in anderen Sprachen verfügbar :
28 :maxdepth: 2 24 :maxdepth: 2
29 :caption: Nutzerdokumentation 25 :caption: Nutzerdokumentation
30 26
31 user/faq
32 user/installation 27 user/installation
33 user/upgrade-2.0.x-2.1.1 28 user/upgrade
34 user/upgrade-2.0.x-2.1.1 29 user/configuration
35 user/migration
36 user/import 30 user/import
37 user/create_account 31 user/create_account
38 user/login 32 user/articles
39 user/configuration
40 user/first_article
41 user/errors_during_fetching 33 user/errors_during_fetching
42 user/annotations
43 user/download_articles
44 user/filters 34 user/filters
45 user/tags 35 user/tags
46 user/android 36 user/android
47 user/parameters 37 user/parameters
48 user/backup 38 user/backup
39 user/faq
49 40
50.. _dev-docs: 41.. _dev-docs:
51 42
@@ -58,5 +49,4 @@ Die Dokumentation ist in anderen Sprachen verfügbar :
58 developer/documentation 49 developer/documentation
59 developer/translate 50 developer/translate
60 developer/maintenance 51 developer/maintenance
61 developer/redis 52 developer/asynchronous
62 developer/rabbitmq
diff --git a/docs/en/index.rst b/docs/en/index.rst
index 3c8595a4..76067a0f 100644
--- a/docs/en/index.rst
+++ b/docs/en/index.rst
@@ -26,9 +26,9 @@ The documentation is available in other languages:
26 26
27 user/installation 27 user/installation
28 user/upgrade 28 user/upgrade
29 user/configuration
29 user/import 30 user/import
30 user/create_account 31 user/create_account
31 user/configuration
32 user/articles 32 user/articles
33 user/errors_during_fetching 33 user/errors_during_fetching
34 user/filters 34 user/filters
diff --git a/docs/en/user/android.rst b/docs/en/user/android.rst
index d210d6da..e286bb3b 100644
--- a/docs/en/user/android.rst
+++ b/docs/en/user/android.rst
@@ -21,7 +21,7 @@ Just confirm that message and you get redirected to the settings screen.
21 :alt: Settings screen 21 :alt: Settings screen
22 :align: center 22 :align: center
23 23
24Fill in your wallabag data. You need to enter your wallabag address. It is important that this URL does not end with a slash. Also add your wallabag credentials to the user name and password field. 24Fill in your wallabag data. You need to enter your wallabag address. **It is important that this URL does not end with a slash**. Also add your wallabag credentials to the user name and password field.
25 25
26.. image:: ../../img/user/android_configuration_filled_in.en.png 26.. image:: ../../img/user/android_configuration_filled_in.en.png
27 :alt: Filled in settings 27 :alt: Filled in settings
@@ -57,13 +57,13 @@ Now you need to scroll to the bottom of the settings menu. Of course you can adj
57 :alt: Bottom of the settings screen 57 :alt: Bottom of the settings screen
58 :align: center 58 :align: center
59 59
60After hitting the save button, you get the following screen. The app proposes to initiate a syncronisation process to update your feeds of articles. It is recommended to acknowledge this action and press Yes. 60After hitting the save button, you get the following screen. The app proposes to initiate a synchronization process to update your feeds of articles. It is recommended to acknowledge this action and press Yes.
61 61
62.. image:: ../../img/user/android_configuration_saved_feed_update.en.png 62.. image:: ../../img/user/android_configuration_saved_feed_update.en.png
63 :alt: Settings saved the first time 63 :alt: Settings saved the first time
64 :align: center 64 :align: center
65 65
66Finally after the synchronisation finished successfully, you are presented to the list of unread articles. 66Finally after the synchronization finished successfully, you are presented to the list of unread articles.
67 67
68.. image:: ../../img/user/android_unread_feed_synced.en.png 68.. image:: ../../img/user/android_unread_feed_synced.en.png
69 :alt: Filled article list cause feeds successfully synchronized 69 :alt: Filled article list cause feeds successfully synchronized
@@ -72,8 +72,8 @@ Finally after the synchronisation finished successfully, you are presented to th
72Known limitations 72Known limitations
73----------------- 73-----------------
74 74
752FA 75Two factor authentication (2FA)
76~~~ 76~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
77 77
78Currently the Android application does not support two-factor authentication. You should disable that to get the application working. 78Currently the Android application does not support two-factor authentication. You should disable that to get the application working.
79 79
@@ -90,11 +90,6 @@ If you can reach your wallabag web instance via HTTPS, you should use that. Espe
90References 90References
91---------- 91----------
92 92
93`Source code of the Android application <https://github.com/wallabag/android-app>`_ 93- `Source code of the Android application <https://github.com/wallabag/android-app>`_
94 94- `Android Application on F-Droid <https://f-droid.org/repository/browse/?fdfilter=wallabag&fdid=fr.gaulupeau.apps.InThePoche>`_
95`Android Application on F-Droid <https://f-droid.org/repository/browse/?fdfilter=wallabag&fdid=fr.gaulupeau.apps.InThePoche>`_ 95- `Android Application on Google Play <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_
96
97`Android Application on Google Play <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_
98
99`Support chat <https://gitter.im/wallabag/wallabag>`_
100
diff --git a/docs/en/user/configuration.rst b/docs/en/user/configuration.rst
index a6edcd4a..2c1385a8 100644
--- a/docs/en/user/configuration.rst
+++ b/docs/en/user/configuration.rst
@@ -48,8 +48,8 @@ User information
48 48
49You can change your name, your email address and enable ``Two factor authentication``. 49You can change your name, your email address and enable ``Two factor authentication``.
50 50
51Two factor authentication 51Two factor authentication (2FA)
52~~~~~~~~~~~~~~~~~~~~~~~~~ 52~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
53 53
54 Two-factor authentication (also known as 2FA) is a technology patented in 1984 54 Two-factor authentication (also known as 2FA) is a technology patented in 1984
55 that provides identification of users by means of the combination of two different components. 55 that provides identification of users by means of the combination of two different components.
diff --git a/docs/en/user/import.rst b/docs/en/user/import.rst
index 269e226c..a6754fa0 100644
--- a/docs/en/user/import.rst
+++ b/docs/en/user/import.rst
@@ -5,12 +5,14 @@ In wallabag 2.x, you can import data from:
5 5
6- `Pocket <#id1>`_ 6- `Pocket <#id1>`_
7- `Readability <#id2>`_ 7- `Readability <#id2>`_
8- `Instapaper <#instapaper>`_ 8- `Instapaper <#id4>`_
9- `wallabag 1.x <#wallabag-1-x>`_ 9- `wallabag 1.x <#id6>`_
10- `wallabag 2.x <#wallabag-2-x>`_ 10- `wallabag 2.x <#id7>`_
11 11
12We also developed `a script to execute migrations via command-line interface <#import-via-command-line-interface-cli>`_. 12We also developed `a script to execute migrations via command-line interface <#import-via-command-line-interface-cli>`_.
13 13
14Because imports can take ages, we developed an asynchronous tasks system. `You can read the documentation here <http://doc.wallabag.org/fr/master/developer/asynchronous.html>`_ (for experts).
15
14Pocket 16Pocket
15------ 17------
16 18
diff --git a/docs/en/user/parameters.rst b/docs/en/user/parameters.rst
index 6ccc03b4..2b02a34d 100644
--- a/docs/en/user/parameters.rst
+++ b/docs/en/user/parameters.rst
@@ -5,7 +5,7 @@ Default `parameters.yml` file
5----------------------------- 5-----------------------------
6 6
7Here is the last version of the default `app/config/parameters.yml` file. Be sure that yours respects this one. 7Here is the last version of the default `app/config/parameters.yml` file. Be sure that yours respects this one.
8If you don't know which parameter you need to set, please leave the default one. 8If you don't know which value you need to set, please leave the default one.
9 9
10.. code-block:: yml 10.. code-block:: yml
11 11
diff --git a/docs/fr/developer/asynchronous.rst b/docs/fr/developer/asynchronous.rst
new file mode 100644
index 00000000..c5489228
--- /dev/null
+++ b/docs/fr/developer/asynchronous.rst
@@ -0,0 +1,159 @@
1Tâches asynchrones
2==================
3
4Pour lancer des tâches asynchrones (utile pour des imports importants par exemple), nous pouvons utiliser RabbitMQ ou Redis.
5
6Installer RabbitMQ pour des tâches asynchrones
7----------------------------------------------
8
9Pour lancer des tâches asynchrones (utile pour des imports importants par exemple), nous pouvons utiliser RabbitMQ.
10
11Pré-requis
12^^^^^^^^^^
13
14Vous devez installer RabbitMQ sur votre serveur.
15
16Installation
17^^^^^^^^^^^^
18
19.. code:: bash
20
21 wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc
22 apt-key add rabbitmq-signing-key-public.asc
23 apt-get update
24 apt-get install rabbitmq-server
25
26Configuration et démarrage
27^^^^^^^^^^^^^^^^^^^^^^^^^^
28
29.. code:: bash
30
31 rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest)
32 rabbitmq-server -detached
33
34Arrêter RabbitMQ
35^^^^^^^^^^^^^^^^
36
37.. code:: bash
38
39 rabbitmqctl stop
40
41Configurer RabbitMQ dans wallabag
42^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
43
44Modifiez votre fichier ``app/config/parameters.yml`` pour éditer la configuration RabbitMQ. Celle par défaut devrait convenir :
45
46.. code:: yaml
47
48 rabbitmq_host: localhost
49 rabbitmq_port: 5672
50 rabbitmq_user: guest
51 rabbitmq_password: guest
52
53Activer RabbitMQ dans wallabag
54^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
55
56Dans les paramètres internes, section **Import**, activez RabbitMQ (avec la valeur 1).
57
58Démarrer les clients RabbitMQ
59^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
60
61En fonction du service dont vous souhaitez importer vos données, vous devez activer un (ou plusieurs si vous souhaitez en supporter plusieurs) cron job :
62
63.. code:: bash
64
65 # for Pocket import
66 bin/console rabbitmq:consumer -e=prod import_pocket -w
67
68 # for Readability import
69 bin/console rabbitmq:consumer -e=prod import_readability -w
70
71 # for Instapaper import
72 bin/console rabbitmq:consumer -e=prod import_instapaper -w
73
74 # for wallabag v1 import
75 bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w
76
77 # for wallabag v2 import
78 bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w
79
80 # for Firefox import
81 bin/console rabbitmq:consumer -e=prod import_firefox -w
82
83 # for Chrome import
84 bin/console rabbitmq:consumer -e=prod import_chrome -w
85
86Installer Redis pour des tâches asynchrones
87-------------------------------------------
88
89Pour lancer des tâches asynchrones (utile pour des imports importants par exemple), nous pouvons utiliser Redis.
90
91Pré-requis
92^^^^^^^^^^
93
94Vous devez installer Redis sur votre serveur.
95
96Installation
97^^^^^^^^^^^^
98
99.. code:: bash
100
101 apt-get install redis-server
102
103Démarrage
104^^^^^^^^^
105
106Le serveur devrait déjà être démarré après l'installation. Si ce n'est pas le cas, vous pouvez le démarrer ainsi :
107
108.. code:: bash
109
110 redis-server
111
112Configurer Redis dans wallabag
113^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
114
115Modifiez votre fichier ``app/config/parameters.yml`` pour éditer la configuration Redis. Celle par défaut devrait convenir :
116
117.. code:: yaml
118
119 redis_host: localhost
120 redis_port: 6379
121
122Activer Redis dans wallabag
123^^^^^^^^^^^^^^^^^^^^^^^^^^^
124
125Dans les paramètres internes, section **Import**, activez Redis (avec la valeur 1).
126
127Démarrer les clients Redis
128^^^^^^^^^^^^^^^^^^^^^^^^^^
129
130En fonction du service dont vous souhaitez importer vos données, vous devez activer un (ou plusieurs si vous souhaitez en supporter plusieurs) cron job :
131
132.. code:: bash
133
134 # for Pocket import
135 bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log
136
137 # for Readability import
138 bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log
139
140 # for Instapaper import
141 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log
142
143 # for wallabag v1 import
144 bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log
145
146 # for wallabag v2 import
147 bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log
148
149 # for Firefox import
150 bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log
151
152 # for Chrome import
153 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log
154
155Si vous souhaitez démarrer l'import pour quelques messages uniquement, vous pouvez spécifier cette valeur en paramètre (ici 12) et le client va s'arrêter après le 12ème message :
156
157.. code:: bash
158
159 bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12
diff --git a/docs/fr/developer/rabbitmq.rst b/docs/fr/developer/rabbitmq.rst
deleted file mode 100644
index b534a48b..00000000
--- a/docs/fr/developer/rabbitmq.rst
+++ /dev/null
@@ -1,80 +0,0 @@
1Installer RabbitMQ pour des tâches asynchrones
2==============================================
3
4Pour lancer des tâches asynchrones (utile pour des imports importants par exemple), nous pouvons utiliser RabbitMQ.
5
6Pré-requis
7----------
8
9Vous devez installer RabbitMQ sur votre serveur.
10
11Installation
12~~~~~~~~~~~~
13
14.. code:: bash
15
16 wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc
17 apt-key add rabbitmq-signing-key-public.asc
18 apt-get update
19 apt-get install rabbitmq-server
20
21Configuration et démarrage
22~~~~~~~~~~~~~~~~~~~~~~~~~~
23
24.. code:: bash
25
26 rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest)
27 rabbitmq-server -detached
28
29Arrêter RabbitMQ
30~~~~~~~~~~~~~~~~
31
32.. code:: bash
33
34 rabbitmqctl stop
35
36
37Configurer RabbitMQ dans wallabag
38---------------------------------
39
40Modifiez votre fichier ``app/config/parameters.yml`` pour éditer la configuration RabbitMQ. Celle par défaut devrait convenir :
41
42.. code:: yaml
43
44 rabbitmq_host: localhost
45 rabbitmq_port: 5672
46 rabbitmq_user: guest
47 rabbitmq_password: guest
48
49Activer RabbitMQ dans wallabag
50------------------------------
51
52Dans les paramètres internes, section **Import**, activez RabbitMQ (avec la valeur 1).
53
54Démarrer les clients RabbitMQ
55-----------------------------
56
57En fonction du service dont vous souhaitez importer vos données, vous devez activer un (ou plusieurs si vous souhaitez en supporter plusieurs) cron job :
58
59.. code:: bash
60
61 # for Pocket import
62 bin/console rabbitmq:consumer -e=prod import_pocket -w
63
64 # for Readability import
65 bin/console rabbitmq:consumer -e=prod import_readability -w
66
67 # for Instapaper import
68 bin/console rabbitmq:consumer -e=prod import_instapaper -w
69
70 # for wallabag v1 import
71 bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w
72
73 # for wallabag v2 import
74 bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w
75
76 # for Firefox import
77 bin/console rabbitmq:consumer -e=prod import_firefox -w
78
79 # for Chrome import
80 bin/console rabbitmq:consumer -e=prod import_chrome -w
diff --git a/docs/fr/developer/redis.rst b/docs/fr/developer/redis.rst
deleted file mode 100644
index 58204d57..00000000
--- a/docs/fr/developer/redis.rst
+++ /dev/null
@@ -1,75 +0,0 @@
1Installer Redis pour des tâches asynchrones
2===========================================
3
4Pour lancer des tâches asynchrones (utile pour des imports importants par exemple), nous pouvons utiliser Redis.
5
6Pré-requis
7----------
8
9Vous devez installer Redis sur votre serveur.
10
11Installation
12~~~~~~~~~~~~
13
14.. code:: bash
15
16 apt-get install redis-server
17
18Démarrage
19~~~~~~~~~
20
21Le serveur devrait déjà être démarré après l'installation. Si ce n'est pas le cas, vous pouvez le démarrer ainsi :
22
23.. code:: bash
24
25 redis-server
26
27
28Configurer Redis dans wallabag
29-------------------------------
30
31Modifiez votre fichier ``app/config/parameters.yml`` pour éditer la configuration Redis. Celle par défaut devrait convenir :
32
33.. code:: yaml
34
35 redis_host: localhost
36 redis_port: 6379
37
38Activer Redis dans wallabag
39---------------------------
40
41Dans les paramètres internes, section **Import**, activez Redis (avec la valeur 1).
42
43Démarrer les clients Redis
44--------------------------
45
46En fonction du service dont vous souhaitez importer vos données, vous devez activer un (ou plusieurs si vous souhaitez en supporter plusieurs) cron job :
47
48.. code:: bash
49
50 # for Pocket import
51 bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log
52
53 # for Readability import
54 bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log
55
56 # for Instapaper import
57 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log
58
59 # for wallabag v1 import
60 bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log
61
62 # for wallabag v2 import
63 bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log
64
65 # for Firefox import
66 bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log
67
68 # for Chrome import
69 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log
70
71Si vous souhaitez démarrer l'import pour quelques messages uniquement, vous pouvez spécifier cette valeur en paramètre (ici 12) et le client va s'arrêter après le 12ème message :
72
73.. code:: bash
74
75 bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12
diff --git a/docs/fr/index.rst b/docs/fr/index.rst
index dbb85910..564ffe52 100644
--- a/docs/fr/index.rst
+++ b/docs/fr/index.rst
@@ -9,10 +9,6 @@ Documentation de wallabag
9simplement d’archiver une page web en ne conservant que le contenu. Les 9simplement d’archiver une page web en ne conservant que le contenu. Les
10éléments superflus (menu, publicité, etc.) sont supprimés. 10éléments superflus (menu, publicité, etc.) sont supprimés.
11 11
12.. tip::
13
14 Vous vous trouvez sur la documentation de wallabag v2. Si vous voulez lire la documentation de wallabag v1, `vous pouvez jeter un œil ici <https://github.com/wallabag/documentation>`__.
15
16La documentation principale de cette application est découpée en plusieurs sections : 12La documentation principale de cette application est découpée en plusieurs sections :
17 13
18* :ref:`user-docs` 14* :ref:`user-docs`
@@ -29,24 +25,19 @@ La documentation est disponible dans d'autres langues :
29 :maxdepth: 2 25 :maxdepth: 2
30 :caption: Documentation utilisateur 26 :caption: Documentation utilisateur
31 27
32 user/faq
33 user/installation 28 user/installation
34 user/upgrade-2.0.x-2.1.1 29 user/upgrade
35 user/upgrade-2.0.x-2.1.1 30 user/configuration
36 user/migration
37 user/import 31 user/import
38 user/create_account 32 user/create_account
39 user/login 33 user/articles
40 user/configuration
41 user/first_article
42 user/errors_during_fetching 34 user/errors_during_fetching
43 user/annotations
44 user/download_articles
45 user/share
46 user/filters 35 user/filters
47 user/tags 36 user/tags
37 user/android
48 user/parameters 38 user/parameters
49 user/backup 39 user/backup
40 user/faq
50 41
51.. _dev-docs: 42.. _dev-docs:
52 43
@@ -59,5 +50,4 @@ La documentation est disponible dans d'autres langues :
59 developer/documentation 50 developer/documentation
60 developer/translate 51 developer/translate
61 developer/maintenance 52 developer/maintenance
62 developer/redis 53 developer/asynchronous
63 developer/rabbitmq
diff --git a/docs/fr/user/android.rst b/docs/fr/user/android.rst
new file mode 100644
index 00000000..91501eea
--- /dev/null
+++ b/docs/fr/user/android.rst
@@ -0,0 +1,96 @@
1Application Android
2===================
3
4But de ce document
5------------------
6
7Ce document explique comment configurer votre application Android pour qu'elle fonctionne avec votre instance de wallabag. Il n'y a pas de différence dans cette procédure entre wallabag v1 et wallabag v2.
8
9Étapes pour configurer votre application
10----------------------------------------
11
12Quand vous démarrez l'application pour la première fois, vous voyez le message de bienvenue, où il vous est d'abord conseillé de configurer l'application avec votre instance de wallabag.
13
14.. image:: ../../img/user/android_welcome_screen.en.png
15 :alt: Écran de bienvenue
16 :align: center
17
18Vous devez confirmer le message et vous serez redirigé vers l'écran de configuration.
19
20.. image:: ../../img/user/android_configuration_screen.en.png
21 :alt: Écran de configuration
22 :align: center
23
24Saisissez vos données wallabag. Vous devez entrer l'adresse de votre instance de wallabag. **Il ne faut pas que cette adresse se termine par un slash**. Ajoutez également vos identifiants wallabag dans les champs correspondants.
25
26.. image:: ../../img/user/android_configuration_filled_in.en.png
27 :alt: Paramètres remplis
28 :align: center
29
30Après cet écran, appuyez sur le bouton de test de connexion et attendez que le test se termine.
31
32.. image:: ../../img/user/android_configuration_connection_test.en.png
33 :alt: Test de connexion
34 :align: center
35
36Le test de connexion devrait se terminer avec succès. Si ce n'est pas le cas, vous devez résoudre ça avant de continuer.
37
38.. image:: ../../img/user/android_configuration_connection_test_success.en.png
39 :alt: Test de connexion réussi
40 :align: center
41
42Après le test de connexion réussi, vous pouvez cliquer sur le bouton pour récupérer vos informations de flux (feed credentials). L'application essaie maintenant de se connecter à wallabag pour récupérer votre identifiant et votre jeton pour les flux RSS.
43
44.. image:: ../../img/user/android_configuration_get_feed_credentials.en.png
45 :alt: Récupération des informations de flux
46 :align: center
47
48Quand le processus est terminé avec succès, vous verrez une notification comme quoi l'identifiant et le jeton ont été remplis correctement.
49
50.. image:: ../../img/user/android_configuration_feed_credentials_automatically_filled_in.en.png
51 :alt: Récupération des informations correcte
52 :align: center
53
54Maintenant, vous devez naviguer jusqu'en bas de l'écran des paramètres. Bien sur, vous pouvez régler les paramètres comme vous le souhaitez. Enregistrez la configuration.
55
56.. image:: ../../img/user/android_configuration_scroll_bottom.en.png
57 :alt: Bottom of the settings screen
58 :align: center
59
60Après avoir enregistré les paramètres, vous vous retrouvez face à l'écran suivant. L'application vous propose de démarrer une synchronisation pour récupérer vos articles. Il est recommandé de confirmer cette action.
61
62.. image:: ../../img/user/android_configuration_saved_feed_update.en.png
63 :alt: Settings saved the first time
64 :align: center
65
66Une fois la synchronisation terminée avec succès, vous pouvez lire vos articles.
67
68.. image:: ../../img/user/android_unread_feed_synced.en.png
69 :alt: Filled article list cause feeds successfully synchronized
70 :align: center
71
72Limitations connues
73-------------------
74
75Double authentification (2FA)
76~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
77
78Actuellement, l'application Android ne supporte la double authentification. Vous devez la désactiver pour que l'application fonctionne correctement.
79
80Limiter le nombre d'articles avec wallabag v2
81~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
82
83Dans votre instance de wallabag, vous pouvez configurer combien d'articles se trouvent dans les flux RSS. Cette option n'existe pas dans wallabag v1, où tous les articles se retrouvent donc dans le flux RSS. So if you set the amount of articles being displayed greater than the number of items being content of your RSS feed, you will only see the number of items in your RSS feed.
84
85Cryptage SSL/TLS
86~~~~~~~~~~~~~~~~
87
88Si vous souhaitez accéder à votre instance de wallabag via HTTPS, vous devez le définir dans les paramètres. Surtout si votre URL HTTP redirige vers l'URL HTTPS. Actuellement, l'application ne gère pas cette redirection correctement.
89
90Références
91----------
92
93- `Code source de l'application Android <https://github.com/wallabag/android-app>`_
94- `Télécharger l'application Android sur F-Droid <https://f-droid.org/repository/browse/?fdfilter=wallabag&fdid=fr.gaulupeau.apps.InThePoche>`_
95- `Télécharger l'application Android sur Google Play <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_
96
diff --git a/docs/fr/user/annotations.rst b/docs/fr/user/annotations.rst
deleted file mode 100644
index 24585961..00000000
--- a/docs/fr/user/annotations.rst
+++ /dev/null
@@ -1,25 +0,0 @@
1Annotations
2===========
3
4Sur chaque article que vous lisez, vous pouvez écrire des annotations. Puisqu'une image vaut mieux qu'un long discours,
5voici ce que ça donne.
6
7Sélectionnez la zone du texte que vous souhaitez annoter et cliquez sur le crayon :
8
9.. image:: ../../img/user/annotations_1.png
10 :alt: Sélectionnez votre texte
11 :align: center
12
13Ensuite, écrivez votre annotation :
14
15.. image:: ../../img/user/annotations_2.png
16 :alt: Écrivez votre annotation
17 :align: center
18
19Le texte est maintenant surligné et vous pouvez lire le annotation en le survolant avec votre souris.
20
21.. image:: ../../img/user/annotations_3.png
22 :alt: Lisez votre annotation
23 :align: center
24
25Vous pouvez créer autant de annotations que vous le souhaitez.
diff --git a/docs/fr/user/articles.rst b/docs/fr/user/articles.rst
new file mode 100644
index 00000000..fb5b3837
--- /dev/null
+++ b/docs/fr/user/articles.rst
@@ -0,0 +1,123 @@
1Articles
2========
3
4Sauvegardez votre premier article
5---------------------------------
6
7La fonctionnalité principale de wallabag est de sauvegarder des articles.
8Vous avez plusieurs manières de le faire.
9
10.. note::
11
12 Un guide de démarrage s'affichera dans l'application jusqu'à ce que vous
13 enregistriez votre premier article.
14
15En utilisant le bookmarklet
16^^^^^^^^^^^^^^^^^^^^^^^^^^^
17
18Sur la page ``Aide``, vous avez un onglet ``Bookmarklet``. Glissez/déposez le lien ``bag it!``
19dans votre barre de favoris de votre navigateur.
20
21Maintennat, à chaque fois que vous lisez un article et que vous souhaitez le sauvegarder,
22cliquez sur le lien ``bag it!`` dans votre barre de favoris. L'article est enregistré.
23
24En utilisant le formulaire classique
25^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
26
27Dans la barre haut de wallabag, vous avez trois icônes. Avec la première icône,
28un signe plus, vous pouvez facilement ajouter un nouvel article.
29
30.. image:: ../../img/user/topbar.png
31 :alt: Barre supérieure
32 :align: center
33
34Cliquez dessus pour afficher un nouveau champ, collez-y l'URL de l'article et appuyez
35sur la touche ``Entrée``. L'article est enregistré.
36
37En utilisant l'extension de votre navigateur
38^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
39
40Firefox
41"""""""
42
43Vous pouvez télécharger `l'extension Firefox ici <https://addons.mozilla.org/firefox/addon/wallabag-v2/>`_.
44
45Chrome
46""""""
47
48Vous pouvez télécharger `l'extension Chrome ici <https://chrome.google.com/webstore/detail/wallabagger/gbmgphmejlcoihgedabhgjdkcahacjlj?hl=fr>`_.
49
50En utilisant l'application de votre smartphone
51^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
52
53Android
54"""""""
55
56Vous pouvez télécharger `l'application Android ici <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_.
57
58Windows Phone
59~~~~~~~~~~~~~
60
61Vous pouvez télécharger `l'application Windows Phone ici <https://www.microsoft.com/store/apps/9nblggh5x3p6>`_.
62
63Téléchargez vos articles
64------------------------
65
66Vous pouvez télécharger chaque article dans plusieurs formats : ePUB, MOBI, PDF, XML, JSON, CSV.
67
68Lorsque vous lisez un article, cliquez sur cette icône dans la barre latérale :
69
70.. image:: ../../img/user/download_article.png
71 :alt: Télécharger l'article
72 :align: center
73
74Vous pouvez aussi télécharger une catégorie (non lus, favoris, lus) dans ces formats.
75Par exemple, dans la vue **Non lus**, cliquez sur cette icône dans la barre supérieure :
76
77.. image:: ../../img/user/download_articles.png
78 :alt: Télécharger l'article
79 :align: center
80
81Partagez vos articles
82---------------------
83
84Quand vous lisez un article, vous pouvez le partager. Cliquez sur le bouton de partage :
85
86.. image:: ../../img/user/share.png
87 :alt: partager un article
88 :align: center
89
90Vous pouvez maintenant le partager :
91
92- avec une URL publique (vous obtiendrez une vue allégée de l'article)
93- avec un tweet
94- dans votre Shaarli
95- avec un message dans Diaspora*
96- sur Carrot
97- avec un email
98
99Annotez vos articles
100--------------------
101
102Sur chaque article que vous lisez, vous pouvez écrire des annotations. Puisqu'une image vaut mieux qu'un long discours,
103voici ce que ça donne.
104
105Sélectionnez la zone du texte que vous souhaitez annoter et cliquez sur le crayon :
106
107.. image:: ../../img/user/annotations_1.png
108 :alt: Sélectionnez votre texte
109 :align: center
110
111Ensuite, écrivez votre annotation :
112
113.. image:: ../../img/user/annotations_2.png
114 :alt: Écrivez votre annotation
115 :align: center
116
117Le texte est maintenant surligné et vous pouvez lire le annotation en le survolant avec votre souris.
118
119.. image:: ../../img/user/annotations_3.png
120 :alt: Lisez votre annotation
121 :align: center
122
123Vous pouvez créer autant de annotations que vous le souhaitez.
diff --git a/docs/fr/user/backup.rst b/docs/fr/user/backup.rst
index ec4b1f4d..f8cf87ee 100644
--- a/docs/fr/user/backup.rst
+++ b/docs/fr/user/backup.rst
@@ -23,4 +23,4 @@ Pour sauvegarder une base SQLite, vous devez juste copier le répertoire `data/d
23 23
24Images 24Images
25------ 25------
26Les images sauvegardées par wallabag sont stockées dans `data/assets/images` (le stockage des images sera implémenté dans wallabag 2.2). 26Les images sauvegardées par wallabag sont stockées dans `web/assets/images` (le stockage des images sera implémenté dans wallabag 2.2).
diff --git a/docs/fr/user/create_account.rst b/docs/fr/user/create_account.rst
index 6e188ab3..9c18e094 100644
--- a/docs/fr/user/create_account.rst
+++ b/docs/fr/user/create_account.rst
@@ -1,5 +1,8 @@
1Se créer un compte et se connecter
2==================================
3
1Se créer un compte 4Se créer un compte
2================== 5------------------
3 6
4Sur la page de connexion, cliquez sur le bouton ``Créer un compte``. 7Sur la page de connexion, cliquez sur le bouton ``Créer un compte``.
5 8
@@ -23,3 +26,17 @@ Votre compte est maintenant actif.
23.. image:: ../../img/user/activated_account.png 26.. image:: ../../img/user/activated_account.png
24 :alt: Bienvenue à bord ! 27 :alt: Bienvenue à bord !
25 :align: center 28 :align: center
29
30Se connecter
31------------
32
33Votre compte est maintenant actif, félicitations !
34
35Pour vous connecter à wallabag, remplissez le formulaire de connexion.
36
37Si vous êtes sur un ordinateur de confiance et que vous souhaitez rester connecté
38vous pouvez cocher la case ``Restez connecté`` : wallabag se souviendra de vous pour un an.
39
40.. image:: ../../img/user/login_form.png
41 :alt: Formulaire de connexion
42 :align: center
diff --git a/docs/fr/user/download_articles.rst b/docs/fr/user/download_articles.rst
deleted file mode 100644
index 39c98206..00000000
--- a/docs/fr/user/download_articles.rst
+++ /dev/null
@@ -1,17 +0,0 @@
1Télécharger des articles
2========================
3
4Vous pouvez télécharger chaque article dans plusieurs formats : ePUB, MOBI, PDF, XML, JSON, CSV.
5
6Lorsque vous lisez un article, cliquez sur cette icône dans la barre latérale :
7
8.. image:: ../../img/user/download_article.png
9 :alt: Télécharger l'article
10 :align: center
11
12Vous pouvez aussi télécharger une catégorie (non lus, favoris, lus) dans ces formats.
13Par exemple, dans la vue **Non lus**, cliquez sur cette icône dans la barre supérieure :
14
15.. image:: ../../img/user/download_articles.png
16 :alt: Télécharger l'article
17 :align: center
diff --git a/docs/fr/user/errors_during_fetching.rst b/docs/fr/user/errors_during_fetching.rst
index 1a60e4bd..13cbde1d 100644
--- a/docs/fr/user/errors_during_fetching.rst
+++ b/docs/fr/user/errors_during_fetching.rst
@@ -12,9 +12,7 @@ Il peut y avoir plusieurs raisons :
12Comment puis-je aider pour réparer ça ? 12Comment puis-je aider pour réparer ça ?
13--------------------------------------- 13---------------------------------------
14 14
15Vous pouvez `nous envoyer un email avec l'URL de l'article <mailto:hello@wallabag.org>`_. 15Vous pouvez essayer de résoudre ce problème vous même (comme ça, nous restons concentrés pour améliorer wallabag au lieu d'écrire ces fichiers de configuration :) ).
16
17Ou vous pouvez aussi essayer de résoudre ce problème vous même (comme ça, nous restons concentrés pour améliorer wallabag au lieu d'écrire ces fichiers de configuration :) ).
18 16
19Vous pouvez essayer de voir si ça fonctionne ici : `http://f43.me/feed/test <http://f43.me/feed/test>`_ (ce site utilise principalement la même manière de fonctionner que wallabag pour récupérer les articles). 17Vous pouvez essayer de voir si ça fonctionne ici : `http://f43.me/feed/test <http://f43.me/feed/test>`_ (ce site utilise principalement la même manière de fonctionner que wallabag pour récupérer les articles).
20 18
diff --git a/docs/fr/user/filters.rst b/docs/fr/user/filters.rst
index 6592f140..449bf010 100644
--- a/docs/fr/user/filters.rst
+++ b/docs/fr/user/filters.rst
@@ -1,5 +1,5 @@
1Filtres 1Retrouver des articles grâce aux filtres
2======= 2========================================
3 3
4Pour retrouver plus facilement vos articles, vous pouvez utiliser les filtres. 4Pour retrouver plus facilement vos articles, vous pouvez utiliser les filtres.
5Cliquez sur la troisième icône de la barre supérieure. 5Cliquez sur la troisième icône de la barre supérieure.
diff --git a/docs/fr/user/first_article.rst b/docs/fr/user/first_article.rst
deleted file mode 100644
index f482badc..00000000
--- a/docs/fr/user/first_article.rst
+++ /dev/null
@@ -1,68 +0,0 @@
1Sauvegardez votre premier article
2=================================
3
4La fonctionnalité principale de wallabag est de sauvegarder des articles.
5Vous avez plusieurs manières de le faire.
6
7.. note::
8
9 Un guide de démarrage s'affichera dans l'application jusqu'à ce que vous
10 enregistriez votre premier article.
11
12En utilisant le bookmarklet
13---------------------------
14
15Sur la page ``Aide``, vous avez un onglet ``Bookmarklet``. Glissez/déposez le lien ``bag it!``
16dans votre barre de favoris de votre navigateur.
17
18Maintennat, à chaque fois que vous lisez un article et que vous souhaitez le sauvegarder,
19cliquez sur le lien ``bag it!`` dans votre barre de favoris. L'article est enregistré.
20
21En utilisant le formulaire classique
22------------------------------------
23
24Dans la barre haut de wallabag, vous avez trois icônes. Avec la première icône,
25un signe plus, vous pouvez facilement ajouter un nouvel article.
26
27.. image:: ../../img/user/topbar.png
28 :alt: Barre supérieure
29 :align: center
30
31Cliquez dessus pour afficher un nouveau champ, collez-y l'URL de l'article et appuyez
32sur la touche ``Entrée``. L'article est enregistré.
33
34En utilisant l'extension de votre navigateur
35--------------------------------------------
36
37Firefox
38~~~~~~~
39
40*Cette extension n'est pas encore disponible pour wallabag v2*.
41
42Chrome
43~~~~~~
44
45*Cette extension n'est pas encore disponible pour wallabag v2*.
46
47En utilisant l'application de votre smartphone
48----------------------------------------------
49
50Android
51~~~~~~~
52
53*Cette application n'est pas encore disponible pour wallabag v2*.
54
55Firefox OS
56~~~~~~~~~~
57
58*Cette application n'est pas encore disponible pour wallabag v2*.
59
60Windows Phone
61~~~~~~~~~~~~~
62
63*Cette application n'est pas encore disponible pour wallabag v2*.
64
65iOS
66~~~
67
68*Cette application n'est pas encore disponible pour wallabag v2*.
diff --git a/docs/fr/user/import.rst b/docs/fr/user/import.rst
index 33062a33..a5d53247 100644
--- a/docs/fr/user/import.rst
+++ b/docs/fr/user/import.rst
@@ -1,8 +1,20 @@
1Migrer depuis un service externe 1Migrer depuis ...
2================================ 2=================
3 3
4Depuis Pocket 4Dans wallabag 2.x, vous pouvez importer des données depuis :
5------------- 5
6- `Pocket <#id1>`_
7- `Readability <#id2>`_
8- `Instapaper <#id4>`_
9- `wallabag 1.x <#id6>`_
10- `wallabag 2.x <#id7>`_
11
12Nous avons aussi développé `un script pour exécuter des migrations via la ligne de commande <#import-via-la-ligne-de-commande-cli>`_.
13
14Puisque les imports peuvent gourmands en ressource, nous avons mis en place un système de tâche asynchrone. `Vous trouverez la documentation ici <http://doc.wallabag.org/fr/master/developer/asynchronous.html>`_ (niveau expert).
15
16Pocket
17------
6 18
7Créer une nouvelle application dans Pocket 19Créer une nouvelle application dans Pocket
8~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 20~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -30,8 +42,8 @@ Vous devez autoriser wallabag à se connecter à votre compte Pocket.
30Vos données vont être importées. L'import de données est une action qui peut être couteuse 42Vos données vont être importées. L'import de données est une action qui peut être couteuse
31pour votre serveur. 43pour votre serveur.
32 44
33Depuis Readability 45Readability
34------------------ 46-----------
35 47
36Exportez vos données de Readability 48Exportez vos données de Readability
37~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 49~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -46,8 +58,8 @@ la section Readability et ensuite sélectionnez votre fichier json pour l'upload
46 58
47Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur. 59Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur.
48 60
49Depuis Instapaper 61Instapaper
50----------------- 62----------
51 63
52Exportez vos données de Instapaper 64Exportez vos données de Instapaper
53~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 65~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -62,8 +74,66 @@ la section Instapaper et ensuite sélectionnez votre fichier CSV pour l'uploader
62 74
63Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur. 75Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur.
64 76
77wallabag 1.x
78------------
79
80Si vous utilisiez wallabag v1.x, vous devez exporter vos données avant de migrer à wallabag v2.x, à cause du changement complet de l'application et de sa base de données. Sur votre ancienne instance de wallabag v1, vous pouvez exporter vos données en allant sur la page de configuration de l'application.
81
82.. image:: ../../img/user/export_v1.png
83 :alt: Export depuis wallabag v1
84 :align: center
85
86.. note::
87 Si vous avez plusieurs comptes sur la même instance de wallabag, chaque utilisateur doit exporter ses données depuis wallabag v1 et les importer dans la v2.
88
89.. note::
90 S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`_.
91
92Une fois que vous avez récupéré le fichier json contenant vos données, vous pouvez installer wallabag v2 si c'est nécessaire en suivant `la procédure standard <http://doc.wallabag.org/fr/master/user/installation.html>`_.
93
94Une fois que vous avez créé un compte utilisateur sur votre nouvelle instance de wallabag v2, rendez-vous dans la section `Import`. Vous devez choisir l'import depuis wallabag v1 puis sélectionner votre fichier json récupéré précédemment.
95
96.. image:: ../../img/user/import_wallabagv1.png
97 :alt: Import depuis wallabag v1
98 :align: center
99
100wallabag 2.x
101------------
102
103Depuis l'instance sur laquelle vous étiez, rendez-vous dans la section `Tous les articles`, puis exportez ces articles au format json.
104
105.. image:: ../../img/user/export_v2.png
106 :alt: Export depuis wallabag v2
107 :align: center
108
109Depuis votre nouvelle instance de wallabag, créez votre compte utilisateur puis cliquez sur le lien dans le menu pour accéder à l'import. Choisissez l'import depuis wallabag v2 puis sélectionnez votre fichier json pour l'uploader.
110
111.. note::
112 S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`_.
113
114Import via la ligne de commande (CLI)
115-------------------------------------<http://doc.wallabag.org/en/master/user/parameters.html
116
117Si vous avez accès à la ligne de commandes de votre serveur web, vous pouvez exécuter cette commande pour import votre fichier wallabag v1 :
118
119::
120
121 bin/console wallabag:import 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod
122
123Remplacez les valeurs :
124
125* ``1`` est l'identifiant de votre utilisateur en base (l'ID de votre premier utilisateur créé sur wallabag est 1)
126* ``~/Downloads/wallabag-export-1-2016-04-05.json`` est le chemin de votre export wallabag v1
127
128Si vous voulez marquer tous ces articles comme lus, vous pouvez ajouter l'option ``--markAsRead``.
129
130Pour importer un fichier wallabag v2, vous devez ajouter l'option ``--importer=v2``.
131
132Vous obtiendrez :
65 133
66Depuis un fichier HTML ou JSON 134::
67------------------------------
68 135
69*Fonctionnalité pas encore implémentée dans wallabag v2.* 136 Start : 05-04-2016 11:36:07 ---
137 403 imported
138 0 already saved
139 End : 05-04-2016 11:36:09 --- \ No newline at end of file
diff --git a/docs/fr/user/login.rst b/docs/fr/user/login.rst
deleted file mode 100644
index 522ac259..00000000
--- a/docs/fr/user/login.rst
+++ /dev/null
@@ -1,13 +0,0 @@
1Se connecter
2============
3
4Votre compte est maintenant actif, félicitations !
5
6Pour vous connecter à wallabag, remplissez le formulaire de connexion.
7
8Si vous êtes sur un ordinateur de confiance et que vous souhaitez rester connecté
9vous pouvez cocher la case ``Restez connecté`` : wallabag se souviendra de vous pour un an.
10
11.. image:: ../../img/user/login_form.png
12 :alt: Formulaire de connexion
13 :align: center
diff --git a/docs/fr/user/migration.rst b/docs/fr/user/migration.rst
deleted file mode 100644
index 91f8bab2..00000000
--- a/docs/fr/user/migration.rst
+++ /dev/null
@@ -1,66 +0,0 @@
1Migrer depuis la v1 ou la v2
2============================
3
4Depuis wallabag 1.x
5-------------------
6
7Si vous utilisiez wallabag v1.x, vous devez exporter vos données avant de migrer à wallabag v2.x, à cause du changement complet de l'application et de sa base de données. Sur votre ancienne instance de wallabag v1, vous pouvez exporter vos données en allant sur la page de configuration de l'application.
8
9.. image:: ../../img/user/export_v1.png
10 :alt: Export depuis wallabag v1
11 :align: center
12
13.. note::
14 Si vous avez plusieurs comptes sur la même instance de wallabag, chaque utilisateur doit exporter ses données depuis wallabag v1 et les importer dans la v2.
15
16.. note::
17 S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`__.
18
19Une fois que vous avez récupéré le fichier json contenant vos données, vous pouvez installer wallabag v2 si c'est nécessaire en suivant `la procédure standard <http://doc.wallabag.org/fr/master/user/installation.html>`__.
20
21Une fois que vous avez créé un compte utilisateur sur votre nouvelle instance de wallabag v2, rendez-vous dans la section `Import`. Vous devez choisir l'import depuis wallabag v1 puis sélectionner votre fichier json récupéré précédemment.
22
23.. image:: ../../img/user/import_wallabagv1.png
24 :alt: Import depuis wallabag v1
25 :align: center
26
27Depuis wallabag 2.x
28-------------------
29
30Depuis l'instance sur laquelle vous étiez, rendez-vous dans la section `Tous les articles`, puis exportez ces articles au format json.
31
32.. image:: ../../img/user/export_v2.png
33 :alt: Export depuis wallabag v2
34 :align: center
35
36Depuis votre nouvelle instance de wallabag, créez votre compte utilisateur puis cliquez sur le lien dans le menu pour accéder à l'import. Choisissez l'import depuis wallabag v2 puis sélectionnez votre fichier json pour l'uploader.
37
38.. note::
39 S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`__.
40
41Import via la ligne de commande (CLI)
42-------------------------------------
43
44Si vous avez accès à la ligne de commandes de votre serveur web, vous pouvez exécuter cette commande pour import votre fichier wallabag v1 :
45
46::
47
48 bin/console wallabag:import 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod
49
50Remplacez les valeurs :
51
52* ``1`` est l'identifiant de votre utilisateur en base (l'ID de votre premier utilisateur créé sur wallabag est 1)
53* ``~/Downloads/wallabag-export-1-2016-04-05.json`` est le chemin de votre export wallabag v1
54
55Si vous voulez marquer tous ces articles comme lus, vous pouvez ajouter l'option ``--markAsRead``.
56
57Pour importer un fichier wallabag v2, vous devez ajouter l'option ``--importer=v2``.
58
59Vous obtiendrez :
60
61::
62
63 Start : 05-04-2016 11:36:07 ---
64 403 imported
65 0 already saved
66 End : 05-04-2016 11:36:09 ---
diff --git a/docs/fr/user/parameters.rst b/docs/fr/user/parameters.rst
index ec8c8995..d1c20ceb 100644
--- a/docs/fr/user/parameters.rst
+++ b/docs/fr/user/parameters.rst
@@ -1,5 +1,48 @@
1À quoi servent les paramètres ? 1À quoi servent les paramètres ?
2=============================== 2===============================
3
4Fichier `parameters.yml` par défaut
5-----------------------------------
6
7Voici la dernière version par défaut du fichier `app/config/parameters.yml`. Soyez sur que le votre respecte celui-ci.
8Si vous ne savez pas quelle valeur vous devez mettre, laissez celle par défaut.
9
10.. code-block:: yml
11
12 parameters:
13 database_driver: pdo_sqlite
14 database_host: 127.0.0.1
15 database_port: null
16 database_name: symfony
17 database_user: root
18 database_password: null
19 database_path: '%kernel.root_dir%/../data/db/wallabag.sqlite'
20 database_table_prefix: wallabag_
21 database_socket: null
22 mailer_transport: smtp
23 mailer_host: 127.0.0.1
24 mailer_user: null
25 mailer_password: null
26 locale: en
27 secret: ovmpmAWXRCabNlMgzlzFXDYmCFfzGv
28 twofactor_auth: true
29 twofactor_sender: no-reply@wallabag.org
30 fosuser_registration: true
31 fosuser_confirmation: true
32 from_email: no-reply@wallabag.org
33 rss_limit: 50
34 rabbitmq_host: localhost
35 rabbitmq_port: 5672
36 rabbitmq_user: guest
37 rabbitmq_password: guest
38 redis_scheme: tcp
39 redis_host: localhost
40 redis_port: 6379
41 redis_path: null
42
43Meaning of each parameter
44-------------------------
45
3.. csv-table:: Paramètres de base de données 46.. csv-table:: Paramètres de base de données
4 :header: "name", "default", "description" 47 :header: "name", "default", "description"
5 48
diff --git a/docs/fr/user/share.rst b/docs/fr/user/share.rst
deleted file mode 100644
index b5faa5ba..00000000
--- a/docs/fr/user/share.rst
+++ /dev/null
@@ -1,17 +0,0 @@
1Partager des articles
2=====================
3
4Quand vous lisez un article, vous pouvez le partager. Cliquez sur le bouton de partage :
5
6.. image:: ../../img/user/share.png
7 :alt: partager un article
8 :align: center
9
10Vous pouvez maintenant le partager :
11
12- avec une URL publique (vous obtiendrez une vue allégée de l'article)
13- avec un tweet
14- dans votre Shaarli
15- avec un message dans Diaspora*
16- sur Carrot
17- avec un email
diff --git a/docs/fr/user/upgrade-2.0.x-2.1.1.rst b/docs/fr/user/upgrade-2.0.x-2.1.1.rst
deleted file mode 100644
index f74c2fcd..00000000
--- a/docs/fr/user/upgrade-2.0.x-2.1.1.rst
+++ /dev/null
@@ -1,87 +0,0 @@
1Mettre à jour de la 2.0.x à la 2.1.1
2====================================
3
4.. warning::
5Avant cette migration, si vous aviez configuré l'import depuis Pocket en ajoutant votre consumer key dans les paramètres internes, pensez à effectuer une sauvegarde de celle-ci : vous devrez l'ajouter dans la configuration de wallabag après la mise à jour.
6
7Mise à jour sur un serveur dédié
8--------------------------------
9
10::
11
12 rm -rf var/cache/*
13 git fetch origin
14 git fetch --tags
15 git checkout 2.1.1 --force
16 SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
17 php bin/console doctrine:migrations:migrate --env=prod
18 php bin/console cache:clear --env=prod
19
20Mise à jour sur un hébergement mutualisé
21----------------------------------------
22
23Effectuez une sauvegarde du fichier ``app/config/parameters.yml``.
24
25Téléchargez la dernière version de wallabag :
26
27.. code-block:: bash
28
29 wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz
30
31(hash md5 de l'archive 2.1.1 : ``9584a3b60a2b2a4de87f536548caac93``)
32
33Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre.
34
35Vérifiez que votre fichier ``app/config/parameters.yml`` contient tous les paramètres requis. Voici un fichier ``parameters.yml`` par défaut. Si vous ne savez pas quelle valeur mettre à un paramètre, laissez la valeur par défaut.
36
37.. code-block:: yml
38
39 parameters:
40 database_driver: pdo_sqlite
41 database_host: 127.0.0.1
42 database_port: null
43 database_name: symfony
44 database_user: root
45 database_password: null
46 database_path: '%kernel.root_dir%/../data/db/wallabag.sqlite'
47 database_table_prefix: wallabag_
48 database_socket: null
49 mailer_transport: smtp
50 mailer_host: 127.0.0.1
51 mailer_user: null
52 mailer_password: null
53 locale: en
54 secret: ovmpmAWXRCabNlMgzlzFXDYmCFfzGv
55 twofactor_auth: true
56 twofactor_sender: no-reply@wallabag.org
57 fosuser_registration: true
58 fosuser_confirmation: true
59 from_email: no-reply@wallabag.org
60 rss_limit: 50
61 rabbitmq_host: localhost
62 rabbitmq_port: 5672
63 rabbitmq_user: guest
64 rabbitmq_password: guest
65 redis_scheme: tcp
66 redis_host: localhost
67 redis_port: 6379
68 redis_path: null
69
70Vous trouverez `ici une documentation détaillée concernant les paramètres <http://doc.wallabag.org/fr/master/user/parameters.html>`_.
71
72Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``.
73
74Videz le répertoire ``var/cache``.
75
76Vous allez devoir également exécuter des requêtes SQL pour mettre à jour votre base de données. Nous partons du principe que le préfixe de vos tables est ``wallabag_`` et que le serveur SQL est un serveur MySQL :
77
78.. code-block:: sql
79
80 ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL;
81 INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry');
82 ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL;
83 INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import');
84 INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import');
85 ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL;
86 DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key';
87
diff --git a/docs/fr/user/upgrade-2.1.x-2.1.y.rst b/docs/fr/user/upgrade-2.1.x-2.1.y.rst
deleted file mode 100644
index 2d3b452b..00000000
--- a/docs/fr/user/upgrade-2.1.x-2.1.y.rst
+++ /dev/null
@@ -1,30 +0,0 @@
1Mettre à jour de la 2.1.x à la 2.1.y
2====================================
3
4Mise à jour sur un serveur dédié
5--------------------------------
6
7La dernière version de wallabag est publiée à cette adresse : https://www.wallabag.org/pages/download-wallabag.html. Pour mettre à jour votre installation de wallabag, exécutez les commandes suivantes dans votre répertoire d'installation (remplacez ``2.1.3`` par le numéro de la dernière version) :
8
9::
10
11 make update
12
13Mise à jour sur un hébergement mutualisé
14----------------------------------------
15
16Effectuez une sauvegarde du fichier ``app/config/parameters.yml``.
17
18Téléchargez la dernière version de wallabag :
19
20.. code-block:: bash
21
22 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
23
24Vous trouverez `le hash md5 du dernier package sur notre site <https://www.wallabag.org/pages/download-wallabag.html>`_.
25
26Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre.
27
28Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``.
29
30Videz le répertoire ``var/cache``.
diff --git a/docs/fr/user/upgrade.rst b/docs/fr/user/upgrade.rst
new file mode 100644
index 00000000..c3d33904
--- /dev/null
+++ b/docs/fr/user/upgrade.rst
@@ -0,0 +1,102 @@
1Mettre à jour votre installation de wallabag
2============================================
3
4Vous trouverez ici différentes manières de mettre à jour wallabag :
5
6- `de la 2.0.x à la 2.1.1 <#mettre-a-jour-de-la-2-0-x-a-la-2-1-1>`_
7- `de la 2.1.x à la 2.1.y <#mettre-a-jour-de-la-2-1-x-a-la-2-1-y>`_
8- `de la 1.x à la 2.x <#depuis-wallabag-1-x>`_
9
10Mettre à jour de la 2.0.x à la 2.1.1
11------------------------------------
12
13.. warning::
14Avant cette migration, si vous aviez configuré l'import depuis Pocket en ajoutant votre consumer key dans les paramètres internes, pensez à effectuer une sauvegarde de celle-ci : vous devrez l'ajouter dans la configuration de wallabag après la mise à jour.
15
16Mise à jour sur un serveur dédié
17^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
18
19::
20
21 rm -rf var/cache/*
22 git fetch origin
23 git fetch --tags
24 git checkout 2.1.1 --force
25 SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
26 php bin/console doctrine:migrations:migrate --env=prod
27 php bin/console cache:clear --env=prod
28
29Mise à jour sur un hébergement mutualisé
30^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
31
32Effectuez une sauvegarde du fichier ``app/config/parameters.yml``.
33
34Téléchargez la version 2.1.1 de wallabag :
35
36.. code-block:: bash
37
38 wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz
39
40(hash md5 de l'archive 2.1.1 : ``9584a3b60a2b2a4de87f536548caac93``)
41
42Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre.
43
44Merci de vérifier que votre fichier ``app/config/parameters.yml`` contient tous les paramètres requis. Vous trouverez `ici une documentation détaillée concernant les paramètres <http://doc.wallabag.org/fr/master/user/parameters.html>`_.
45
46Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``.
47
48Videz le répertoire ``var/cache``.
49
50Vous allez devoir également exécuter des requêtes SQL pour mettre à jour votre base de données. Nous partons du principe que le préfixe de vos tables est ``wallabag_`` et que le serveur SQL est un serveur MySQL :
51
52.. code-block:: sql
53
54 ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL;
55 INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry');
56 ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL;
57 INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import');
58 INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import');
59 ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL;
60 DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key';
61
62Mettre à jour de la 2.1.x à la 2.1.y
63------------------------------------
64
65Mise à jour sur un serveur dédié
66^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
67
68Pour mettre à jour votre installation de wallabag et récupérer la dernière version, exécutez la commande suivante dans votre répertoire d'installation :
69
70::
71
72 make update
73
74Mise à jour sur un hébergement mutualisé
75^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
76
77Effectuez une sauvegarde du fichier ``app/config/parameters.yml``.
78
79Téléchargez la dernière version de wallabag :
80
81.. code-block:: bash
82
83 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
84
85Vous trouverez `le hash md5 du dernier package sur notre site <https://www.wallabag.org/pages/download-wallabag.html>`_.
86
87Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre.
88
89Merci de vérifier que votre fichier ``app/config/parameters.yml`` contient tous les paramètres requis. Vous trouverez `ici une documentation détaillée concernant les paramètres <http://doc.wallabag.org/fr/master/user/parameters.html>`_.
90
91Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``.
92
93Videz le répertoire ``var/cache``.
94
95Depuis wallabag 1.x
96-------------------
97
98Il n'y a pas de script automatique pour mettre à jour wallabag 1.x en wallabag 2.x. Vous devez :
99
100- exportez vos données
101- installer wallabag 2.x (`lisez la documentation d'installation <http://doc.wallabag.org/fr/master/user/installation.html>`_ )
102- importer vos données dans votre installation toute propre (`lisez la documentation d'import <http://doc.wallabag.org/fr/master/user/import.html>`_ )