aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/fr/user
diff options
context:
space:
mode:
authorJeremy Benoist <j0k3r@users.noreply.github.com>2016-05-07 11:10:21 +0200
committerJeremy Benoist <j0k3r@users.noreply.github.com>2016-05-07 11:10:21 +0200
commit1556c925a42619c1298edebb73eb86c009b3f3c8 (patch)
tree2e893a9ed9ab1fb28db290d3643d7945e0ad611b /docs/fr/user
parentf54de6817ea320e6d92bea368123b2fb1395d95f (diff)
parente0f4f25fd6fba6f41532e9bf5cb6fa4c515c7a46 (diff)
downloadwallabag-1556c925a42619c1298edebb73eb86c009b3f3c8.tar.gz
wallabag-1556c925a42619c1298edebb73eb86c009b3f3c8.tar.zst
wallabag-1556c925a42619c1298edebb73eb86c009b3f3c8.zip
Merge pull request #2016 from wallabag/update-documentation
Update documentation
Diffstat (limited to 'docs/fr/user')
-rw-r--r--docs/fr/user/create_account.rst21
-rw-r--r--docs/fr/user/faq.rst25
-rw-r--r--docs/fr/user/import.rst43
-rw-r--r--docs/fr/user/installation.rst94
-rw-r--r--docs/fr/user/login.rst10
-rw-r--r--docs/fr/user/migration.rst4
-rw-r--r--docs/fr/user/upgrade.rst32
7 files changed, 144 insertions, 85 deletions
diff --git a/docs/fr/user/create_account.rst b/docs/fr/user/create_account.rst
index 7f29b0f0..6e188ab3 100644
--- a/docs/fr/user/create_account.rst
+++ b/docs/fr/user/create_account.rst
@@ -23,24 +23,3 @@ Votre compte est maintenant actif.
23.. image:: ../../img/user/activated_account.png 23.. image:: ../../img/user/activated_account.png
24 :alt: Bienvenue à bord ! 24 :alt: Bienvenue à bord !
25 :align: center 25 :align: center
26
27Foire aux questions
28-------------------
29
30Je ne peux pas valider le formulaire de création de compte
31~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32
33Soyez sur d'avoir bien renseigné tous les champs :
34
35* une adresse email valide
36* le même mot de passe dans les deux champs
37
38Je n'ai pas reçu mon email d'activation
39~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
40
41Êtes-vous sur d'avoir renseigné votre bonne adresse ? Avez-vous vérifié le dossier de spams ?
42
43Quand je clique sur le lien d'activation, j'ai ce message : ``The user with confirmation token "DtrOPfbQeVkWf6N" does not exist``.
44~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
45
46Vous avez déjà activé votre compte ou l'URL d'activation n'est pas correcte.
diff --git a/docs/fr/user/faq.rst b/docs/fr/user/faq.rst
index f5ae2776..e220c8a7 100644
--- a/docs/fr/user/faq.rst
+++ b/docs/fr/user/faq.rst
@@ -8,3 +8,28 @@ Il semblerait que vous ayiez un problème avec votre installation de ``composer`
8 8
9`Vous pouvez lire la documentation de composer pour savoir comment l'installer 9`Vous pouvez lire la documentation de composer pour savoir comment l'installer
10<https://getcomposer.org/doc/00-intro.md>`__. 10<https://getcomposer.org/doc/00-intro.md>`__.
11
12Je ne peux pas valider le formulaire de création de compte
13----------------------------------------------------------
14
15Soyez sur d'avoir bien renseigné tous les champs :
16
17* une adresse email valide
18* le même mot de passe dans les deux champs
19
20Je n'ai pas reçu mon email d'activation
21---------------------------------------
22
23Êtes-vous sur d'avoir renseigné votre bonne adresse ? Avez-vous vérifié le dossier de spams ?
24
25Quand je clique sur le lien d'activation, j'ai ce message : ``The user with confirmation token "DtrOPfbQeVkWf6N" does not exist``.
26----------------------------------------------------------------------------------------------------------------------------------
27
28Vous avez déjà activé votre compte ou l'URL d'activation n'est pas correcte.
29
30J'ai oublié mon mot de passe
31----------------------------
32
33Vous pouvez réinitialiser votre mot de passe en cliquant sur ``Mot de passe oublié ?``,
34sur la page de connexion. Ensuite, renseignez votre adresse email ou votre nom d'utilisateur,
35un email vous sera envoyé.
diff --git a/docs/fr/user/import.rst b/docs/fr/user/import.rst
index 967df1f6..e6c2fa02 100644
--- a/docs/fr/user/import.rst
+++ b/docs/fr/user/import.rst
@@ -1,42 +1,5 @@
1Migrer à wallabag 1Migrer depuis un service externe
2================= 2================================
3
4Depuis wallabag
5---------------
6
7Exportez vos données de wallabag 1.x
8~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9
10Sur la page de configuration, cliquez sur ``Export JSON`` dans la section ``Exportez vos données wallabag``.
11
12.. image:: ../../img/user/export_wllbg_1.png
13 :alt: Export depuis wallabag 1.x
14 :align: center
15
16Vous obtiendrez un fichier ``wallabag-export-1-1970-01-01.json``.
17
18Exportez vos données de wallabag 2.x
19~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20
21Dans la barre latérale de téléchargement, cliquez sur ``JSON``.
22
23.. image:: ../../img/user/export_wllbg_2.png
24 :alt: Export depuis wallabag 2.x
25 :align: center
26
27Vous obtiendrez un fichier ``Unread articles.json``.
28
29Importez vos données wallabag 2.x
30~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
31
32Cliquez sur le lien ``Importer`` dans le menu, choisissez la version de wallabag correspondante,
33sélectionnez votre fichier d'export sur votre ordinateur et importez-le.
34
35.. image:: ../../img/user/import_wllbg.png
36 :alt: Import depuis wallabag 1.x
37 :align: center
38
39Tous vos articles wallabag seront importés.
40 3
41Depuis Pocket 4Depuis Pocket
42------------- 5-------------
@@ -53,7 +16,7 @@ Vous devez créer une nouvelle application sur leur site dédié aux développeu
53 termes d'utilisation du service et soumettez votre application 16 termes d'utilisation du service et soumettez votre application
54 17
55Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`). 18Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`).
56Vous devez configurer la ``pocket_consumer_key`` dans le fichier ``app/config/parameters.yml``. 19Vous devez configurer la ``pocket_consumer_key`` dans la section ``Import`` du menu ``Configuration interne``.
57 20
58Maintenant, tout est bien configuré pour migrer depuis Pocket. 21Maintenant, tout est bien configuré pour migrer depuis Pocket.
59 22
diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst
index 33a2cf5c..8f2ae25d 100644
--- a/docs/fr/user/installation.rst
+++ b/docs/fr/user/installation.rst
@@ -32,6 +32,9 @@ wallabag utilise PDO afin de se connecter à une base de données, donc vous aur
32Installation 32Installation
33------------ 33------------
34 34
35Sur un serveur dédié (méthode conseillée)
36~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
37
35wallabag utilise un grand nombre de bibliothèques pour fonctionner. Ces bibliothèques doivent être installées à l'aide d'un outil nommé Composer. Vous devez l'installer si ce n'est déjà fait. 38wallabag utilise un grand nombre de bibliothèques pour fonctionner. Ces bibliothèques doivent être installées à l'aide d'un outil nommé Composer. Vous devez l'installer si ce n'est déjà fait.
36 39
37Installation de Composer : 40Installation de Composer :
@@ -60,13 +63,47 @@ Pour démarrer le serveur interne à php et vérifier que tout s'est installé c
60 63
61Et accéder wallabag à l'adresse http://lipdevotreserveur:8000 64Et accéder wallabag à l'adresse http://lipdevotreserveur:8000
62 65
63.. note:: 66.. tip::
64 Pour définir des paramètres via des variables d'environnement, vous pouvez les spécifier avec le préfixe ``SYMFONY__``. Par exemple, ``SYMFONY__DATABASE_DRIVER``. Vous pouvez lire `documentation Symfony <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ pour en savoir plus. 67 Pour définir des paramètres via des variables d'environnement, vous pouvez les spécifier avec le préfixe ``SYMFONY__``. Par exemple, ``SYMFONY__DATABASE_DRIVER``. Vous pouvez lire `documentation Symfony <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ pour en savoir plus.
65 68
66Installation avec Apache 69Sur un serveur mutualisé
70~~~~~~~~~~~~~~~~~~~~~~~~
71
72Nous mettons à votre disposition une archive avec toutes les dépendances à l'intérieur.
73La configuration par défaut utilise SQLite pour la base de données. Si vous souhaitez changer ces paramètres, vous devez modifier le fichier ``app/config/parameters.yml``.
74
75Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``.
76
77.. caution:: Avec cette archive, wallabag ne vérifie pas si les extensions obligatoires sont présentes sur votre serveur pour bien fonctionner (ces vérifications sont faites durant le ``composer install`` quand vous avez un serveur dédié, voir ci-dessus).
78
79Exécutez cette commande pour télécharger et décompresser l'archive :
80
81.. code-block:: bash
82
83 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
84
85Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag.
86Si vous avez changé la configuration pour modifier le type de stockage (MySQL ou PostgreSQL), vous devrez vous créer un utilisateur via la commande ``php bin/console wallabag:install --env=prod``.
87
88Installation avec Docker
67------------------------ 89------------------------
68 90
69En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag et que vous utilisiez php comme un module Apache, voici un vhost pour wallabag : 91Nous vous proposons une image Docker pour installer wallabag facilement. Allez voir du côté de `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ pour plus d'informations.
92
93Commande pour démarrer le containeur
94~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
95
96.. code-block:: bash
97
98 docker pull wallabag/wallabag
99
100Virtual hosts
101-------------
102
103Configuration avec Apache
104~~~~~~~~~~~~~~~~~~~~~~~~~
105
106En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag`` et que vous utilisiez PHP comme un module Apache, voici un vhost pour wallabag :
70 107
71:: 108::
72 109
@@ -108,10 +145,10 @@ En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallab
108 145
109Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. 146Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
110 147
111Installation avec Nginx 148Configuration avec Nginx
112----------------------- 149~~~~~~~~~~~~~~~~~~~~~~~~
113 150
114En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag, voici un fichier de configuration Nginx pour wallabag : 151En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag``, voici un fichier de configuration Nginx pour wallabag :
115 152
116:: 153::
117 154
@@ -148,23 +185,57 @@ En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallab
148 185
149Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. 186Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
150 187
151 188.. tip::
152.. note::
153 189
154 Si vous voulez importer un fichier important dans wallabag, vous devez ajouter cette ligne dans votre configuration nginx ``client_max_body_size XM; # allows file uploads up to X megabytes``. 190 Si vous voulez importer un fichier important dans wallabag, vous devez ajouter cette ligne dans votre configuration nginx ``client_max_body_size XM; # allows file uploads up to X megabytes``.
155 191
192Configuration avec lighttpd
193~~~~~~~~~~~~~~~~~~~~~~~~~~~
194
195En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag``, voici un fichier de configuration pour wallabag (éditez votre fichier ``lighttpd.conf`` collez-y cette configuration) :
196
197::
198
199 server.modules = (
200 "mod_fastcgi",
201 "mod_access",
202 "mod_alias",
203 "mod_compress",
204 "mod_redirect",
205 "mod_rewrite",
206 )
207 server.document-root = "/var/www/wallabag/web"
208 server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
209 server.errorlog = "/var/log/lighttpd/error.log"
210 server.pid-file = "/var/run/lighttpd.pid"
211 server.username = "www-data"
212 server.groupname = "www-data"
213 server.port = 80
214 server.follow-symlink = "enable"
215 index-file.names = ( "index.php", "index.html", "index.lighttpd.html")
216 url.access-deny = ( "~", ".inc" )
217 static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )
218 compress.cache-dir = "/var/cache/lighttpd/compress/"
219 compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" )
220 include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port
221 include_shell "/usr/share/lighttpd/create-mime.assign.pl"
222 include_shell "/usr/share/lighttpd/include-conf-enabled.pl"
223 dir-listing.activate = "disable"
224
225 url.rewrite-if-not-file = (
226 "^/([^?])(?:\?(.))?" => "/app.php?$1&$2",
227 "^/([^?]*)" => "/app.php?=$1",
228 )
156 229
157Droits d'accès aux dossiers du projet 230Droits d'accès aux dossiers du projet
158------------------------------------- 231-------------------------------------
159 232
160
161Environnement de test 233Environnement de test
162~~~~~~~~~~~~~~~~~~~~~ 234~~~~~~~~~~~~~~~~~~~~~
163 235
164Quand nous souhaitons juste tester wallabag, nous lançons simplement la commande ``php bin/console server:run --env=prod`` pour démarrer l'instance wallabag et tout se passe correctement car l'utilisateur qui a démarré le projet a accès naturellement au repertoire courant, tout va bien. 236Quand nous souhaitons juste tester wallabag, nous lançons simplement la commande ``php bin/console server:run --env=prod`` pour démarrer l'instance wallabag et tout se passe correctement car l'utilisateur qui a démarré le projet a accès naturellement au repertoire courant, tout va bien.
165 237
166 238Environnement de production
167Environnement de production
168~~~~~~~~~~~~~~~~~~~~~~~~~~~ 239~~~~~~~~~~~~~~~~~~~~~~~~~~~
169 240
170Dès lors que nous utilisons Apache ou Nginx pour accéder à notre instance wallabag, et non plus la commande ``php bin/console server:run --env=prod`` pour la démarrer, il faut prendre garde à octroyer les bons droits aux bons dossiers afin de préserver la sécurité de l'ensemble des fichiers fournis par le projet. 241Dès lors que nous utilisons Apache ou Nginx pour accéder à notre instance wallabag, et non plus la commande ``php bin/console server:run --env=prod`` pour la démarrer, il faut prendre garde à octroyer les bons droits aux bons dossiers afin de préserver la sécurité de l'ensemble des fichiers fournis par le projet.
@@ -178,4 +249,3 @@ Cela est dû au fait qu'il faut aussi octroyer les mêmes droits d'accès au dos
178.. code-block:: bash 249.. code-block:: bash
179 250
180 chown -R www-data:www-data /var/www/wallabag/var 251 chown -R www-data:www-data /var/www/wallabag/var
181
diff --git a/docs/fr/user/login.rst b/docs/fr/user/login.rst
index 3a02d1d5..522ac259 100644
--- a/docs/fr/user/login.rst
+++ b/docs/fr/user/login.rst
@@ -11,13 +11,3 @@ vous pouvez cocher la case ``Restez connecté`` : wallabag se souviendra de vous
11.. image:: ../../img/user/login_form.png 11.. image:: ../../img/user/login_form.png
12 :alt: Formulaire de connexion 12 :alt: Formulaire de connexion
13 :align: center 13 :align: center
14
15Foire aux questions
16-------------------
17
18J'ai oublié mon mot de passe
19~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20
21Vous pouvez réinitialiser votre mot de passe en cliquant sur ``Mot de passe oublié ?``,
22sur la page de connexion. Ensuite, renseignez votre adresse email ou votre nom d'utilisateur,
23un email vous sera envoyé.
diff --git a/docs/fr/user/migration.rst b/docs/fr/user/migration.rst
index 012c4988..66024572 100644
--- a/docs/fr/user/migration.rst
+++ b/docs/fr/user/migration.rst
@@ -1,5 +1,5 @@
1Migrer wallabag 1Migrer depuis la v1 ou la v2
2=============== 2============================
3 3
4Depuis wallabag 1.x 4Depuis wallabag 1.x
5------------------- 5-------------------
diff --git a/docs/fr/user/upgrade.rst b/docs/fr/user/upgrade.rst
new file mode 100644
index 00000000..84a1692d
--- /dev/null
+++ b/docs/fr/user/upgrade.rst
@@ -0,0 +1,32 @@
1Mettre à jour wallabag
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.0.3`` par le numéro de la dernière version) :
8
9::
10
11 git fetch origin
12 git fetch --tags
13 git checkout 2.0.3
14 SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
15 php bin/console cache:clear --env=prod
16
17Mise à jour sur un hébergement mutualisé
18----------------------------------------
19
20Effectuez une sauvegarde du fichier ``app/config/parameters.yml``.
21
22Téléchargez la dernière version de wallabag :
23
24.. code-block:: bash
25
26 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
27
28Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre.
29
30Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``.
31
32Videz le répertoire ``var/cache``.