diff options
author | Nicolas Lœuillet <nicolas@loeuillet.org> | 2016-05-03 15:50:13 +0200 |
---|---|---|
committer | Nicolas Lœuillet <nicolas@loeuillet.org> | 2016-05-03 15:50:13 +0200 |
commit | bba9907d1ffe993da3bc9b7e6c87169953a11160 (patch) | |
tree | 07bdb64837956dd13f20fa0cf9f8cbaca1924cba /docs/fr | |
parent | 97c8eb3c2398d0aaf06155de5e0828e4020cb5d4 (diff) | |
download | wallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.tar.gz wallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.tar.zst wallabag-bba9907d1ffe993da3bc9b7e6c87169953a11160.zip |
Update documentation
Diffstat (limited to 'docs/fr')
-rw-r--r-- | docs/fr/index.rst | 3 | ||||
-rw-r--r-- | docs/fr/user/installation.rst | 56 | ||||
-rw-r--r-- | docs/fr/user/upgrade.rst | 32 |
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 | |||
9 | simplement d’archiver une page web en ne conservant que le contenu. Les | 9 | simplement 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 | |||
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,22 +185,18 @@ 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 | ||
156 | |||
157 | Droits d'accès aux dossiers du projet | 192 | Droits d'accès aux dossiers du projet |
158 | ------------------------------------- | 193 | ------------------------------------- |
159 | 194 | ||
160 | |||
161 | Environnement de test | 195 | Environnement de test |
162 | ~~~~~~~~~~~~~~~~~~~~~ | 196 | ~~~~~~~~~~~~~~~~~~~~~ |
163 | 197 | ||
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. | 198 | 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 | 199 | ||
166 | |||
167 | Environnement de production | 200 | Environnement 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 @@ | |||
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``. | ||