aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/fr/user
diff options
context:
space:
mode:
Diffstat (limited to 'docs/fr/user')
-rw-r--r--docs/fr/user/configuration.rst114
-rw-r--r--docs/fr/user/create_account.rst46
-rw-r--r--docs/fr/user/download_articles.rst17
-rw-r--r--docs/fr/user/filters.rst2
-rw-r--r--docs/fr/user/first_article.rst68
-rw-r--r--docs/fr/user/import.rst83
-rw-r--r--docs/fr/user/installation.rst143
-rw-r--r--docs/fr/user/login.rst23
-rw-r--r--docs/fr/user/tags.rst2
9 files changed, 498 insertions, 0 deletions
diff --git a/docs/fr/user/configuration.rst b/docs/fr/user/configuration.rst
new file mode 100644
index 00000000..f8bb6d42
--- /dev/null
+++ b/docs/fr/user/configuration.rst
@@ -0,0 +1,114 @@
1Configuration
2=============
3
4Maintenant que vous êtes connecté, il est temps de confirurer votre compte.
5
6Cliquez sur le menu ``Configuration``. Vous avez accès à 5 onglets:
7``Paramètres``, ``RSS``, ``Mon compte``, ``Mot de passe`` and ``Règles de tag automatiques``.
8
9Paramètres
10----------
11
12Thème
13~~~~~
14
15L'affichage de wallabag est personnalisable. C'est ici que vous choisissez le thème
16que vous préférez. Vous pouvez aussi en créer un nouveau, une documentation sera
17disponible pour apprendre comment. Le thème par défaut ``Material``, c'est ce thème
18qui est utilisé dans les captures d'écran de la documentation.
19
20Nombre d'articles par page
21~~~~~~~~~~~~~~~~~~~~~~~~~~
22
23Vous pouvez définir le nombre d'articles affichés sur chaque page.
24
25Langue
26~~~~~~
27
28Vous pouvez définir la langue de l'interface de wallabag. Vous devrez vous déconnecter
29pour que la nouvelle langue soit prise en compte.
30
31RSS
32---
33
34wallabag propose un flux RSS for chaque statut d'article : non lus, favoris and lus.
35
36Tout d'abord, vous devez vous créer un jeton personnel : cliquez sur ``Créez votre jeton``.
37C'est possible de regénérer votre jeton en cliquant sur ``Réinitialisez votre jeton``.
38
39Vous avez maintenant trois liens, un par statut : ajoutez les dans votre agrégateur de flux RSS préféré.
40
41Vous pouvez aussi définir combien d'articles vous souhaitez dans vos flux RSS
42(50 est la valeur par défaut).
43
44Mon compte
45----------
46
47Vous pouvez ici modifier votre nom, votre adresse email et activer la ``Double authentification``.
48
49Double authentification (2FA)
50~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
51
52 Two-factor authentication (also known as 2FA) is a technology patented in
53 1984 that provides identification of users by means of the combination of two different components.
54
55https://en.wikipedia.org/wiki/Two-factor_authentication
56
57Si vous activer 2FA, à chaque tentative de connexion à wallabag, vous recevrez
58un code par email. Vous devez renseigner ce code dans le formulaire suivant :
59
60.. image:: ../../img/user/2FA_form.png
61 :alt: Two factor authentication
62 :align: center
63
64Si vous ne souhaitez pas recevoir un code à chaque fois que vous vous connectez,
65vous pouvez cocher la case ``Je suis sur un ordinateur de confiance`` : wallabag
66se souviendra de vous pour 15 jours.
67
68Mot de passe
69------------
70
71Vous pouvez changer de mot de passe ici (8 caractères minimum).
72
73Règles de tag automatiques
74--------------------------
75
76Si vous voulez automatiquement assigner un tag à de nouveaux articles en fonction de
77certains critères, cette partie de la configuration est pour vous.
78
79Que veut dire « règles de tag automatiques » ?
80~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
81
82Ce sont des règles utilisées par wallabag pour automatiquement assigner un tag
83à un nouvel article.
84À chaque fois que vous ajoutez un nouvel article, toutes les règles sont utilisées pour ajouter
85les tags que vous avez configurés, vous épargnant ainsi la peine de classer manuellement vos articles.
86
87Comment les utiliser ?
88~~~~~~~~~~~~~~~~~~~~~~
89
90Admettons que vous voulez ajouter comme tag *« lecture rapide »* quand le temps de lecture
91d'un article est inférieur à 3 minutes.
92Dans ce cas, vous devez ajouter « readingTime <= 3 » dans le champ **Règle** et *« lecture rapide »* dans le champ **Tags**.
93Plusieurs tags peuvent être ajoutés en même temps en les séparant par une virgule : *« lecture rapide, à lire »*.
94Des règles complexes peuvent être écrites en utilisant les opérateurs pré-définis :
95if *« readingTime >= 5 AND domainName = "github.com" »* then tag as *« long reading, github »*.
96
97Quels variables et opérateurs puis-je utiliser pour écrire mes règles ?
98~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
99
100Les variables et opérateurs suivants peuvent être utilisés lors de la création de vos règles :
101
102=========== ============================================== ========== ==========
103Variable Sens Opérateur Sens
104----------- ---------------------------------------------- ---------- ----------
105title Titre de l'article <= Inférieur ou égal à …
106url URL de l'article < Strictement inférieur à …
107isArchived Si l'article est archivé ou non => Supérieur ou égal à …
108isStared Si l'article est en favori ou non > Strictement supérieur à …
109content Le contenu de l'article = Égal à …
110language La langue de l'article != Différent de …
111mimetype The type MIME de l'article OR Telle règle ou telle autre règle
112readingTime Le temps de lecture de l'article, en minutes AND Telle règle et telle règle
113domainName Le nom de domaine de l'article matches Contient telle chaine de caractère (insensible à la casse). Exemple : title matches "football"
114=========== ============================================== ========== ==========
diff --git a/docs/fr/user/create_account.rst b/docs/fr/user/create_account.rst
new file mode 100644
index 00000000..7fea6edf
--- /dev/null
+++ b/docs/fr/user/create_account.rst
@@ -0,0 +1,46 @@
1Se créer un compte
2==================
3
4Sur la page de connexion, cliquez sur le bouton ``Créer un compte``.
5
6.. image:: ../../img/user/registration_form.png
7 :alt: Registration form
8 :align: center
9
10Vous devez renseigner le formulaire. Faites attention de bien renseigner une adresse
11email valide, nous allons vous envoyer un email d'activation.
12
13.. image:: ../../img/user/sent_email.png
14 :alt: Email was sent to activate account
15 :align: center
16
17Vérifiez votre boite de réception, vous avez un nouvel email avec un lien comme celui-ci
18``http://wallabag/register/confirm/Ba19wokGovN-DdBQNfg4YgRkUQWRP4-k2g0Bk-hBTX4``.
19Cliquez dessus pour activer votre compte.
20
21Votre compte est maintenant actif.
22
23.. image:: ../../img/user/activated_account.png
24 :alt: Welcome on board!
25 :align: center
26
27Foire aux questions
28-------------------
29
30Je ne veux pas valider le formulaire de création de compte
31~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32
33Soyez 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
38Je 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
43Quand je clique sur le lien d'activation, j'ai ce message : ``The user with confirmation token "DtrOPfbQeVkWf6N" does not exist``.
44~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
45
46Vous avez déjà activé votre compte ou l'URL d'activation n'est pas correcte.
diff --git a/docs/fr/user/download_articles.rst b/docs/fr/user/download_articles.rst
new file mode 100644
index 00000000..dafeba37
--- /dev/null
+++ b/docs/fr/user/download_articles.rst
@@ -0,0 +1,17 @@
1Télécharger des articles
2========================
3
4Vous pouvez télécharger chaque article dans plusieurs formats : ePUB, MOBI, PDF, XML, JSON, CSV.
5
6Lorsque vous lisez un article, cliquez sur cette icône dans la barre latérale :
7
8.. image:: ../../img/user/download_article.png
9 :alt: download article
10 :align: center
11
12Vous pouvez aussi télécharger une catégorie (non lus, favoris, lus) dans ces formats.
13Par exemple, dans la vue **Non lus**, cliquez sur cette icône dans la barre supérieure :
14
15.. image:: ../../img/user/download_articles.png
16 :alt: download articles
17 :align: center
diff --git a/docs/fr/user/filters.rst b/docs/fr/user/filters.rst
new file mode 100644
index 00000000..ecb29948
--- /dev/null
+++ b/docs/fr/user/filters.rst
@@ -0,0 +1,2 @@
1Filtres
2=======
diff --git a/docs/fr/user/first_article.rst b/docs/fr/user/first_article.rst
new file mode 100644
index 00000000..90c45a44
--- /dev/null
+++ b/docs/fr/user/first_article.rst
@@ -0,0 +1,68 @@
1Sauvegardez votre premier article
2=================================
3
4La fonctionnalité principale de wallabag est de sauvegarder des articles.
5Vous avez plusieurs manières de le faire.
6
7.. note::
8
9 Un guide de démarrage s'affichera dans l'application jusqu'à ce que vous
10 enregistriez votre premier article.
11
12En utilisant le bookmarklet
13---------------------------
14
15Sur la page ``Aide``, vous avez un onglet ``Bookmarklet``. Glissez/déposez le lien ``bag it!``
16dans votre barre de favoris de votre navigateur.
17
18Maintennat, à chaque fois que vous lisez un article et que vous souhaitez le sauvegarder,
19cliquez sur le lien ``bag it!`` dans votre barre de favoris. L'article est enregistré.
20
21En utilisant le formulaire classique
22------------------------------------
23
24Dans la barre haut de wallabag, vous avez trois icônes. Avec la première icône,
25un signe plus, vous pouvez facilement ajouter un nouvel article.
26
27.. image:: ../../img/user/topbar.png
28 :alt: Top bar
29 :align: center
30
31Cliquez dessus pour afficher un nouveau champ, collez-y l'URL de l'article et appuyez
32sur la touche ``Entrée``. L'article est enregistré.
33
34En utilisant l'extension de votre navigateur
35--------------------------------------------
36
37Firefox
38~~~~~~~
39
40*Cette extension n'est pas encore disponible pour wallabag v2*.
41
42Chrome
43~~~~~~
44
45*Cette extension n'est pas encore disponible pour wallabag v2*.
46
47En utilisant l'application de votre smartphone
48----------------------------------------------
49
50Android
51~~~~~~~
52
53*Cette application n'est pas encore disponible pour wallabag v2*.
54
55Firefox OS
56~~~~~~~~~~
57
58*Cette application n'est pas encore disponible pour wallabag v2*.
59
60Windows Phone
61~~~~~~~~~~~~~
62
63*Cette application n'est pas encore disponible pour wallabag v2*.
64
65iOS
66~~~
67
68*Cette application n'est pas encore disponible pour wallabag v2*.
diff --git a/docs/fr/user/import.rst b/docs/fr/user/import.rst
new file mode 100644
index 00000000..c95f175d
--- /dev/null
+++ b/docs/fr/user/import.rst
@@ -0,0 +1,83 @@
1Migrer à wallabag
2=================
3
4Depuis wallabag
5---------------
6
7Exportez vos données de wallabag 1.x
8~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9
10Sur 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 from wallabag 1.x
14 :align: center
15
16Vous obtiendrez un fichier ``wallabag-export-1-1970-01-01.json``.
17
18Exportez vos données de wallabag 2.x
19~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20
21Dans la barre latérale de téléchargement, cliquez sur ``JSON``.
22
23.. image:: ../../img/user/export_wllbg_2.png
24 :alt: Export from wallabag 2.x
25 :align: center
26
27Vous obtiendrez un fichier ``Unread articles.json``.
28
29Importez vos données wallabag 2.x
30~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
31
32Cliquez sur le lien ``Importer`` dans le menu, choisissez la version de wallabag correspondante,
33sélectionnez votre fichier d'export sur votre ordinateur et importez-le.
34
35.. image:: ../../img/user/import_wllbg.png
36 :alt: Import from wallabag 1.x
37 :align: center
38
39Tous vos articles wallabag seront importés.
40
41Depuis Pocket
42-------------
43
44Créer une nouvelle application dans Pocket
45~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
46
47Pour importer vos données depuis Pocket, nous utilisons l'API de Pocket.
48Vous devez créer une nouvelle application sur leur site dédié aux développeurs pour continuer.
49
50* Créez une nouvelle application `sur leur site Développeurs <https://getpocket.com/developer/apps/new>`_
51* Remplissez les champs requis : nom de l'application, description de l'application,
52 permissions (seulement **retrieve**), la plateforme (**web**), acceptez les
53 termes d'utilisation du service et soumettez votre application
54
55Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`).
56Vous devez configurer la ``pocket_consumer_key`` dans le fichier ``app/config/parameters.yml``.
57
58Maintenant, tout est bien configuré pour migrer depuis Pocket.
59
60Importez vos données dans wallabag 2.x
61~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
62
63Cliquez sur le lien ``Importer`` dans le menu, sur ``Importer les contenus`` dans
64la section Pocket puis sur ``Se connecter à Pocket et importer les données``.
65
66Vous devez autoriser wallabag à se connecter à votre compte Pocket.
67Vos données vont être importées. L'import de données est une action qui peut être couteuse
68pour votre serveur (nous devons encore travailler pour améliorer cet import).
69
70Depuis Instapaper
71-----------------
72
73*Fonctionnalité pas encore implémentée dans wallabag v2.*
74
75Depuis Readability
76------------------
77
78*Fonctionnalité pas encore implémentée dans wallabag v2.*
79
80Depuis un fichier HTML ou JSON
81------------------------------
82
83*Fonctionnalité pas encore implémentée dans wallabag v2.*
diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst
new file mode 100644
index 00000000..9c5c3cc8
--- /dev/null
+++ b/docs/fr/user/installation.rst
@@ -0,0 +1,143 @@
1Installer wallabag
2==================
3
4Pré-requis
5------------
6
7wallabag est compatible avec php >= 5.5
8
9Vous 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
11- php-session
12- php-ctype
13- php-dom
14- pĥp-hash
15- php-simplexml
16- php-json
17- php-gd
18- php-mbstring
19- php-xml
20- php-tidy
21- php-iconv
22- php-curl
23- php-gettext
24- php-tokenizer
25
26wallabag 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
28- php-pdo_mysql
29- php-pdo_sqlite
30- php-pdo_pgsql
31
32Installation
33------------
34
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.
36
37Installation de Composer :
38
39::
40
41 curl -s http://getcomposer.org/installer | php
42
43Vous pouvez trouver des instructions spécifiques ici (en anglais) : __ https://getcomposer.org/doc/00-intro.md
44
45Pour installer wallabag, vous devez exécuter ces deux commandes :
46
47::
48
49 SYMFONY_ENV=prod composer create-project wallabag/wallabag wallabag "2.0.*@alpha" --no-dev
50 php bin/console wallabag:install --env=prod
51
52Pour démarrer le serveur interne à php et vérifier que tout s'est installé correctement, vous pouvez exécuter :
53
54::
55
56 php bin/console server:run --env=prod
57
58Et accéder wallabag à l'adresse http://lipdevotreserveur:8000
59
60Installation avec Apache
61------------------------
62
63En 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 :
64
65::
66
67 <VirtualHost *:80>
68 ServerName domain.tld
69 ServerAlias www.domain.tld
70
71 DocumentRoot /var/www/wallabag/web
72 <Directory /var/www/wallabag/web>
73 AllowOverride None
74 Order Allow,Deny
75 Allow from All
76
77 <IfModule mod_rewrite.c>
78 Options -MultiViews
79 RewriteEngine On
80 RewriteCond %{REQUEST_FILENAME} !-f
81 RewriteRule ^(.*)$ app.php [QSA,L]
82 </IfModule>
83 </Directory>
84
85 # uncomment the following lines if you install assets as symlinks
86 # or run into problems when compiling LESS/Sass/CoffeScript assets
87 # <Directory /var/www/wallabag>
88 # Options FollowSymlinks
89 # </Directory>
90
91 # optionally disable the RewriteEngine for the asset directories
92 # which will allow apache to simply reply with a 404 when files are
93 # not found instead of passing the request into the full symfony stack
94 <Directory /var/www/wallabag/web/bundles>
95 <IfModule mod_rewrite.c>
96 RewriteEngine Off
97 </IfModule>
98 </Directory>
99 ErrorLog /var/log/apache2/wallabag_error.log
100 CustomLog /var/log/apache2/wallabag_access.log combined
101 </VirtualHost>
102
103Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
104
105Installation avec Nginx
106-----------------------
107
108En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag, voici un fichier de configuration Nginx pour wallabag :
109
110::
111
112 server {
113 server_name domain.tld www.domain.tld;
114 root /var/www/wallabag/web;
115
116 location / {
117 # try to serve file directly, fallback to app.php
118 try_files $uri /app.php$is_args$args;
119 }
120 location ~ ^/app\.php(/|$) {
121 fastcgi_pass unix:/var/run/php5-fpm.sock;
122 fastcgi_split_path_info ^(.+\.php)(/.*)$;
123 include fastcgi_params;
124 # When you are using symlinks to link the document root to the
125 # current version of your application, you should pass the real
126 # application path instead of the path to the symlink to PHP
127 # FPM.
128 # Otherwise, PHP's OPcache may not properly detect changes to
129 # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
130 # for more information).
131 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
132 fastcgi_param DOCUMENT_ROOT $realpath_root;
133 # Prevents URIs that include the front controller. This will 404:
134 # http://domain.tld/app.php/some-path
135 # Remove the internal directive to allow URIs like this
136 internal;
137 }
138
139 error_log /var/log/nginx/wallabag_error.log;
140 access_log /var/log/nginx/wallabag_access.log;
141 }
142
143Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
diff --git a/docs/fr/user/login.rst b/docs/fr/user/login.rst
new file mode 100644
index 00000000..7ef70569
--- /dev/null
+++ b/docs/fr/user/login.rst
@@ -0,0 +1,23 @@
1Se connecter
2============
3
4Votre compte est maintenant actif, félicitations !
5
6Pour vous connecter à wallabag, remplissez le formulaire de connexion.
7
8Si vous êtes sur un ordinateur de confiance et que vous souhaitez rester connecté
9vous pouvez cocher la case ``Restez connecté`` : wallabag se souviendra de vous pour un an.
10
11.. image:: ../../img/user/login_form.png
12 :alt: Login form
13 :align: center
14
15Foire aux questions
16-------------------
17
18J'ai oublié mon mot de passe
19~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20
21Vous pouvez réinitialiser votre mot de passe en cliquant sur ``Mot de passe oublié ?``,
22sur la page de connexion. Ensuite, renseignez votre adresse email ou votre nom d'utilisateur,
23un email vous sera envoyé.
diff --git a/docs/fr/user/tags.rst b/docs/fr/user/tags.rst
new file mode 100644
index 00000000..8ddc0f40
--- /dev/null
+++ b/docs/fr/user/tags.rst
@@ -0,0 +1,2 @@
1Tags
2==== \ No newline at end of file
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-02 23:38:32 +0000