aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/fr
diff options
context:
space:
mode:
authorNicolas Lœuillet <nicolas@loeuillet.org>2016-05-03 15:50:13 +0200
committerNicolas Lœuillet <nicolas@loeuillet.org>2016-05-03 15:50:13 +0200
commitbba9907d1ffe993da3bc9b7e6c87169953a11160 (patch)
tree07bdb64837956dd13f20fa0cf9f8cbaca1924cba /docs/fr
parent97c8eb3c2398d0aaf06155de5e0828e4020cb5d4 (diff)
downloadwallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.tar.gz
wallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.tar.zst
wallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.zip
Update documentation
Diffstat (limited to 'docs/fr')
-rw-r--r--docs/fr/index.rst3
-rw-r--r--docs/fr/user/installation.rst56
-rw-r--r--docs/fr/user/upgrade.rst32
3 files changed, 78 insertions, 13 deletions
diff --git a/docs/fr/index.rst b/docs/fr/index.rst
index 29237721..b4275a43 100644
--- a/docs/fr/index.rst
+++ b/docs/fr/index.rst
@@ -9,7 +9,7 @@ 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.. note:: 12.. tip::
13 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>`__. 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 15
@@ -26,6 +26,7 @@ La documentation principale de cette application est découpée en plusieurs sec
26 26
27 user/faq 27 user/faq
28 user/installation 28 user/installation
29 user/upgrade
29 user/migration 30 user/migration
30 user/create_account 31 user/create_account
31 user/login 32 user/login
diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst
index 33a2cf5c..4645ef74 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,22 +185,18 @@ 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
156
157Droits d'accès aux dossiers du projet 192Droits d'accès aux dossiers du projet
158------------------------------------- 193-------------------------------------
159 194
160
161Environnement de test 195Environnement de test
162~~~~~~~~~~~~~~~~~~~~~ 196~~~~~~~~~~~~~~~~~~~~~
163 197
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. 198Quand 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 199
166
167Environnement de production 200Environnement de production
168~~~~~~~~~~~~~~~~~~~~~~~~~~~ 201~~~~~~~~~~~~~~~~~~~~~~~~~~~
169 202
@@ -178,4 +211,3 @@ Cela est dû au fait qu'il faut aussi octroyer les mêmes droits d'accès au dos
178.. code-block:: bash 211.. code-block:: bash
179 212
180 chown -R www-data:www-data /var/www/wallabag/var 213 chown -R www-data:www-data /var/www/wallabag/var
181
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``.