diff options
Diffstat (limited to 'docs/fr')
-rw-r--r-- | docs/fr/conf.py | 2 | ||||
-rw-r--r-- | docs/fr/developer/maintenance.rst | 4 | ||||
-rw-r--r-- | docs/fr/developer/rabbitmq.rst | 80 | ||||
-rw-r--r-- | docs/fr/developer/redis.rst | 75 | ||||
-rw-r--r-- | docs/fr/developer/testsuite.rst | 10 | ||||
-rw-r--r-- | docs/fr/index.rst | 12 | ||||
-rw-r--r-- | docs/fr/user/configuration.rst | 2 | ||||
-rw-r--r-- | docs/fr/user/errors_during_fetching.rst | 18 | ||||
-rw-r--r-- | docs/fr/user/import.rst | 33 | ||||
-rw-r--r-- | docs/fr/user/installation.rst | 42 | ||||
-rw-r--r-- | docs/fr/user/migration.rst | 38 | ||||
-rw-r--r-- | docs/fr/user/parameters.rst | 50 | ||||
-rw-r--r-- | docs/fr/user/share.rst | 17 | ||||
-rw-r--r-- | docs/fr/user/upgrade-2.0.x-2.1.1.rst | 84 | ||||
-rw-r--r-- | docs/fr/user/upgrade-2.1.x-2.1.y.rst (renamed from docs/fr/user/upgrade.rst) | 11 |
15 files changed, 423 insertions, 55 deletions
diff --git a/docs/fr/conf.py b/docs/fr/conf.py index f1fe3967..49a57e2d 100644 --- a/docs/fr/conf.py +++ b/docs/fr/conf.py | |||
@@ -12,7 +12,7 @@ source_suffix = '.rst' | |||
12 | master_doc = 'index' | 12 | master_doc = 'index' |
13 | project = u'wallabag-fr' | 13 | project = u'wallabag-fr' |
14 | copyright = u'2013-2016, Nicolas Lœuillet - MIT Licence' | 14 | copyright = u'2013-2016, Nicolas Lœuillet - MIT Licence' |
15 | version = '2.0.0' | 15 | version = '2.1.0' |
16 | release = version | 16 | release = version |
17 | exclude_patterns = ['_build'] | 17 | exclude_patterns = ['_build'] |
18 | pygments_style = 'sphinx' | 18 | pygments_style = 'sphinx' |
diff --git a/docs/fr/developer/maintenance.rst b/docs/fr/developer/maintenance.rst index 4ea8d01f..8007a85f 100644 --- a/docs/fr/developer/maintenance.rst +++ b/docs/fr/developer/maintenance.rst | |||
@@ -11,7 +11,7 @@ Pour activer le mode maintenance, exécutez cette commande : | |||
11 | 11 | ||
12 | :: | 12 | :: |
13 | 13 | ||
14 | bin/console lexik:maintenance:lock --no-interaction | 14 | bin/console lexik:maintenance:lock --no-interaction -e=prod |
15 | 15 | ||
16 | Vous pouvez spécifier votre adresse IP dans ``app/config/config.yml`` si vous souhaitez accéder à wallabag même si | 16 | Vous pouvez spécifier votre adresse IP dans ``app/config/config.yml`` si vous souhaitez accéder à wallabag même si |
17 | le mode maintenance est activé. Par exemple : | 17 | le mode maintenance est activé. Par exemple : |
@@ -30,4 +30,4 @@ Pour désactiver le mode maintenance, exécutez cette commande : | |||
30 | 30 | ||
31 | :: | 31 | :: |
32 | 32 | ||
33 | bin/console lexik:maintenance:unlock | 33 | bin/console lexik:maintenance:unlock -e=prod |
diff --git a/docs/fr/developer/rabbitmq.rst b/docs/fr/developer/rabbitmq.rst new file mode 100644 index 00000000..92db5a28 --- /dev/null +++ b/docs/fr/developer/rabbitmq.rst | |||
@@ -0,0 +1,80 @@ | |||
1 | Installer RabbitMQ pour des tâches asynchrones | ||
2 | ============================================== | ||
3 | |||
4 | Pour lancer des tâches asynchrones (utile pour des imports importants par exemple), nous pouvons utiliser RabbitMQ. | ||
5 | |||
6 | Pré-requis | ||
7 | ---------- | ||
8 | |||
9 | Vous devez installer RabbitMQ sur votre serveur. | ||
10 | |||
11 | Installation | ||
12 | ~~~~~~~~~~~~ | ||
13 | |||
14 | .. code:: bash | ||
15 | |||
16 | wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc | ||
17 | apt-key add rabbitmq-signing-key-public.asc | ||
18 | apt-get update | ||
19 | apt-get install rabbitmq-server | ||
20 | |||
21 | Configuration et démarrage | ||
22 | ~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
23 | |||
24 | .. code:: bash | ||
25 | |||
26 | rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest) | ||
27 | rabbitmq-server -detached | ||
28 | |||
29 | Arrêter RabbitMQ | ||
30 | ~~~~~~~~~~~~~~~~ | ||
31 | |||
32 | .. code:: bash | ||
33 | |||
34 | rabbitmqctl stop | ||
35 | |||
36 | |||
37 | Configurer RabbitMQ dans wallabag | ||
38 | --------------------------------- | ||
39 | |||
40 | Modifiez votre fichier ``parameters.yml`` pour éditer la configuration RabbitMQ. Celle par défaut devrait convenir : | ||
41 | |||
42 | .. code:: yaml | ||
43 | |||
44 | rabbitmq_host: localhost | ||
45 | rabbitmq_port: 5672 | ||
46 | rabbitmq_user: guest | ||
47 | rabbitmq_password: guest | ||
48 | |||
49 | Activer RabbitMQ dans wallabag | ||
50 | ------------------------------ | ||
51 | |||
52 | Dans les paramètres internes, section **Import**, activez RabbitMQ (avec la valeur 1). | ||
53 | |||
54 | Démarrer les clients RabbitMQ | ||
55 | ----------------------------- | ||
56 | |||
57 | En fonction du service dont vous souhaitez importer vos données, vous devez activer un (ou plusieurs si vous souhaitez en supporter plusieurs) cron job : | ||
58 | |||
59 | .. code:: bash | ||
60 | |||
61 | # for Pocket import | ||
62 | bin/console rabbitmq:consumer -e=prod import_pocket -w | ||
63 | |||
64 | # for Readability import | ||
65 | bin/console rabbitmq:consumer -e=prod import_readability -w | ||
66 | |||
67 | # for Instapaper import | ||
68 | bin/console rabbitmq:consumer -e=prod import_instapaper -w | ||
69 | |||
70 | # for wallabag v1 import | ||
71 | bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w | ||
72 | |||
73 | # for wallabag v2 import | ||
74 | bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w | ||
75 | |||
76 | # for Firefox import | ||
77 | bin/console rabbitmq:consumer -e=prod import_firefox -w | ||
78 | |||
79 | # for Chrome import | ||
80 | bin/console rabbitmq:consumer -e=prod import_chrome -w | ||
diff --git a/docs/fr/developer/redis.rst b/docs/fr/developer/redis.rst new file mode 100644 index 00000000..8a212e8a --- /dev/null +++ b/docs/fr/developer/redis.rst | |||
@@ -0,0 +1,75 @@ | |||
1 | Installer Redis pour des tâches asynchrones | ||
2 | =========================================== | ||
3 | |||
4 | Pour lancer des tâches asynchrones (utile pour des imports importants par exemple), nous pouvons utiliser Redis. | ||
5 | |||
6 | Pré-requis | ||
7 | ---------- | ||
8 | |||
9 | Vous devez installer Redis sur votre serveur. | ||
10 | |||
11 | Installation | ||
12 | ~~~~~~~~~~~~ | ||
13 | |||
14 | .. code:: bash | ||
15 | |||
16 | apt-get install redis-server | ||
17 | |||
18 | Démarrage | ||
19 | ~~~~~~~~~ | ||
20 | |||
21 | Le serveur devrait déjà être démarré après l'installation. Si ce n'est pas le cas, vous pouvez le démarrer ainsi : | ||
22 | |||
23 | .. code:: bash | ||
24 | |||
25 | redis-server | ||
26 | |||
27 | |||
28 | Configurer Redis dans wallabag | ||
29 | ------------------------------- | ||
30 | |||
31 | Modifiez votre fichier ``parameters.yml`` pour éditer la configuration Redis. Celle par défaut devrait convenir : | ||
32 | |||
33 | .. code:: yaml | ||
34 | |||
35 | redis_host: localhost | ||
36 | redis_port: 6379 | ||
37 | |||
38 | Activer Redis dans wallabag | ||
39 | --------------------------- | ||
40 | |||
41 | Dans les paramètres internes, section **Import**, activez Redis (avec la valeur 1). | ||
42 | |||
43 | Démarrer les clients Redis | ||
44 | -------------------------- | ||
45 | |||
46 | En fonction du service dont vous souhaitez importer vos données, vous devez activer un (ou plusieurs si vous souhaitez en supporter plusieurs) cron job : | ||
47 | |||
48 | .. code:: bash | ||
49 | |||
50 | # for Pocket import | ||
51 | bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log | ||
52 | |||
53 | # for Readability import | ||
54 | bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log | ||
55 | |||
56 | # for Instapaper import | ||
57 | bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log | ||
58 | |||
59 | # for wallabag v1 import | ||
60 | bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log | ||
61 | |||
62 | # for wallabag v2 import | ||
63 | bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log | ||
64 | |||
65 | # for Firefox import | ||
66 | bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log | ||
67 | |||
68 | # for Chrome import | ||
69 | bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log | ||
70 | |||
71 | Si vous souhaitez démarrer l'import pour quelques messages uniquement, vous pouvez spécifier cette valeur en paramètre (ici 12) et le client va s'arrêter après le 12ème message : | ||
72 | |||
73 | .. code:: bash | ||
74 | |||
75 | bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12 | ||
diff --git a/docs/fr/developer/testsuite.rst b/docs/fr/developer/testsuite.rst new file mode 100644 index 00000000..bd5c68c6 --- /dev/null +++ b/docs/fr/developer/testsuite.rst | |||
@@ -0,0 +1,10 @@ | |||
1 | Suite de tests | ||
2 | ============== | ||
3 | |||
4 | Pour assurer la qualité du développement de wallabag, nous avons écrit des tests avec `PHPUnit <https://phpunit.de>`_. | ||
5 | |||
6 | Si vous contribuez au projet (en traduisant l'application, en corrigeant des bugs ou en ajoutant une nouvelle fonctionnalité), merci d'écrire vos propres tests. | ||
7 | |||
8 | Pour lancer la suite de tests de wallabag, vous devez installer `ant <http://ant.apache.org>`_. | ||
9 | |||
10 | Ensuite, exécutez la commande ``make test``. | ||
diff --git a/docs/fr/index.rst b/docs/fr/index.rst index 1e72dae7..2a265ff3 100644 --- a/docs/fr/index.rst +++ b/docs/fr/index.rst | |||
@@ -18,6 +18,11 @@ La documentation principale de cette application est découpée en plusieurs sec | |||
18 | * :ref:`user-docs` | 18 | * :ref:`user-docs` |
19 | * :ref:`dev-docs` | 19 | * :ref:`dev-docs` |
20 | 20 | ||
21 | La documentation est disponible dans d'autres langues : | ||
22 | |||
23 | * `Documentation in english <http://doc.wallabag.org/en/master/>`_ | ||
24 | * `Deutsch Dokumentation <http://doc.wallabag.org/de/master/>`_ | ||
25 | |||
21 | .. _user-docs: | 26 | .. _user-docs: |
22 | 27 | ||
23 | .. toctree:: | 28 | .. toctree:: |
@@ -26,7 +31,8 @@ La documentation principale de cette application est découpée en plusieurs sec | |||
26 | 31 | ||
27 | user/faq | 32 | user/faq |
28 | user/installation | 33 | user/installation |
29 | user/upgrade | 34 | user/upgrade-2.0.x-2.1.1 |
35 | user/upgrade-2.0.x-2.1.1 | ||
30 | user/migration | 36 | user/migration |
31 | user/import | 37 | user/import |
32 | user/create_account | 38 | user/create_account |
@@ -36,8 +42,10 @@ La documentation principale de cette application est découpée en plusieurs sec | |||
36 | user/errors_during_fetching | 42 | user/errors_during_fetching |
37 | user/annotations | 43 | user/annotations |
38 | user/download_articles | 44 | user/download_articles |
45 | user/share | ||
39 | user/filters | 46 | user/filters |
40 | user/tags | 47 | user/tags |
48 | user/parameters | ||
41 | 49 | ||
42 | .. _dev-docs: | 50 | .. _dev-docs: |
43 | 51 | ||
@@ -50,3 +58,5 @@ La documentation principale de cette application est découpée en plusieurs sec | |||
50 | developer/documentation | 58 | developer/documentation |
51 | developer/translate | 59 | developer/translate |
52 | developer/maintenance | 60 | developer/maintenance |
61 | developer/redis | ||
62 | developer/rabbitmq | ||
diff --git a/docs/fr/user/configuration.rst b/docs/fr/user/configuration.rst index 278f0022..8bfe66f5 100644 --- a/docs/fr/user/configuration.rst +++ b/docs/fr/user/configuration.rst | |||
@@ -102,7 +102,7 @@ if *« readingTime >= 5 AND domainName = "github.com" »* then tag as *« long r | |||
102 | Quels variables et opérateurs puis-je utiliser pour écrire mes règles ? | 102 | Quels variables et opérateurs puis-je utiliser pour écrire mes règles ? |
103 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 103 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
104 | 104 | ||
105 | Les variables et opérateurs suivants peuvent être utilisés lors de la création de vos règles : | 105 | Les variables et opérateurs suivants peuvent être utilisés lors de la création de vos règles (attention, pour certaines valeurs, vous devez ajouter des guillemets, par exemple ``language = "en"``) : |
106 | 106 | ||
107 | =========== ============================================== ========== ========== | 107 | =========== ============================================== ========== ========== |
108 | Variable Sens Opérateur Sens | 108 | Variable Sens Opérateur Sens |
diff --git a/docs/fr/user/errors_during_fetching.rst b/docs/fr/user/errors_during_fetching.rst index 74290bef..1a60e4bd 100644 --- a/docs/fr/user/errors_during_fetching.rst +++ b/docs/fr/user/errors_during_fetching.rst | |||
@@ -12,9 +12,21 @@ Il peut y avoir plusieurs raisons : | |||
12 | Comment puis-je aider pour réparer ça ? | 12 | Comment puis-je aider pour réparer ça ? |
13 | --------------------------------------- | 13 | --------------------------------------- |
14 | 14 | ||
15 | - `en nous envoyant un email avec l'URL de l'article <mailto:hello@wallabag.org>`_ | 15 | Vous pouvez `nous envoyer un email avec l'URL de l'article <mailto:hello@wallabag.org>`_. |
16 | - en essayant de réparer cet article par vous-même :) en créant un fichier pour l'article. | 16 | |
17 | Vous pouvez utiliser `cet outil <http://siteconfig.fivefilters.org/>`__. | 17 | Ou vous pouvez aussi essayer de résoudre ce problème vous même (comme ça, nous restons concentrés pour améliorer wallabag au lieu d'écrire ces fichiers de configuration :) ). |
18 | |||
19 | Vous pouvez essayer de voir si ça fonctionne ici : `http://f43.me/feed/test <http://f43.me/feed/test>`_ (ce site utilise principalement la même manière de fonctionner que wallabag pour récupérer les articles). | ||
20 | |||
21 | Si ça fonctionne ici et pas sur wallabag, c'est qu'il y a un souci avec wallabag qui casse le parser (difficile à résoudre : merci d'ouvrir un nouveau ticket à ce sujet). | ||
22 | |||
23 | Si ça ne fonctionne pas, vous pouvez essayer de créer un fichier de configuration en utilisant : `http://siteconfig.fivefilters.org/ <http://siteconfig.fivefilters.org/>`_ (sélectionnez les parties du contenu qui correspondent à ce que vous souhaitez garder). Vous pouvez `lire cette documentation avant <http://help.fivefilters.org/customer/en/portal/articles/223153-site-patterns>`_. | ||
24 | |||
25 | Vous pouvez tester ce fichier sur le site **f43.me** : cliquez sur **Want to try a custom siteconfig?** et insérez le fichier généré depuis siteconfig.fivefilters.org. | ||
26 | |||
27 | Répétez cette opération jusqu'à avoir quelque chose qui vous convienne. | ||
28 | |||
29 | Ensuite, vous pouvez créer une pull request ici `https://github.com/fivefilters/ftr-site-config <https://github.com/fivefilters/ftr-site-config>`_, qui est le projet principal pour stocker les fichiers de configuration. | ||
18 | 30 | ||
19 | Comment puis-je réessayer de récupérer le contenu ? | 31 | Comment puis-je réessayer de récupérer le contenu ? |
20 | --------------------------------------------------- | 32 | --------------------------------------------------- |
diff --git a/docs/fr/user/import.rst b/docs/fr/user/import.rst index e6c2fa02..2e6caafb 100644 --- a/docs/fr/user/import.rst +++ b/docs/fr/user/import.rst | |||
@@ -28,17 +28,40 @@ la section Pocket puis sur ``Se connecter à Pocket et importer les données``. | |||
28 | 28 | ||
29 | Vous devez autoriser wallabag à se connecter à votre compte Pocket. | 29 | Vous devez autoriser wallabag à se connecter à votre compte Pocket. |
30 | Vos données vont être importées. L'import de données est une action qui peut être couteuse | 30 | Vos données vont être importées. L'import de données est une action qui peut être couteuse |
31 | pour votre serveur (nous devons encore travailler pour améliorer cet import). | 31 | pour votre serveur. |
32 | |||
33 | Depuis Readability | ||
34 | ------------------ | ||
35 | |||
36 | Exportez vos données de Readability | ||
37 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
38 | |||
39 | Sur la page des outils (`https://www.readability.com/tools/ <https://www.readability.com/tools/>`_), cliquez sur "Export your data" dans la section "Data Export". Vous allez recevoir un email avec un lien pour télécharger le json. | ||
40 | |||
41 | Importez vos données dans wallabag 2.x | ||
42 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
43 | |||
44 | Cliquez sur le lien ``Importer`` dans le menu, sur ``Importer les contenus`` dans | ||
45 | la section Readability et ensuite sélectionnez votre fichier json pour l'uploader. | ||
46 | |||
47 | Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur. | ||
32 | 48 | ||
33 | Depuis Instapaper | 49 | Depuis Instapaper |
34 | ----------------- | 50 | ----------------- |
35 | 51 | ||
36 | *Fonctionnalité pas encore implémentée dans wallabag v2.* | 52 | Exportez vos données de Instapaper |
53 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
37 | 54 | ||
38 | Depuis Readability | 55 | Sur la page des paramètres (`https://www.instapaper.com/user <https://www.instapaper.com/user>`_), cliquez sur "Download .CSV file" dans la section "Export". Un fichier CSV se téléchargera (``instapaper-export.csv``). |
39 | ------------------ | 56 | |
57 | Importez vos données dans wallabag 2.x | ||
58 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
59 | |||
60 | Cliquez sur le lien ``Importer`` dans le menu, sur ``Importer les contenus`` dans | ||
61 | la section Instapaper et ensuite sélectionnez votre fichier CSV pour l'uploader. | ||
62 | |||
63 | Vos données vont être importées. L'import de données est une action qui peut être couteuse pour votre serveur. | ||
40 | 64 | ||
41 | *Fonctionnalité pas encore implémentée dans wallabag v2.* | ||
42 | 65 | ||
43 | Depuis un fichier HTML ou JSON | 66 | Depuis un fichier HTML ou JSON |
44 | ------------------------------ | 67 | ------------------------------ |
diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst index 480970c5..4f94d6c8 100644 --- a/docs/fr/user/installation.rst +++ b/docs/fr/user/installation.rst | |||
@@ -6,6 +6,20 @@ Pré-requis | |||
6 | 6 | ||
7 | wallabag est compatible avec PHP >= 5.5, PHP 7 inclus. | 7 | wallabag est compatible avec PHP >= 5.5, PHP 7 inclus. |
8 | 8 | ||
9 | .. note:: | ||
10 | |||
11 | Pour installer wallabag facilement, nous avons créé un ``Makefile``, vous avez donc besoin d'avoir installé l'outil ``make``. | ||
12 | |||
13 | wallabag utilise un grand nombre de bibliothèques PHP 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 et vous assurer que vous utilisez bien la version 1.2 (si vous avez déjà Composer, faite un ``composer selfupdate``). | ||
14 | |||
15 | Installation de Composer : | ||
16 | |||
17 | :: | ||
18 | |||
19 | curl -s http://getcomposer.org/installer | php | ||
20 | |||
21 | Vous pouvez trouver des instructions spécifiques `ici (en anglais) <https://getcomposer.org/doc/00-intro.md>`__. | ||
22 | |||
9 | Vous aurez besoin des extensions suivantes pour que wallabag fonctionne. Il est possible que certaines de ces extensions soient déjà activées dans votre version de PHP, donc vous n'avez pas forcément besoin d'installer tous les paquets correspondants. | 23 | Vous aurez besoin des extensions suivantes pour que wallabag fonctionne. Il est possible que certaines de ces extensions soient déjà activées dans votre version de PHP, donc vous n'avez pas forcément besoin d'installer tous les paquets correspondants. |
10 | 24 | ||
11 | - php-session | 25 | - php-session |
@@ -22,6 +36,7 @@ Vous aurez besoin des extensions suivantes pour que wallabag fonctionne. Il est | |||
22 | - php-curl | 36 | - php-curl |
23 | - php-gettext | 37 | - php-gettext |
24 | - php-tokenizer | 38 | - php-tokenizer |
39 | - php-bcmath | ||
25 | 40 | ||
26 | wallabag utilise PDO afin de se connecter à une base de données, donc vous aurez besoin d'une extension et d'un système de bases de données parmi : | 41 | wallabag utilise PDO afin de se connecter à une base de données, donc vous aurez besoin d'une extension et d'un système de bases de données parmi : |
27 | 42 | ||
@@ -35,36 +50,23 @@ Installation | |||
35 | Sur un serveur dédié (méthode conseillée) | 50 | Sur un serveur dédié (méthode conseillée) |
36 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 51 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
37 | 52 | ||
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 et vous assurer que vous utilisez bien la version 1.2 (si vous avez déjà Composer, faite un ``composer selfupdate``). | 53 | Pour installer wallabag, vous devez exécuter ces commandes : |
39 | |||
40 | Installation de Composer : | ||
41 | |||
42 | :: | ||
43 | |||
44 | curl -s http://getcomposer.org/installer | php | ||
45 | |||
46 | Vous pouvez trouver des instructions spécifiques `ici (en anglais) <https://getcomposer.org/doc/00-intro.md>`__ : | ||
47 | |||
48 | Pour installer wallabag, vous devez exécuter ces deux commandes : | ||
49 | 54 | ||
50 | :: | 55 | :: |
51 | 56 | ||
52 | git clone https://github.com/wallabag/wallabag.git | 57 | git clone https://github.com/wallabag/wallabag.git |
53 | cd wallabag | 58 | cd wallabag && make install |
54 | git checkout 2.0.8 | ||
55 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist | ||
56 | php bin/console wallabag:install --env=prod | ||
57 | 59 | ||
58 | Pour démarrer le serveur interne à php et vérifier que tout s'est installé correctement, vous pouvez exécuter : | 60 | Pour démarrer le serveur interne à php et vérifier que tout s'est installé correctement, vous pouvez exécuter : |
59 | 61 | ||
60 | :: | 62 | :: |
61 | 63 | ||
62 | php bin/console server:run --env=prod | 64 | make run |
63 | 65 | ||
64 | Et accéder wallabag à l'adresse http://lipdevotreserveur:8000 | 66 | Et accéder wallabag à l'adresse http://lipdevotreserveur:8000 |
65 | 67 | ||
66 | .. tip:: | 68 | .. tip:: |
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. | 69 | 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 la `documentation Symfony <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ pour en savoir plus. |
68 | 70 | ||
69 | Sur un serveur mutualisé | 71 | Sur un serveur mutualisé |
70 | ~~~~~~~~~~~~~~~~~~~~~~~~ | 72 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
@@ -82,18 +84,18 @@ Exécutez cette commande pour télécharger et décompresser l'archive : | |||
82 | 84 | ||
83 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package | 85 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package |
84 | 86 | ||
85 | (hash md5 de l'archive : ``4f84c725d1d6e3345eae0a406115e5ff``) | 87 | Vous trouverez `le hash md5 du dernier package sur notre site <https://www.wallabag.org/pages/download-wallabag.html>`_. |
86 | 88 | ||
87 | Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. | 89 | Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. |
88 | 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``. | 90 | 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``. |
89 | 91 | ||
90 | Installation avec Docker | 92 | Installation avec Docker |
91 | ------------------------ | 93 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
92 | 94 | ||
93 | 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. | 95 | 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. |
94 | 96 | ||
95 | Commande pour démarrer le containeur | 97 | Commande pour démarrer le containeur |
96 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 98 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
97 | 99 | ||
98 | .. code-block:: bash | 100 | .. code-block:: bash |
99 | 101 | ||
diff --git a/docs/fr/user/migration.rst b/docs/fr/user/migration.rst index 66024572..91f8bab2 100644 --- a/docs/fr/user/migration.rst +++ b/docs/fr/user/migration.rst | |||
@@ -24,20 +24,38 @@ Une fois que vous avez créé un compte utilisateur sur votre nouvelle instance | |||
24 | :alt: Import depuis wallabag v1 | 24 | :alt: Import depuis wallabag v1 |
25 | :align: center | 25 | :align: center |
26 | 26 | ||
27 | Import via via la ligne de commande (CLI) | 27 | Depuis wallabag 2.x |
28 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 28 | ------------------- |
29 | |||
30 | Depuis l'instance sur laquelle vous étiez, rendez-vous dans la section `Tous les articles`, puis exportez ces articles au format json. | ||
31 | |||
32 | .. image:: ../../img/user/export_v2.png | ||
33 | :alt: Export depuis wallabag v2 | ||
34 | :align: center | ||
35 | |||
36 | Depuis votre nouvelle instance de wallabag, créez votre compte utilisateur puis cliquez sur le lien dans le menu pour accéder à l'import. Choisissez l'import depuis wallabag v2 puis sélectionnez votre fichier json pour l'uploader. | ||
37 | |||
38 | .. note:: | ||
39 | S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`__. | ||
40 | |||
41 | Import via la ligne de commande (CLI) | ||
42 | ------------------------------------- | ||
29 | 43 | ||
30 | Si vous avez accès à la ligne de commandes de votre serveur web, vous pouvez exécuter cette commande pour import votre fichier wallabag v1 : | 44 | Si vous avez accès à la ligne de commandes de votre serveur web, vous pouvez exécuter cette commande pour import votre fichier wallabag v1 : |
31 | 45 | ||
32 | :: | 46 | :: |
33 | 47 | ||
34 | bin/console wallabag:import-v1 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod | 48 | bin/console wallabag:import 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod |
35 | 49 | ||
36 | Remplacez les valeurs : | 50 | Remplacez les valeurs : |
37 | 51 | ||
38 | * ``1`` est l'identifiant de votre utilisateur en base (l'ID de votre premier utilisateur créé sur wallabag est 1) | 52 | * ``1`` est l'identifiant de votre utilisateur en base (l'ID de votre premier utilisateur créé sur wallabag est 1) |
39 | * ``~/Downloads/wallabag-export-1-2016-04-05.json`` est le chemin de votre export wallabag v1 | 53 | * ``~/Downloads/wallabag-export-1-2016-04-05.json`` est le chemin de votre export wallabag v1 |
40 | 54 | ||
55 | Si vous voulez marquer tous ces articles comme lus, vous pouvez ajouter l'option ``--markAsRead``. | ||
56 | |||
57 | Pour importer un fichier wallabag v2, vous devez ajouter l'option ``--importer=v2``. | ||
58 | |||
41 | Vous obtiendrez : | 59 | Vous obtiendrez : |
42 | 60 | ||
43 | :: | 61 | :: |
@@ -46,17 +64,3 @@ Vous obtiendrez : | |||
46 | 403 imported | 64 | 403 imported |
47 | 0 already saved | 65 | 0 already saved |
48 | End : 05-04-2016 11:36:09 --- | 66 | End : 05-04-2016 11:36:09 --- |
49 | |||
50 | Depuis wallabag 2.x | ||
51 | ------------------- | ||
52 | |||
53 | Depuis l'instance sur laquelle vous étiez, rendez-vous dans la section `Tous les articles`, puis exportez ces articles au format json. | ||
54 | |||
55 | .. image:: ../../img/user/export_v2.png | ||
56 | :alt: Export depuis wallabag v2 | ||
57 | :align: center | ||
58 | |||
59 | Depuis votre nouvelle instance de wallabag, créez votre compte utilisateur puis cliquez sur le lien dans le menu pour accéder à l'import. Choisissez l'import depuis wallabag v2 puis sélectionnez votre fichier json pour l'uploader. | ||
60 | |||
61 | .. note:: | ||
62 | S'il vous arrive des problèmes durant l'export ou l'import, n'hésitez pas à `demander de l'aide <https://www.wallabag.org/pages/support.html>`__. | ||
diff --git a/docs/fr/user/parameters.rst b/docs/fr/user/parameters.rst new file mode 100644 index 00000000..ec8c8995 --- /dev/null +++ b/docs/fr/user/parameters.rst | |||
@@ -0,0 +1,50 @@ | |||
1 | À quoi servent les paramètres ? | ||
2 | =============================== | ||
3 | .. csv-table:: Paramètres de base de données | ||
4 | :header: "name", "default", "description" | ||
5 | |||
6 | "database_driver", "pdo_sqlite", "Doit être pdo_sqlite ou pdo_mysql ou pdo_pgsql" | ||
7 | "database_host", "127.0.0.1", "Hôte de votre base de données (généralement localhost ou 127.0.0.1)" | ||
8 | "database_port", "~", "Port de votre base de données (vous pouvez laisser ``~`` pour utiliser celui par défaut)" | ||
9 | "database_name", "symfony", "Nom de votre base de données" | ||
10 | "database_user", "root", "Utilisateur de votre base de données" | ||
11 | "database_password", "~", "Mot de passe de cet utilisateur" | ||
12 | "database_path", "``""%kernel.root_dir%/../data/db/wallabag.sqlite""``", "Uniquement pour SQLite. Chemin du fichier de base de données. Laissez vide pour les autres bases de données." | ||
13 | "database_table_prefix", "wallabag_", "Toutes les tables de wallabag seront préfixées par cette chaine. Vous pouvez ajouter un ``_`` pour plus de clarté" | ||
14 | "database_socket", "null", "Si votre base de données utilise un socket plutôt que tcp, spécifiez le chemin du socket (les autres paramètres de connexion seront alors ignorés)" | ||
15 | |||
16 | .. csv-table:: Configuration pour envoyer des emails depuis wallabag | ||
17 | :header: "name", "default", "description" | ||
18 | |||
19 | "mailer_transport", "smtp", "Méthode de transport exacte utilisée pour envoyer des emails. Les valeurs correctes sont : smtp, gmail, mail, sendmail, null (ce qui désactivera l'envoi des emails)" | ||
20 | "mailer_host", "127.0.0.1", "Hôte sur lequel se connecter quand on utilise smtp comme transport." | ||
21 | "mailer_user", "~", "Utilisateur smtp." | ||
22 | "mailer_password", "~", "Mot de passe de cet utilisateur." | ||
23 | |||
24 | .. csv-table:: Autres options de wallabag | ||
25 | :header: "name", "default", "description" | ||
26 | |||
27 | "locale", "en", "Langue par défaut de votre instance wallabag (comme en, fr, es, etc.)" | ||
28 | "secret", "ovmpmAWXRCabNlMgzlzFXDYmCFfzGv", "C'est une chaine qui doit être unique à votre application et qui est couramment utilisée pour ajouter plus d'entropie aux opérations relatives à la sécurité." | ||
29 | "twofactor_auth", "true", "true pour activer l'authentification à deux facteurs" | ||
30 | "twofactor_sender", "no-reply@wallabag.org", "Email de l'expéditeur du code de l'authentification à deux facteurs" | ||
31 | "fosuser_registration", "true", "true pour activer l'inscription publique" | ||
32 | "fosuser_confirmation", "true", "true pour envoyer un email de confirmation pour chaque création de compte" | ||
33 | "from_email", "no-reply@wallabag.org", "Email de l'expéditeur pour chaque email envoyé" | ||
34 | "rss_limit", "50", "Limite pour les flux RSS" | ||
35 | |||
36 | .. csv-table:: Configuration RabbitMQ | ||
37 | :header: "name", "default", "description" | ||
38 | |||
39 | "rabbitmq_host", "localhost", "Hôte de votre instance RabbitMQ" | ||
40 | "rabbitmq_port", "5672", "Port de votre instance RabbitMQ" | ||
41 | "rabbitmq_user", "guest", "Utilisateur de votre instance RabbitMQ" | ||
42 | "rabbitmq_password", "guest", "Mot de passe de cet utilisateur" | ||
43 | |||
44 | .. csv-table:: Configuration Redis | ||
45 | :header: "name", "default", "description" | ||
46 | |||
47 | "redis_scheme", "tcp", "Définit le protocole utilisé pour commuiquer avec l'instance Redis. Les valeurs correctes sont : tcp, unix, http" | ||
48 | "redis_host", "localhost", "IP ou hôte du serveur cible (ignoré pour un schéma unix)" | ||
49 | "redis_port", "6379", "Port TCP/IP du serveur cible (ignoré pour un schéma unix)" | ||
50 | "redis_path", "null", "Chemin du fichier de socket du domaine UNIX utilisé quand on se connecte à Redis en utilisant les sockets du domaine UNIX" | ||
diff --git a/docs/fr/user/share.rst b/docs/fr/user/share.rst new file mode 100644 index 00000000..b5faa5ba --- /dev/null +++ b/docs/fr/user/share.rst | |||
@@ -0,0 +1,17 @@ | |||
1 | Partager des articles | ||
2 | ===================== | ||
3 | |||
4 | Quand vous lisez un article, vous pouvez le partager. Cliquez sur le bouton de partage : | ||
5 | |||
6 | .. image:: ../../img/user/share.png | ||
7 | :alt: partager un article | ||
8 | :align: center | ||
9 | |||
10 | Vous pouvez maintenant le partager : | ||
11 | |||
12 | - avec une URL publique (vous obtiendrez une vue allégée de l'article) | ||
13 | - avec un tweet | ||
14 | - dans votre Shaarli | ||
15 | - avec un message dans Diaspora* | ||
16 | - sur Carrot | ||
17 | - avec un email | ||
diff --git a/docs/fr/user/upgrade-2.0.x-2.1.1.rst b/docs/fr/user/upgrade-2.0.x-2.1.1.rst new file mode 100644 index 00000000..ec883d10 --- /dev/null +++ b/docs/fr/user/upgrade-2.0.x-2.1.1.rst | |||
@@ -0,0 +1,84 @@ | |||
1 | Mettre à jour de la 2.0.x à la 2.1.1 | ||
2 | ==================================== | ||
3 | |||
4 | .. warning:: | ||
5 | Avant cette migration, si vous aviez configuré l'import depuis Pocket en ajoutant votre consumer key dans les paramètres internes, pensez à effectuer une sauvegarde de celle-ci : vous devrez l'ajouter dans la configuration de wallabag après la mise à jour. | ||
6 | |||
7 | Mise à jour sur un serveur dédié | ||
8 | -------------------------------- | ||
9 | |||
10 | :: | ||
11 | |||
12 | rm -rf var/cache/* | ||
13 | git fetch origin | ||
14 | git fetch --tags | ||
15 | git checkout 2.1.1 --force | ||
16 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist | ||
17 | php bin/console doctrine:migrations:migrate --env=prod | ||
18 | php bin/console cache:clear --env=prod | ||
19 | |||
20 | Mise à jour sur un hébergement mutualisé | ||
21 | ---------------------------------------- | ||
22 | |||
23 | Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. | ||
24 | |||
25 | Téléchargez la dernière version de wallabag : | ||
26 | |||
27 | .. code-block:: bash | ||
28 | |||
29 | wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz | ||
30 | |||
31 | (hash md5 de l'archive 2.1.1 : ``9584a3b60a2b2a4de87f536548caac93``) | ||
32 | |||
33 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. | ||
34 | |||
35 | Vérifiez que votre fichier ``app/config/parameters.yml`` contient tous les paramètres requis. Voici un fichier ``parameters.yml`` par défaut. Si vous ne savez pas quelle valeur mettre à un paramètre, laissez la valeur par défaut. | ||
36 | |||
37 | .. code-block:: yml | ||
38 | |||
39 | parameters: | ||
40 | database_driver: pdo_sqlite | ||
41 | database_host: 127.0.0.1 | ||
42 | database_port: null | ||
43 | database_name: symfony | ||
44 | database_user: root | ||
45 | database_password: null | ||
46 | database_path: '%kernel.root_dir%/../data/db/wallabag.sqlite' | ||
47 | database_table_prefix: wallabag_ | ||
48 | mailer_transport: smtp | ||
49 | mailer_host: 127.0.0.1 | ||
50 | mailer_user: null | ||
51 | mailer_password: null | ||
52 | locale: en | ||
53 | secret: ovmpmAWXRCabNlMgzlzFXDYmCFfzGv | ||
54 | twofactor_auth: true | ||
55 | twofactor_sender: no-reply@wallabag.org | ||
56 | fosuser_registration: true | ||
57 | fosuser_confirmation: true | ||
58 | from_email: no-reply@wallabag.org | ||
59 | rss_limit: 50 | ||
60 | rabbitmq_host: localhost | ||
61 | rabbitmq_port: 5672 | ||
62 | rabbitmq_user: guest | ||
63 | rabbitmq_password: guest | ||
64 | redis_host: localhost | ||
65 | redis_port: 6379 | ||
66 | |||
67 | Vous trouverez `ici une documentation détaillée concernant les paramètres <http://doc.wallabag.org/fr/master/user/parameters.html>`_. | ||
68 | |||
69 | Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``. | ||
70 | |||
71 | Videz le répertoire ``var/cache``. | ||
72 | |||
73 | Vous allez devoir également exécuter des requêtes SQL pour mettre à jour votre base de données. Nous partons du principe que le préfixe de vos tables est ``wallabag_`` et que le serveur SQL est un serveur MySQL : | ||
74 | |||
75 | .. code-block:: sql | ||
76 | |||
77 | ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; | ||
78 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); | ||
79 | ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; | ||
80 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); | ||
81 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); | ||
82 | ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; | ||
83 | DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; | ||
84 | |||
diff --git a/docs/fr/user/upgrade.rst b/docs/fr/user/upgrade-2.1.x-2.1.y.rst index 1ead2c94..b6f1a2d0 100644 --- a/docs/fr/user/upgrade.rst +++ b/docs/fr/user/upgrade-2.1.x-2.1.y.rst | |||
@@ -1,16 +1,17 @@ | |||
1 | Mettre à jour wallabag | 1 | Mettre à jour de la 2.1.x à la 2.1.y |
2 | ====================== | 2 | ==================================== |
3 | 3 | ||
4 | Mise à jour sur un serveur dédié | 4 | Mise à jour sur un serveur dédié |
5 | -------------------------------- | 5 | -------------------------------- |
6 | 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.8`` par le numéro de la dernière version) : | 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.1.2`` par le numéro de la dernière version) : |
8 | 8 | ||
9 | :: | 9 | :: |
10 | 10 | ||
11 | rm -rf var/cache/* | ||
11 | git fetch origin | 12 | git fetch origin |
12 | git fetch --tags | 13 | git fetch --tags |
13 | git checkout 2.0.8 | 14 | git checkout 2.1.2 --force |
14 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist | 15 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist |
15 | php bin/console cache:clear --env=prod | 16 | php bin/console cache:clear --env=prod |
16 | 17 | ||
@@ -25,7 +26,7 @@ Téléchargez la dernière version de wallabag : | |||
25 | 26 | ||
26 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package | 27 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package |
27 | 28 | ||
28 | (hash md5 de l'archive : ``4f84c725d1d6e3345eae0a406115e5ff``) | 29 | Vous trouverez `le hash md5 du dernier package sur notre site <https://www.wallabag.org/pages/download-wallabag.html>`_. |
29 | 30 | ||
30 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. | 31 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. |
31 | 32 | ||