[github/wallabag/wallabag.git] / docs / fr / user / configuration.rst

Configuration
=============

Maintenant que vous êtes connecté, il est temps de configurer votre compte.

Cliquez sur le menu ``Configuration``. Vous avez accès à 5 onglets :
``Paramètres``, ``RSS``, ``Mon compte``, ``Mot de passe`` and ``Règles de tag automatiques``.

Paramètres
----------

Thème
~~~~~

L'affichage de wallabag est personnalisable. C'est ici que vous choisissez le thème
que vous préférez. Le thème par défaut est ``Material``, c'est celui
qui est utilisé dans les captures d'écran de la documentation.

Nombre d'articles par page
~~~~~~~~~~~~~~~~~~~~~~~~~~

Vous pouvez définir le nombre d'articles affichés sur chaque page.

Vitesse de lecture
~~~~~~~~~~~~~~~~~~

wallabag calcule une durée de lecture pour chaque article. Vous pouvez définir ici, grâce à cette liste déroulante, si vous lisez plus ou moins vite. wallabag recalculera la durée de lecture de chaque article.

Où souhaitez-vous être redirigé après avoir marqué un article comme lu ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Chaque fois que vous ferez certaines actions (après avoir marqué un article comme lu / comme favori,
après avoir supprimé un article, après avoir retiré un tag d'un article), vous pouvez être redirigé :

- sur la page d'accueil
- sur la page courante

Langue
~~~~~~

Vous pouvez définir la langue de l'interface de wallabag.

RSS
---

wallabag propose un flux RSS pour chaque statut d'article : non lus, favoris et lus.

Tout d'abord, vous devez vous créer un jeton personnel : cliquez sur ``Créez votre jeton``.
Il est possible de regénérer votre jeton en cliquant sur ``Réinitialisez votre jeton``.

Vous avez maintenant trois liens, un par statut : ajoutez-les dans votre agrégateur de flux RSS préféré.

Vous pouvez aussi définir combien d'articles vous souhaitez dans vos flux RSS
(50 est la valeur par défaut).

Une pagination est aussi disponible pour ces flux. Il suffit de rajouter ``?page=2`` pour aller à la seconde page, par exemple.
Cette pagination suit `la RFC <https://tools.ietf.org/html/rfc5005#page-4>`_, ce qui signifie que vous trouverez la page suivante (``next``), précédente (``previous``) et la dernière (``last``) dans la balise `<channel>` de chaque flux RSS.

Mon compte
----------

Vous pouvez ici modifier votre nom, votre adresse email et activer la ``Double authentification``.

Si l'instance de wallabag compte plus d'un utilisateur actif, vous pouvez supprimer ici votre compte. **Attention, nous supprimons toutes vos données**.

Double authentification (2FA)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    L'authentification à deux facteurs (également appelée 2FA) est une technologie brevetée en 1984
    qui fournit l'identification des utilisateurs au moyen de la combinaison de deux composants différents .

https://fr.wikipedia.org/wiki/Authentification_forte

Si vous activez 2FA, à chaque tentative de connexion à wallabag, vous recevrez
un code par email. Vous devez renseigner ce code dans le formulaire suivant :

.. image:: ../../img/user/2FA_form.png
    :alt: Authentification à deux facteurs
    :align: center

Si vous ne souhaitez pas recevoir un code à chaque fois que vous vous connectez,
vous pouvez cocher la case ``Je suis sur un ordinateur de confiance`` : wallabag
se souviendra de vous pour 15 jours.

Mot de passe
------------

Vous pouvez changer de mot de passe ici (8 caractères minimum).

Règles de tag automatiques
--------------------------

Si vous voulez automatiquement assigner un tag à de nouveaux articles en fonction de
certains critères, cette partie de la configuration est pour vous.

Que veut dire « règles de tag automatiques » ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Ce sont des règles utilisées par wallabag pour automatiquement assigner un tag
à un nouvel article.
À chaque fois que vous ajoutez un nouvel article, toutes les règles sont utilisées pour ajouter
les tags que vous avez configurés, vous épargnant ainsi la peine de classer manuellement vos articles.

Comment les utiliser ?
~~~~~~~~~~~~~~~~~~~~~~

Admettons que vous voulez ajouter comme tag *« lecture rapide »* quand le temps de lecture
d'un article est inférieur à 3 minutes.
Dans ce cas, vous devez ajouter « readingTime <= 3 » dans le champ **Règle** et *« lecture rapide »* dans le champ **Tags**.
Plusieurs tags peuvent être ajoutés en même temps en les séparant par une virgule : *« lecture rapide, à lire »*.
Des règles complexes peuvent être écrites en utilisant les opérateurs pré-définis :
if *« readingTime >= 5 AND domainName = "github.com" »* then tag as *« long reading, github »*.

Quels variables et opérateurs puis-je utiliser pour écrire mes règles ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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"``) :

===========  ==============================================  ==========  ==========
Variable     Sens                                            Opérateur   Sens
-----------  ----------------------------------------------  ----------  ----------
title        Titre de l'article                              <=          Inférieur ou égal à …
url          URL de l'article                                <           Strictement inférieur à …
isArchived   Si l'article est archivé ou non                 =>          Supérieur ou égal à …
isStarred    Si l'article est en favori ou non               >           Strictement supérieur à …
content      Le contenu de l'article                         =           Égal à …
language     La langue de l'article                          !=          Différent de …
mimetype     The type MIME de l'article                      OR          Telle règle ou telle autre règle
readingTime  Le temps de lecture de l'article, en minutes    AND         Telle règle et telle règle
domainName   Le nom de domaine de l'article                  matches     Contient telle chaîne de caractère (insensible à la casse). Exemple : title matches "football"
===========  ==============================================  ==========  ==========
Commit	Line	Data
	1	Configuration
	2	=============
	3
	4	Maintenant que vous êtes connecté, il est temps de configurer votre compte.
	5
	6	Cliquez 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
	9	Paramètres
	10	----------
	11
	12	Thème
	13	~~~~~
	14
	15	L'affichage de wallabag est personnalisable. C'est ici que vous choisissez le thème
	16	que vous préférez. Le thème par défaut est ``Material``, c'est celui
	17	qui est utilisé dans les captures d'écran de la documentation.
	18
	19	Nombre d'articles par page
	20	~~~~~~~~~~~~~~~~~~~~~~~~~~
	21
	22	Vous pouvez définir le nombre d'articles affichés sur chaque page.
	23
	24	Vitesse de lecture
	25	~~~~~~~~~~~~~~~~~~
	26
	27	wallabag calcule une durée de lecture pour chaque article. Vous pouvez définir ici, grâce à cette liste déroulante, si vous lisez plus ou moins vite. wallabag recalculera la durée de lecture de chaque article.
	28
	29	Où souhaitez-vous être redirigé après avoir marqué un article comme lu ?
	30	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	31
	32	Chaque fois que vous ferez certaines actions (après avoir marqué un article comme lu / comme favori,
	33	après avoir supprimé un article, après avoir retiré un tag d'un article), vous pouvez être redirigé :
	34
	35	- sur la page d'accueil
	36	- sur la page courante
	37
	38	Langue
	39	~~~~~~
	40
	41	Vous pouvez définir la langue de l'interface de wallabag.
	42
	43	RSS
	44	---
	45
	46	wallabag propose un flux RSS pour chaque statut d'article : non lus, favoris et lus.
	47
	48	Tout d'abord, vous devez vous créer un jeton personnel : cliquez sur ``Créez votre jeton``.
	49	Il est possible de regénérer votre jeton en cliquant sur ``Réinitialisez votre jeton``.
	50
	51	Vous avez maintenant trois liens, un par statut : ajoutez-les dans votre agrégateur de flux RSS préféré.
	52
	53	Vous pouvez aussi définir combien d'articles vous souhaitez dans vos flux RSS
	54	(50 est la valeur par défaut).
	55
	56	Une pagination est aussi disponible pour ces flux. Il suffit de rajouter ``?page=2`` pour aller à la seconde page, par exemple.
	57	Cette pagination suit `la RFC <https://tools.ietf.org/html/rfc5005#page-4>`_, ce qui signifie que vous trouverez la page suivante (``next``), précédente (``previous``) et la dernière (``last``) dans la balise `<channel>` de chaque flux RSS.
	58
	59	Mon compte
	60	----------
	61
	62	Vous pouvez ici modifier votre nom, votre adresse email et activer la ``Double authentification``.
	63
	64	Si l'instance de wallabag compte plus d'un utilisateur actif, vous pouvez supprimer ici votre compte. Attention, nous supprimons toutes vos données.
	65
	66	Double authentification (2FA)
	67	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	68
	69	L'authentification à deux facteurs (également appelée 2FA) est une technologie brevetée en 1984
	70	qui fournit l'identification des utilisateurs au moyen de la combinaison de deux composants différents .
	71
	72	https://fr.wikipedia.org/wiki/Authentification_forte
	73
	74	Si vous activez 2FA, à chaque tentative de connexion à wallabag, vous recevrez
	75	un code par email. Vous devez renseigner ce code dans le formulaire suivant :
	76
	77	.. image:: ../../img/user/2FA_form.png
	78	:alt: Authentification à deux facteurs
	79	:align: center
	80
	81	Si vous ne souhaitez pas recevoir un code à chaque fois que vous vous connectez,
	82	vous pouvez cocher la case ``Je suis sur un ordinateur de confiance`` : wallabag
	83	se souviendra de vous pour 15 jours.
	84
	85	Mot de passe
	86	------------
	87
	88	Vous pouvez changer de mot de passe ici (8 caractères minimum).
	89
	90	Règles de tag automatiques
	91	--------------------------
	92
	93	Si vous voulez automatiquement assigner un tag à de nouveaux articles en fonction de
	94	certains critères, cette partie de la configuration est pour vous.
	95
	96	Que veut dire « règles de tag automatiques » ?
	97	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	98
	99	Ce sont des règles utilisées par wallabag pour automatiquement assigner un tag
	100	à un nouvel article.
	101	À chaque fois que vous ajoutez un nouvel article, toutes les règles sont utilisées pour ajouter
	102	les tags que vous avez configurés, vous épargnant ainsi la peine de classer manuellement vos articles.
	103
	104	Comment les utiliser ?
	105	~~~~~~~~~~~~~~~~~~~~~~
	106
	107	Admettons que vous voulez ajouter comme tag « lecture rapide » quand le temps de lecture
	108	d'un article est inférieur à 3 minutes.
	109	Dans ce cas, vous devez ajouter « readingTime <= 3 » dans le champ Règle et « lecture rapide » dans le champ Tags.
	110	Plusieurs tags peuvent être ajoutés en même temps en les séparant par une virgule : « lecture rapide, à lire ».
	111	Des règles complexes peuvent être écrites en utilisant les opérateurs pré-définis :
	112	if « readingTime >= 5 AND domainName = "github.com" » then tag as « long reading, github ».
	113
	114	Quels variables et opérateurs puis-je utiliser pour écrire mes règles ?
	115	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	116
	117	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"``) :
	118
	119	=========== ============================================== ========== ==========
	120	Variable Sens Opérateur Sens
	121	----------- ---------------------------------------------- ---------- ----------
	122	title Titre de l'article <= Inférieur ou égal à …
	123	url URL de l'article < Strictement inférieur à …
	124	isArchived Si l'article est archivé ou non => Supérieur ou égal à …
	125	isStarred Si l'article est en favori ou non > Strictement supérieur à …
	126	content Le contenu de l'article = Égal à …
	127	language La langue de l'article != Différent de …
	128	mimetype The type MIME de l'article OR Telle règle ou telle autre règle
	129	readingTime Le temps de lecture de l'article, en minutes AND Telle règle et telle règle
	130	domainName Le nom de domaine de l'article matches Contient telle chaîne de caractère (insensible à la casse). Exemple : title matches "football"
	131	=========== ============================================== ========== ==========