diff options
Diffstat (limited to 'docs/fr/user')
-rw-r--r-- | docs/fr/user/create_account.rst | 21 | ||||
-rw-r--r-- | docs/fr/user/faq.rst | 25 | ||||
-rw-r--r-- | docs/fr/user/import.rst | 43 | ||||
-rw-r--r-- | docs/fr/user/installation.rst | 94 | ||||
-rw-r--r-- | docs/fr/user/login.rst | 10 | ||||
-rw-r--r-- | docs/fr/user/migration.rst | 4 | ||||
-rw-r--r-- | docs/fr/user/upgrade.rst | 32 |
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 | |||
27 | Foire aux questions | ||
28 | ------------------- | ||
29 | |||
30 | Je ne peux pas valider le formulaire de création de compte | ||
31 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
32 | |||
33 | Soyez 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 | |||
38 | Je 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 | |||
43 | Quand je clique sur le lien d'activation, j'ai ce message : ``The user with confirmation token "DtrOPfbQeVkWf6N" does not exist``. | ||
44 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
45 | |||
46 | Vous 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 | |||
12 | Je ne peux pas valider le formulaire de création de compte | ||
13 | ---------------------------------------------------------- | ||
14 | |||
15 | Soyez 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 | |||
20 | Je 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 | |||
25 | Quand je clique sur le lien d'activation, j'ai ce message : ``The user with confirmation token "DtrOPfbQeVkWf6N" does not exist``. | ||
26 | ---------------------------------------------------------------------------------------------------------------------------------- | ||
27 | |||
28 | Vous avez déjà activé votre compte ou l'URL d'activation n'est pas correcte. | ||
29 | |||
30 | J'ai oublié mon mot de passe | ||
31 | ---------------------------- | ||
32 | |||
33 | Vous pouvez réinitialiser votre mot de passe en cliquant sur ``Mot de passe oublié ?``, | ||
34 | sur la page de connexion. Ensuite, renseignez votre adresse email ou votre nom d'utilisateur, | ||
35 | un 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 @@ | |||
1 | Migrer à wallabag | 1 | Migrer depuis un service externe |
2 | ================= | 2 | ================================ |
3 | |||
4 | Depuis wallabag | ||
5 | --------------- | ||
6 | |||
7 | Exportez vos données de wallabag 1.x | ||
8 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
9 | |||
10 | Sur 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 | |||
16 | Vous obtiendrez un fichier ``wallabag-export-1-1970-01-01.json``. | ||
17 | |||
18 | Exportez vos données de wallabag 2.x | ||
19 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
20 | |||
21 | Dans 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 | |||
27 | Vous obtiendrez un fichier ``Unread articles.json``. | ||
28 | |||
29 | Importez vos données wallabag 2.x | ||
30 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
31 | |||
32 | Cliquez sur le lien ``Importer`` dans le menu, choisissez la version de wallabag correspondante, | ||
33 | sé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 | |||
39 | Tous vos articles wallabag seront importés. | ||
40 | 3 | ||
41 | Depuis Pocket | 4 | Depuis 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 | ||
55 | Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`). | 18 | Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`). |
56 | Vous devez configurer la ``pocket_consumer_key`` dans le fichier ``app/config/parameters.yml``. | 19 | Vous devez configurer la ``pocket_consumer_key`` dans la section ``Import`` du menu ``Configuration interne``. |
57 | 20 | ||
58 | Maintenant, tout est bien configuré pour migrer depuis Pocket. | 21 | Maintenant, 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 | |||
32 | Installation | 32 | Installation |
33 | ------------ | 33 | ------------ |
34 | 34 | ||
35 | Sur un serveur dédié (méthode conseillée) | ||
36 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
37 | |||
35 | wallabag 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. | 38 | wallabag 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 | ||
37 | Installation de Composer : | 40 | Installation de Composer : |
@@ -60,13 +63,47 @@ Pour démarrer le serveur interne à php et vérifier que tout s'est installé c | |||
60 | 63 | ||
61 | Et accéder wallabag à l'adresse http://lipdevotreserveur:8000 | 64 | Et 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 | ||
66 | Installation avec Apache | 69 | Sur un serveur mutualisé |
70 | ~~~~~~~~~~~~~~~~~~~~~~~~ | ||
71 | |||
72 | Nous mettons à votre disposition une archive avec toutes les dépendances à l'intérieur. | ||
73 | La 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 | |||
75 | Nous 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 | |||
79 | Exé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 | |||
85 | Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. | ||
86 | Si 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 | |||
88 | Installation avec Docker | ||
67 | ------------------------ | 89 | ------------------------ |
68 | 90 | ||
69 | En 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 : | 91 | Nous 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 | |||
93 | Commande pour démarrer le containeur | ||
94 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
95 | |||
96 | .. code-block:: bash | ||
97 | |||
98 | docker pull wallabag/wallabag | ||
99 | |||
100 | Virtual hosts | ||
101 | ------------- | ||
102 | |||
103 | Configuration avec Apache | ||
104 | ~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
105 | |||
106 | En 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 | ||
109 | Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. | 146 | Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. |
110 | 147 | ||
111 | Installation avec Nginx | 148 | Configuration avec Nginx |
112 | ----------------------- | 149 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
113 | 150 | ||
114 | En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag, voici un fichier de configuration Nginx pour wallabag : | 151 | En 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 | ||
149 | Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. | 186 | Aprè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 | ||
192 | Configuration avec lighttpd | ||
193 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
194 | |||
195 | En 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 | ||
157 | Droits d'accès aux dossiers du projet | 230 | Droits d'accès aux dossiers du projet |
158 | ------------------------------------- | 231 | ------------------------------------- |
159 | 232 | ||
160 | |||
161 | Environnement de test | 233 | Environnement de test |
162 | ~~~~~~~~~~~~~~~~~~~~~ | 234 | ~~~~~~~~~~~~~~~~~~~~~ |
163 | 235 | ||
164 | Quand 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. | 236 | Quand 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 | 238 | Environnement de production | |
167 | Environnement de production | ||
168 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 239 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
169 | 240 | ||
170 | Dè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. | 241 | Dè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 | |||
15 | Foire aux questions | ||
16 | ------------------- | ||
17 | |||
18 | J'ai oublié mon mot de passe | ||
19 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
20 | |||
21 | Vous pouvez réinitialiser votre mot de passe en cliquant sur ``Mot de passe oublié ?``, | ||
22 | sur la page de connexion. Ensuite, renseignez votre adresse email ou votre nom d'utilisateur, | ||
23 | un 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 @@ | |||
1 | Migrer wallabag | 1 | Migrer depuis la v1 ou la v2 |
2 | =============== | 2 | ============================ |
3 | 3 | ||
4 | Depuis wallabag 1.x | 4 | Depuis 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 @@ | |||
1 | Mettre à jour wallabag | ||
2 | ====================== | ||
3 | |||
4 | Mise à jour sur un serveur dédié | ||
5 | -------------------------------- | ||
6 | |||
7 | La 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 | |||
17 | Mise à jour sur un hébergement mutualisé | ||
18 | ---------------------------------------- | ||
19 | |||
20 | Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. | ||
21 | |||
22 | Té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 | |||
28 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. | ||
29 | |||
30 | Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``. | ||
31 | |||
32 | Videz le répertoire ``var/cache``. | ||