aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/fr/user
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/user
parent97c8eb3c2398d0aaf06155de5e0828e4020cb5d4 (diff)
downloadwallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.tar.gz
wallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.tar.zst
wallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.zip
Update documentation
Diffstat (limited to 'docs/fr/user')
-rw-r--r--docs/fr/user/installation.rst56
-rw-r--r--docs/fr/user/upgrade.rst32
2 files changed, 76 insertions, 12 deletions
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``.