aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/fr
diff options
context:
space:
mode:
authorNicolas Lœuillet <nicolas@loeuillet.org>2015-10-22 17:02:06 +0200
committerNicolas Lœuillet <nicolas@loeuillet.org>2015-10-22 17:02:06 +0200
commite686b5e6fe37b476d70eeadce34616d65572245b (patch)
tree850a783f53671a3ad71892c5d6bd41d1c4595043 /docs/fr
parent71200c4155490cb47b64172c3c2159f44cb80eca (diff)
parent59e91bc8931a386974a3817e9849aad1ca7fc186 (diff)
downloadwallabag-e686b5e6fe37b476d70eeadce34616d65572245b.tar.gz
wallabag-e686b5e6fe37b476d70eeadce34616d65572245b.tar.zst
wallabag-e686b5e6fe37b476d70eeadce34616d65572245b.zip
Merge pull request #1495 from wallabag/v2-docs
add docs
Diffstat (limited to 'docs/fr')
-rw-r--r--docs/fr/Administrateur/MAJ_wallabag.md22
-rw-r--r--docs/fr/Administrateur/Multi-utilisateurs.md35
-rw-r--r--docs/fr/Administrateur/Options_cachees.md40
-rw-r--r--docs/fr/Administrateur/Telechargement_et_installation.md121
-rw-r--r--docs/fr/Administrateur/sessions.md26
-rw-r--r--docs/fr/Contribuer_au_projet.md52
-rw-r--r--docs/fr/Developpeur/Creer_un_nouveau_theme.md9
-rw-r--r--docs/fr/Developpeur/Depot_git.md23
-rw-r--r--docs/fr/Developpeur/Docker.md9
-rw-r--r--docs/fr/Developpeur/Ecrire_fichier_configuration.md39
-rw-r--r--docs/fr/Developpeur/Vagrant.md34
-rw-r--r--docs/fr/Developpeur/v2.md9
-rw-r--r--docs/fr/Utilisateur/Classer_ses_articles.md68
-rw-r--r--docs/fr/Utilisateur/Configurer_wallabag.md30
-rw-r--r--docs/fr/Utilisateur/Convertir_en_ePub.md25
-rw-r--r--docs/fr/Utilisateur/Flux_RSS.md35
-rw-r--r--docs/fr/Utilisateur/Framabag.md34
-rw-r--r--docs/fr/Utilisateur/Importer_exporter.md78
-rw-r--r--docs/fr/Utilisateur/Lire_un_article.md58
-rw-r--r--docs/fr/Utilisateur/Rechercher.md21
-rw-r--r--docs/fr/Utilisateur/Sauvegarder_son_premier_article.md101
-rw-r--r--docs/fr/Utilisateur/Un_article_est_mal_affiche.md32
-rw-r--r--docs/fr/conf.py87
-rw-r--r--docs/fr/index.rst29
-rw-r--r--docs/fr/requirements.txt2
25 files changed, 1019 insertions, 0 deletions
diff --git a/docs/fr/Administrateur/MAJ_wallabag.md b/docs/fr/Administrateur/MAJ_wallabag.md
new file mode 100644
index 00000000..57929e11
--- /dev/null
+++ b/docs/fr/Administrateur/MAJ_wallabag.md
@@ -0,0 +1,22 @@
1---
2language: Français
3currentMenu: upgrade
4subTitle: Mettre à jour wallabag
5---
6
7# Mettre à jour wallabag
8
9 Pour mettre à jour votre installation, téléchargez et décompressez l’archive dans votre installation (ici `/var/www/html/wallabag/`) :
10
11 wget http://wllbg.org/latest
12 unzip latest
13 rsync -ur wallabag-version-number/* /var/www/html/wallabag/
14
15Supprimez le répertoire `install` et videz le cache :
16
17 cd /var/www/html/wallabag/
18 rm -r cache/* install/
19
20Pour vider le cache, il est également possible d'aller dans la page de configuration et de cliquer sur le lien pour supprimer le cache.
21
22Vérifiez dans le bas de la page de configuration que la dernière version est bien installée.
diff --git a/docs/fr/Administrateur/Multi-utilisateurs.md b/docs/fr/Administrateur/Multi-utilisateurs.md
new file mode 100644
index 00000000..77a48d5e
--- /dev/null
+++ b/docs/fr/Administrateur/Multi-utilisateurs.md
@@ -0,0 +1,35 @@
1---
2language: Français
3currentMenu: multiusers
4subTitle: wallabag multi-utilisateurs
5---
6
7# wallabag multi-utilisateurs
8
9## Créer un nouveau compte
10
11### Mode administrateur
12
13Si vous souhaitez utiliser wallabag pour plusieurs personnes, il est possible de créer de nouveaux comptes depuis la page de configuration.
14
15En bas de cette page se trouve un formulaire où vous devez saisir un nom d'utilisateur et un mot de passe.
16
17Il est maintenant possible de se connecter avec ce compte depuis la page d'identification de wallabag.
18
19Aucune information n'est partagée entre les différents comptes.
20
21### Mode libre
22
23A partir de la version 1.9, l'administrateur peut laisser libre la création de nouveaux comptes. Il doit pour cela l'autoriser en modifiant les lignes suivantes dans le fichier de configuration :
24
25 // registration
26 @define ('ALLOW_REGISTER', FALSE);
27 @define ('SEND_CONFIRMATION_EMAIL', FALSE);
28
29Ensuite, l'utilisateur rentrera lui-même son nom d'utilisateur et son mot de passe pour se créer un compte. Selon la configuration, un courriel de confirmation peut être envoyé aux utilisateurs ayant fourni une adresse électronique.
30
31## Supprimer un compte
32
33Il est possible de supprimer son propre compte, depuis la page de configuration. Il suffit de saisir son mot de passe et de demander la suppression.
34
35Bien évidemment, lorsqu'il ne reste plus qu'un seul compte, il est impossible de le supprimer.
diff --git a/docs/fr/Administrateur/Options_cachees.md b/docs/fr/Administrateur/Options_cachees.md
new file mode 100644
index 00000000..5d4094d4
--- /dev/null
+++ b/docs/fr/Administrateur/Options_cachees.md
@@ -0,0 +1,40 @@
1---
2language: Français
3currentMenu: hidden
4subTitle: Options cachées
5---
6
7# Options cachées
8
9## Mise en garde
10
11**Attention**, cette partie concerne les utilisateurs avancés. Nous allons modifier un fichier important de wallabag, `inc/poche/config.inc.php`, il est donc conseillé de faire une sauvegarde de celui-ci avant toute modification.
12**Toute erreur lors d'une modification d'un fichier de wallabag pourra entrainer des dysfonctionnements**.
13
14Ce fichier est créé lorsque vous installez wallabag.
15Installez donc d'abord wallabag, faites une copie du fichier et ouvrez-le avec ~~Sublime Text~~ votre éditeur de texte préféré.
16
17Dans ce fichier sont définis des paramètres qui ne sont, aujourd'hui, pas encore disponibles dans la page **Configuration** de wallabag.
18
19## Modification des options avancées
20
21Chaque paramètre est défini de cette façon :
22
23 @define ('NOM_DU_PARAMETRE', 'Valeur du paramètre');
24
25Pour chaque ligne, vous ne pouvez modifier que la partie `Valeur du paramètre`.
26
27Listons maintenant les différents paramètres que vous pouvez changer :
28
29* `HTTP_PORT` (par défaut, `80`) : correspond au port HTTP de votre serveur web. À changer si votre serveur web est derrière un proxy. Valeur attendue : un nombre.
30* `SSL_PORT` (par défaut, `443`) : correspond au port SSL de votre serveur web. À changer si votre serveur web utilises SSLH. Valeur attendue : un nombre.
31* `DEBUG_POCHE` (par défaut, `FALSE`) : si vous rencontrez des problèmes avec wallabag, nous vous demanderons peut-être d'activer le mode Debug. Valeurs attendues : `TRUE` ou `FALSE`.
32* `DOWNLOAD_PICTURES` (par défaut, `FALSE`) : permet de télécharger sur votre serveur les images des articles. Ce paramètre est désactivé par défaut pour ne pas surcharger votre serveur web. Nous préférons vous laisser activer vous-même ce paramètre. Valeurs attendues : `TRUE` ou `FALSE`.
33* `SHARE_TWITTER` (par défaut, `TRUE`) : permet d'activer le partage vers twitter. Valeurs attendues : `TRUE` ou `FALSE`.
34* `SHARE_MAIL` (par défaut, `TRUE`) : permet d'activer le partage par email. Valeurs attendues : `TRUE` ou `FALSE`.
35* `SHARE_SHAARLI` (par défaut, `FALSE`) : permet d'activer le partage vers votre installation de Shaarli (gestionnaire de favoris). Valeurs attendues : `TRUE` ou `FALSE`.
36* `SHAARLI_URL` (par défaut, `'http://myshaarliurl.com'`) : définit l'URL de votre installation de Shaarli. Valeur attendue : une URL.
37* `FLATTR` (par défaut, `TRUE`) : permet d'activer la possibilité de flattrer un article ([Flattr est une plateforme de micro-dons](http://fr.wikipedia.org/wiki/Flattr)). Si un article est flattrable, une icône s'affichera et vous permet d'envoyer un micro-don à l'auteur de l'article. Valeurs attendues : `TRUE` ou `FALSE`.
38* `SHOW_PRINTLINK` (par défaut, `'1'`) : permet d'afficher le lien pour imprimer un article. Valeurs attendues : `'0'` pour désactiver ou `'1'` pour activer.
39* `SHOW_READPERCENT` (par défaut, `'1'`) : permet d'afficher (sur les thèmes `default`, `dark`, `dmagenta`, `solarized`, `solarized-dark`) le pourcentage de lecture de l'article. Valeurs attendues : `'0'` pour désactiver ou `'1'` pour activer.
40* `PAGINATION` (par défaut, `'12'`) : définit le nombre d'articles affichés sur une liste. Valeur attendue : un nombre. \ No newline at end of file
diff --git a/docs/fr/Administrateur/Telechargement_et_installation.md b/docs/fr/Administrateur/Telechargement_et_installation.md
new file mode 100644
index 00000000..46eb4619
--- /dev/null
+++ b/docs/fr/Administrateur/Telechargement_et_installation.md
@@ -0,0 +1,121 @@
1---
2language: Français
3currentMenu: install
4subTitle: Télécharger et installer wallabag
5---
6
7# Télécharger et installer wallabag
8
9## Je ne souhaite pas installer wallabag
10
11Puisque vous ne voulez pas ou ne pouvez pas installer wallabag, nous vous proposons de créer un compte gratuit sur [Framabag](https://framabag.org/), lequel utilise notre logiciel. [Lisez la documentation complète](../Utilisateur/Framabag.md).
12
13## Je souhaite installer wallabag
14
15### Je souhaite télécharger wallabag manuellement
16
17[Télécharger la dernière version de wallabag](http://wllbg.org/latest) et décompresser-là :
18
19 wget http://wllbg.org/latest
20 unzip latest
21 mv wallabag-version-number wallabag
22
23Copiez les fichiers sur votre serveur web. Dans le cas d'Ubuntu/Debian, il s'agit de /var/www/html/ :
24
25 sudo mv wallabag /var/www/html/
26
27Puis sautez le paragraphe suivant.
28
29### Je souhaite télécharger wallabag via composer
30
31Vous devez installer composer :
32
33 curl -s http://getcomposer.org/installer | php
34
35Ensuite, sur votre serveur web, exécutez cette commande :
36
37 composer create-project wallabag/wallabag . dev-master
38
39Tout est téléchargé dans le répertoire courant.
40
41#### Pré-requis pour votre serveur web
42
43Wallabag nécessite qu'un certain nombre de composants soient installées sur votre serveur web.
44Pour être sûr que votre serveur possède tous les pré-requis, ouvrez dans votre navigateur la page `http://monserveur.com/wallabag/install/index.php`.
45
46Les composants sont :
47
48* [PHP 5.3.3 ou plus](http://php.net/manual/fr/install.php) **avec support [PDO](http://php.net/manual/en/book.pdo.php)**
49* [XML pour PHP](http://php.net/fr/xml)
50* [PCRE](http://php.net/fr/pcre)
51* [ZLib](http://php.net/en/zlib) (son absence affectera le traitement des pages compressées)
52* [mbstring](http://php.net/en/mbstring) et/ou [iconv](http://php.net/en/iconv) (sinon, certaines pages ne pourront pas être lues - même en anglais)
53* L'extension [DOM/XML](http://php.net/manual/en/book.dom.php)
54* [Filtrage des données](http://php.net/manual/fr/book.filter.php)
55* [GD](http://php.net/manual/en/book.image.php) (son absence empèchera la sauvegarde des images)
56* [Tidy pour PHP](http://php.net/fr/tidy) (son absence peut poser problème avec certaines pages)
57* [cURL](http://php.net/fr/curl) avec `Parallel URL fetching` (optionel)
58* [Parse ini file](http://uk.php.net/manual/en/function.parse-ini-file.php)
59* [allow_url_fopen](http://www.php.net/manual/fr/filesystem.configuration.php#ini.allow-url-fopen) (optionel si cURL présent)
60* [gettext](http://php.net/manual/fr/book.gettext.php) (nécessaire pour le support multilingues)
61
62Installez les composants manquants avant de poursuivre. Par exemple pour installer Tidy sur Ubuntu/Debian :
63
64 sudo apt-get install php5-tidy
65 sudo service apache2 reload
66
67Note : si voux utilisez IIS comme serveur web, vous devez interdire l'*Authentification Anonyme* et [permettre L'*Authentification de base*](https://technet.microsoft.com/fr-fr/library/cc772009%28v=ws.10%29.aspx) pour autoriser la connexion.
68
69#### Twig installation
70
71Pour pouvoir fonctionner, wallabag a besoin de `Twig`, une bibliothèque de modèles.
72Si vous ne pouvez pas installer `composer` (dans le cas d'hébergement mutualisé par exemple), nous vous proposons un fichier
73incluant `Twig`. Ce fichier peut être télécharger depuis la page `http://monserveur.com/wallabag/install/index.php` (section INSTALLATION TWIG) ou directement ici [http://wllbg.org/vendor](http://wllbg.org/vendor). Décompressez-le dans votre répertoire wallabag.
74
75Alternativement, vous pouvez installer `Twig` en lançant `composer` depuis votre dossier wallabag (toujours dans le cas d'Ubuntu/Debian : <code>/var/www/html/wallabag/</code>) en exécutant les commandes :
76
77 curl -s http://getcomposer.org/installer | php
78 php composer.phar install
79
80### Création de la base de données
81
82Wallabag peut s'installer sur différents types de bases de données :
83
84* [SQLite](http://php.net/manual/fr/book.sqlite.php). Le plus simple de tous. Rien de particulier à configurer.
85* [MySQL](http://php.net/manual/fr/book.mysql.php). Un système de base de données bien connu, qui est dans la plupart des cas plus efficace que SQLite.
86* [PostgreSQL](http://php.net/manual/fr/book.pgsql.php). Certaines personnes l'ont trouvé mieux que MySQL.
87
88Nous vous conseillons d'utiliser MySQL, plus performante. Il est alors nécessaire de créer une nouvelle base (par exemple `wallabag`), un nouvel utilisateur (par exemple `wallabag`) et un mot de passe (ici `VotreMotdePasse`). Vous pouvez pour cela utiliser `phpMyAdmin`, ou exécuter les commandes suivantes :
89
90 mysql -p -u root
91 mysql> CREATE DATABASE wallabag;
92 mysql> GRANT ALL PRIVILEGES ON `wallabag`.* TO 'wallabag'@'localhost' IDENTIFIED BY 'VotreMotdePasse';
93 mysql> exit
94
95*Note :* Si vous utilisez MySQL ou Postgresql, vous devrez **remplir tous les champs**, sinon l'installation ne fonctionera pas et un message d'erreur vous dira ce qui ne va pas. Vous devez créer manuellement la base de données qui sera utilisée par wallabag avec un outil comme PHPMyAdmin ou en ligne de commande.
96
97### Permissions
98
99Le serveur web doit avoir accès en écriture aux répertoires `assets`, `cache` et `db`. Sans cela, un message vous indiquera que l'installation est impossible :
100
101 sudo chown -R www-data:www-data /var/www/html/wallabag
102
103### Installation de wallabag. Enfin.
104
105Accédez à wallabag depuis votre navigateur : `http://votreserveur.com/wallabag`. Si votre serveur est bien configuré, vous arrivez sur l'écran d'installation.
106
107Renseignez le type de votre base de données (`sqlite`, `mysql` ou `postgresql`) et les informations de votre base de données. Dans le cas de la base MySQL créée plus haut, la configuration standard sera :
108
109 Database engine: MySQL
110 Server: localhost
111 Database: wallabag
112 Username: wallabag
113 Password: VotreMotdePasse
114
115Créez enfin votre premier utilisateur et son mot de passe (différents de l'utilisateur de la base de données).
116
117wallabag est maintenant installé.
118
119### Connexion
120
121Depuis votre navigateur, vous arrivez sur l'écran d'identification : saisissez votre identifiant et votre mot de passe et vous voici connecté.
diff --git a/docs/fr/Administrateur/sessions.md b/docs/fr/Administrateur/sessions.md
new file mode 100644
index 00000000..717e55e1
--- /dev/null
+++ b/docs/fr/Administrateur/sessions.md
@@ -0,0 +1,26 @@
1---
2language: Français
3currentMenu: sessions
4subTitle: Problème de sessions
5---
6
7Si vous vous retrouvez à être déconnecté même après avoir valider le *Stay signed in checkbox*,
8lancez les commandes suivantes comme administrateur (ou avec sudo) :
9
10```
11mkdir /var/lib/wallabag-sessions
12chown www-data:www-data /var/lib/wallabag-sessions
13```
14
15*NOTE : L'utilisateur et le groupe www-data pourrait ne pas exister.
16Vous pouvez alors utiliser ```chown http:http /var/lib/wallabag-sessions``` à la place.*
17
18Ensuite, en utilisant apache, ajoutez : `php_admin_value session.save_path /var/lib/wallabag-sessions`
19à votre vhost apache, tel que `wallabag-apache.conf`.
20Enfin, redémarrez apache, en lançant par exemple : ```/etc/init.d/apache2 restart```
21
22Si vous utilisez nginx, ajoutez `php_admin_value[session.save_path] = /var/lib/wallabag-sessions`
23à votre fichier de configuration de nginx.
24Ensuite, redémarrez nginx : ```/etc/init.d/nginx restart```
25
26*NOTE : si vous utilisez systemd, vous devriez faire `systemctl restart apache2` (ou nginx).*
diff --git a/docs/fr/Contribuer_au_projet.md b/docs/fr/Contribuer_au_projet.md
new file mode 100644
index 00000000..879cdaaa
--- /dev/null
+++ b/docs/fr/Contribuer_au_projet.md
@@ -0,0 +1,52 @@
1---
2language: Français
3currentMenu: help_us
4subTitle: Contribuer au projet
5---
6
7# Contribuer au projet
8## Soumettre des bugs
9### Demande de support
10
11Si vous avez un problème lors de l'installation ou de l'utilisation de wallabag (que ça soit l'application web ou les applications pour smartphone), utilisez le site de support [http://support.wallabag.org](http://support.wallabag.org).
12
13Nous verrons alors si nous pouvons vous dépanner rapidement ou alors s'il s'agit un nouveau bug qu'il nous faudra corriger.
14
15Il est préférable d'utiliser le site de support plutôt que de nous envoyer un mail : le suivi est plus pratique pour vous comme pour nous et la résolution de votre problème pourra resservir pour un autre utilisateur.
16
17### Créer un nouveau ticket
18
19Si vous avez trouvé un bug lors de votre utilisation de wallabag, merci d'ouvrir un nouveau ticket sur Github (un compte est nécessaire).
20
21**Avant toute chose**, pensez à lire [les recommandations nécessaires pour la rédaction d'un nouveau ticket](https://github.com/wallabag/wallabag/blob/master/CONTRIBUTING.md). Au mieux vous renseignez votre ticket, au mieux nous pourrons vous aider.
22
23* si c'est un bug avec l'application web, [ouvrez un nouveau ticket ici](https://github.com/wallabag/wallabag/issues/new)
24* si c'est un bug avec l'application Android, [ouvrez un nouveau ticket ici](https://github.com/wallabag/android-app/issues/new)
25* si c'est un bug avec l'application Windows Phone, [ouvrez un nouveau ticket ici](https://github.com/wallabag/windowsphone-app)
26* si c'est un bug avec l'application iOS, [ouvrez un nouveau ticket ici](https://github.com/wallabag/ios-app/issues/new)
27* si c'est un bug avec l'extension Firefox, [ouvrez un nouveau ticket ici](https://github.com/wallabag/firefox-ext/issues/new)
28* si c'est un bug avec l'extension Chrome, [ouvrez un nouveau ticket ici](https://github.com/wallabag/chrome-ext/issues/new)
29
30## Écrire et corriger la documentation
31
32La documentation que vous êtes en train de lire n'est sûrement pas complète, à jour, traduite dans votre langue. C'est pourquoi nous vous invitons à participer à sa rédaction.
33
34Le dépôt Github se trouve ici : [https://github.com/wallabag/documentation](https://github.com/wallabag/documentation).
35
36## Corriger les bugs, résoudre les problèmes : faire du support
37
38Deux possibilités :
39* lorsqu'un utilisateur de wallabag pose une nouvelle question [sur le site de support](http://support.wallabag.org), en tant qu'utilisateur avancé de wallabag, vous pouvez lui répondre.
40* sur Github, des tickets correspondent sûrement à vos compétences. [Parcourez la liste des tickets](https://github.com/wallabag/wallabag/issues) et servez-vous.
41
42Si vous souhaitez proposer une modification dans le code de wallabag, vous êtes le bienvenu. [N'oubliez pas de lire les recommandations pour proposer vos modifications](https://github.com/wallabag/wallabag/blob/master/CONTRIBUTING.md).
43
44## Communiquer
45
46Rien de compliqué ici, parlez de wallabag autour de vous. Utilisez le mot-clé #wallabag sur tous vos réseaux sociaux préférés : twitter, Facebook, Diaspora*, Google+, etc.
47
48D'ailleurs, voici la liste de nos comptes sur ces réseaux, si jamais vous voulez nous citer dans un de vos messages :
49* [Diaspora*](https://framasphere.org/people/2335ff202f920132196e2a0000053625)
50* [twitter](https:/twitter.com/wallabagapp)
51* [Facebook](https://www.facebook.com/wallabag)
52* [Google+](https://plus.google.com/+WallabagOrg/)
diff --git a/docs/fr/Developpeur/Creer_un_nouveau_theme.md b/docs/fr/Developpeur/Creer_un_nouveau_theme.md
new file mode 100644
index 00000000..15e89ce3
--- /dev/null
+++ b/docs/fr/Developpeur/Creer_un_nouveau_theme.md
@@ -0,0 +1,9 @@
1---
2language: Français
3currentMenu: theme
4subTitle: Créer un nouveau thème
5---
6
7# Créer un nouveau thème
8
9TODO \ No newline at end of file
diff --git a/docs/fr/Developpeur/Depot_git.md b/docs/fr/Developpeur/Depot_git.md
new file mode 100644
index 00000000..458e32ca
--- /dev/null
+++ b/docs/fr/Developpeur/Depot_git.md
@@ -0,0 +1,23 @@
1---
2language: Français
3currentMenu: repo
4subTitle: Dépôt git de wallabag
5---
6
7# Dépôt git de wallabag
8
9Si vous souhaitez contribuer au projet en proposant de nouvelles fonctionnalités ou en corrigeant des bugs, il faut suivre les recommandations que vous lirez ci-dessous concernant le dépôt Git disponible à cette adresse : [https://github.com/wallabag/wallabag](https://github.com/wallabag/wallabag).
10
11## État des lieux
12
13Pour la gestion des différentes versions de wallabag, nous utilisons Git.
14
15Nous utilisons plusieurs branches pour le code source de l'application web de wallabag :
16
17* la branche `master` : c'est la branche stable, celle qui est téléchargée pour tous ceux qui souhaitent installer wallabag pour leur utilisation.
18* la branche `dev` : avant d'être sur la branche `master`, toutes les corrections de bugs et nouvelles fonctionnalités doivent passer par cette branche. Cette branche n'est pas conseillée pour une utilisation en production.
19* la branche `v2-symfony` : c'est la branche de la refonte de wallabag. Un chapitre complet lui est consacré.
20
21## Workflow
22
23Toutes les consignes concernant le dépôt Git se trouve dans [le fichier CONTRIBUTING.md de wallabag](https://github.com/wallabag/wallabag/blob/master/CONTRIBUTING.md). Merci de le lire attentivement avant toute modification. \ No newline at end of file
diff --git a/docs/fr/Developpeur/Docker.md b/docs/fr/Developpeur/Docker.md
new file mode 100644
index 00000000..b5c9af81
--- /dev/null
+++ b/docs/fr/Developpeur/Docker.md
@@ -0,0 +1,9 @@
1---
2language: Français
3currentMenu: docker
4subTitle: Docker
5---
6
7# Docker
8
9TODO \ No newline at end of file
diff --git a/docs/fr/Developpeur/Ecrire_fichier_configuration.md b/docs/fr/Developpeur/Ecrire_fichier_configuration.md
new file mode 100644
index 00000000..e90b6526
--- /dev/null
+++ b/docs/fr/Developpeur/Ecrire_fichier_configuration.md
@@ -0,0 +1,39 @@
1---
2language: Français
3currentMenu: site_config
4subTitle: Écrire un fichier de configuration
5---
6
7# Écrire un fichier de configuration
8
9wallabag peut utiliser des fichiers de configuration spécifiques à un site pour lire les articles de ce site. Ces fichiers sont stockés dans le répertoire [`inc/3rdparty/site_config/standard`](https://github.com/wallabag/wallabag/tree/master/inc/3rdparty/site_config/standard).
10
11Le format utilisé pour ces fichiers est [XPath](http://www.w3.org/TR/xpath20/). Inspirez-vous des exemples dans le répertoire pour en créer de nouveaux.
12
13## Génération automatique de fichiers de configuration
14
15@FiveFilters a créé un [outil très utile](http://siteconfig.fivefilters.org/) pour créer des fichiers de configuration. Vous devez taper l'adresse d'un article qui vous intéresse. puis vous sélectionnez le contenu que vous souhaitez.
16
17![siteconfig](https://lut.im/RNaO7gGe/l9vRnO1b)
18
19Vous devez confirmer cette zone en essayant avec d'autres articles.
20Quand vous avez trouvé la bonne zone, cliquez simplement sur *Download Full-Text RSS site config* (Téléchargez la configuration du site Full-Text RSS) pour télécharger le fichier à inclure dans le répertoire.
21
22## Génération manuelle de fichiers de configuration
23
24Si l'outil de FiveFilters ne marche pas tel qu´attendu, regardez la source d'un article (Ctrl+U sur Firefox ou Chromium). Cherchez votre contenu parmi le code source et repérez l'attribut `class` ou `id` de la zone que vous souhaitez.
25
26Une fois que vous avez obtenu l'attribut `id` ou `class`, vous pouvez écrire par exemple l'une ou l'autre de ces lignes :
27
28```
29body: //div[@class='myclass']
30body: //div[@id='myid']
31```
32
33Ensuite, testez votre fichier de configuration avec d'autres articles du même site. Si vous avez trouvé le bon contenu mais que vous voulez enlever des parties inutiles, ajoutez la ligne suivante (avec l'attribut `class` correspondant à la partie inutile) :
34
35```
36strip: //div[@class='hidden']
37```
38
39Vous pouvez regarder d'autres options pour les fichiers de configuration de sites [sur l'aide du site de FiveFilters](http://help.fivefilters.org/customer/portal/articles/223153-site-patterns).
diff --git a/docs/fr/Developpeur/Vagrant.md b/docs/fr/Developpeur/Vagrant.md
new file mode 100644
index 00000000..b2f83bc8
--- /dev/null
+++ b/docs/fr/Developpeur/Vagrant.md
@@ -0,0 +1,34 @@
1---
2language: Français
3currentMenu: vagrant
4subTitle: Vagrant
5---
6
7# Vagrant
8
9Pour vous permettre de mettre en place rapidement la configuration requise pour wallabag, nous vous proposons un fichier Vagrantfile.
10
11[Définition Wikipedia](http://fr.wikipedia.org/wiki/Vagrant)
12
13 Vagrant est un logiciel libre et open-source pour la création et la configuration des environnements de développement virtuel. Il peut être considéré comme un wrapper autour du logiciel de virtualisation comme VirtualBox.
14
15## Utiliser Vagrant pour wallabag
16
17Voici la procédure pour exécuter wallabag au sein d'un conteneur Vagrant :
18
19 wget -O wallabag-dev.zip https://github.com/wallabag/wallabag/archive/dev.zip
20 unzip wallabag-dev.zip
21 cd wallabag-dev
22 vagrant up
23
24Accédez maintenant à `http://localhost:8003` et à vous de jouer !
25
26## Qu'a installé le Vagrantfile ?
27
28Le script installe un serveur LAMP, à savoir :
29
30* Ubuntu 14.04
31* Un serveur web Apache2
32* PHP5
33* SQLite ou MySQL ou PostgreSQL pour PHP
34* XDebug pour PHP
diff --git a/docs/fr/Developpeur/v2.md b/docs/fr/Developpeur/v2.md
new file mode 100644
index 00000000..470213d0
--- /dev/null
+++ b/docs/fr/Developpeur/v2.md
@@ -0,0 +1,9 @@
1---
2language: Français
3currentMenu: v2
4subTitle: wallabag v2 / symfony2
5---
6
7# wallabag v2 / symfony2
8
9TODO \ No newline at end of file
diff --git a/docs/fr/Utilisateur/Classer_ses_articles.md b/docs/fr/Utilisateur/Classer_ses_articles.md
new file mode 100644
index 00000000..447db3c8
--- /dev/null
+++ b/docs/fr/Utilisateur/Classer_ses_articles.md
@@ -0,0 +1,68 @@
1---
2language: Français
3currentMenu: sort_article
4subTitle: Classer ses articles
5---
6
7# Classer ses articles
8
9Pour pouvoir retrouver plus facilement vos articles, plusieurs méthodes existent.
10
11## Tags
12### Assigner un tag
13#### Depuis l'article
14
15Aujourd'hui, il n'est pas encore possible d'assigner un tag lorsque vous sauvegardez un nouvel article.
16
17Tout ajout de tag se fera donc sur un article déjà sauvegardé.
18
19Sur la page de lecture de l'article, se trouve une partie `tags` suivie d'un crayon. Cliquez sur ce crayon.
20
21Saisissez dans la case les tags que vous souhaitez assigner. Saisissez autant de tags que vous le voulez. Ils doivent être séparés par des virgules et non par des espaces. L'auto-complétion existe ici : si vous tapez les premières lettres d'un tag déjà existant, inutile de taper le mot en entier, sélectionnez-le dans la liste déroulante. Une fois tous vos tags saisis, cliquez sur le bouton **Tag**.
22
23Vous pouvez ensuite retourner lire votre article.
24
25#### Depuis la recherche
26
27Un chapitre complet sur la recherche existe. Ici, nous verrons uniquement comment assigner un tag depuis votre recherche.
28
29Lorsque votre recherche vous affiche les résultats, vous avez un lien en bas de page `Apply the tag ABCD to this search`. Cliquez dessus : un tag en fonction de la recherche que vous venez d'effectuer (ici `ABCD`) sera assigné à tous les articles trouvés.
30
31### Retrouver tous les articles d'un même tag
32
33Dans le menu de wallabag, cliquez sur **Tags**. Ici s'affichent tous les tags que vous avez créés, triés par nombre d'articles au sein de chaque tag. Cliquez sur l'un de ces tags pour retrouver tous les articles correspondants à ce tag.
34
35## Articles favoris
36
37Lorsque vous souhaitez mettre de côté un article, vous pouvez le marquer comme favori.
38
39### Marquer un article comme favori
40
41Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez mettre un article comme favori juste en cliquant sur l'étoile qui apparait.
42Recliquer sur cette étoile enlèvera le statut **favori** de cet article.
43
44### Retrouver tous ses articles favoris
45
46Dans le menu de wallabag, cliquez sur **Favoris** pour retrouver tous les articles que vous avez déjà mis en favori.
47
48## Articles archivés
49
50Lorsque vous avez lu un article, vous pouvez l'archiver : ainsi il n'apparaitra plus dans votre liste d'articles non lus.
51Le fait d'archiver un article ne le supprime pas de wallabag.
52
53### Archiver un article
54
55Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez archiver un article juste en cliquant sur l'icône ✓.
56Recliquer sur cette icône remettra l'article en statut **non lu**.
57
58### Retrouver tous ses articles archivés
59
60Dans le menu de wallabag, cliquez sur **Archive** pour retrouver tous les articles que vous avez déjà archivés.
61
62## Supprimer l'article
63
64Attention, la suppression d'un article est **définitive** : il est supprimé de la base de données de wallabag.
65
66Pour supprimer un article, une icône de corbeille se trouve sur la page d'un article ou sur une liste d'articles (articles non lus, favoris ou archivés par exemple).
67
68Nous vous faisons confiance : c'est pourquoi il n'y a aucune demande de confirmation lors de la suppression.
diff --git a/docs/fr/Utilisateur/Configurer_wallabag.md b/docs/fr/Utilisateur/Configurer_wallabag.md
new file mode 100644
index 00000000..2d95dc90
--- /dev/null
+++ b/docs/fr/Utilisateur/Configurer_wallabag.md
@@ -0,0 +1,30 @@
1---
2language: Français
3currentMenu: configure
4subTitle: Configurer wallabag
5---
6
7# Configurer wallabag
8
9Depuis le menu **configuration**, vous avez la possibilité de changer quelques options de wallabag.
10
11Certaines parties ne seront pas présentées ici car elles bénéficient d'un chapitre complet dans la documentation ([flux RSS](flux_rss.html), [l'import depuis un service tiers](importer_exporter.html), [l'export de vos données](importer_exporter.html), [la conversion en ePub](convertir_en_epub.html) et [le mode multi-utilisateurs](../Administrateur/multi-utilisateurs.html)).
12
13## Thème
14
15Des goûts et des couleurs, on ne discute pas. C'est pourquoi wallabag vous propose de changer son habillage pour plaire à chacun.
16Sélectionnez le thème de votre choix dans la liste déroulante et validez en cliquant sur **Mettre à jour**.
17
18## Langue
19
20Sélectionnez la langue de votre choix dans la liste déroulante et validez en cliquant sur **Mettre à jour**.
21
22## Mot de passe
23
24Saisissez votre nouveau mot de passe dans les deux champs prévus et validez en cliquant sur **Mettre à jour**.
25Vous serez alors déconnecté et devrez saisir votre nouveau mot de passe pour accéder à wallabag.
26
27## Vider le cache
28
29Le cache permet à wallabag d'effectuer certains traitements plus rapidement.
30Après une mise à jour de wallabag, il est conseillé de vider le cache. Vous n'avez qu'un clic à faire pour le vider.
diff --git a/docs/fr/Utilisateur/Convertir_en_ePub.md b/docs/fr/Utilisateur/Convertir_en_ePub.md
new file mode 100644
index 00000000..8172a78c
--- /dev/null
+++ b/docs/fr/Utilisateur/Convertir_en_ePub.md
@@ -0,0 +1,25 @@
1---
2language: Français
3currentMenu: epub
4subTitle: Convertir en ePub
5---
6
7# Convertir en ePub
8
9Pour que vous puissiez lire vos articles sauvegardés depuis votre liseuse, wallabag vous permet de les convertir au format ePub et ainsi vous créer un eBook pour vos longues soirées d'hiver.
10
11## Mise en garde
12
13Attention, la génération de fichiers ePub peut être très consommatrice de ressources pour le serveur sur lequel est installé wallabag. Cela dépend du nombre d'articles et de leur longueur.
14Ne générez pas un eBook trop important si cela n'est pas nécessaire.
15
16## Où convertir les articles
17
18Vous pouvez convertir vos articles depuis différents endroits de wallabag :
19
20* sur la page de lecture d'un article : le lien ePub convertira ce seul article
21* depuis une liste d'articles (articles non lus, favoris ou archivés, articles d'un tag) : un lien en bas de page vous permet de convertir tous les articles de cette catégorie
22* depuis une recherche : le lien se trouve en bas de page
23* depuis la page de configuration : vous allez pouvoir convertir tous vos articles, peu importe la catégorie dans laquelle ils se trouvent
24
25TODO parler de calibre \ No newline at end of file
diff --git a/docs/fr/Utilisateur/Flux_RSS.md b/docs/fr/Utilisateur/Flux_RSS.md
new file mode 100644
index 00000000..78862737
--- /dev/null
+++ b/docs/fr/Utilisateur/Flux_RSS.md
@@ -0,0 +1,35 @@
1---
2language: Français
3currentMenu: rss
4subTitle: Flux RSS
5---
6
7# Flux RSS
8
9Les flux RSS vous permettent :
10
11* de lire vos articles depuis votre lecteur de flux RSS préféré
12* d'activer les fonctionnalités de lecture pour les applications smartphones
13
14Tout d'abord, vous devez activer la fonctionnalité RSS en générant votre jeton de flux.
15Rendez-vous dans **configuration** de wallabag et créez le jeton dans la partie **Flux**.
16À tout moment, vous pouvez générer un nouveau jeton.
17
18## Lire les articles
19
20Une fois le jeton créé, vous avez accès à trois flux RSS :
21
22* celui des articles non lus
23* celui des articles favoris
24* celui des articles archivés
25
26Ajoutez le flux de votre choix dans votre lecteur de flux RSS.
27Attention, lorsque vous lirez un article depuis votre lecteur de flux, ça ne le marquera pas comme lu dans wallabag.
28
29### Partager vos lectures
30
31Si vous souhaitez partager vos lectures avec quelqu'un, envoyez-lui par exemple le flux RSS de vos articles préférés. Ainsi, dès qu'un article sera mis en favori dans wallabag, cette personne pourra également le lire.
32
33## Activer les fonctionnalités pour smartphones
34
35Vous avez créé le jeton de flux RSS : il va vous être utile pour configurer votre application smartphone. Pour en savoir sur les applications smartphones, vous pouvez lire [Sauvegarder son premier article](Sauvegarder_son_premier_article.md). \ No newline at end of file
diff --git a/docs/fr/Utilisateur/Framabag.md b/docs/fr/Utilisateur/Framabag.md
new file mode 100644
index 00000000..258f3dd5
--- /dev/null
+++ b/docs/fr/Utilisateur/Framabag.md
@@ -0,0 +1,34 @@
1---
2language: Français
3currentMenu: framabag
4subTitle: Se créer un compte sur Framabag
5---
6
7# Se créer un compte sur Framabag
8
9Puisque vous ne souhaitez peut-être pas gérer l'installation et la mise à jour de wallabag, ou puisque vous n'avez peut-être pas les connaissances pour l'installer, il vous est possible de vous créer un compte gratuit sur [Framabag.org](https://www.framabag.org).
10
11## Création du compte
12
13Cliquez sur le bouton **Créez votre compte / Create your account**.
14
15Vous devez saisir certaines informations : votre nom d'utilisateur, votre mot de passe et votre adresse email. Votre adresse n'est utilisée que pour la validation de votre compte, sauf si vous cochez la case pour recevoir la newsletter (3 à 4 envois par an).
16
17Une fois ce formulaire validé, vous recevez un email avec un lien de confirmation. Cliquez dessus, votre compte sera alors créé.
18
19Vous recevrez un dernier email avec l'adresse de votre compte Framabag, de la forme `https://www.framabag.org/u/votre-nom-d'utilisateur`.
20
21## Stockage de vos informations
22
23Framabag utilise une base de données par utilisateur. Nous ne faisons et ne ferons aucune utilisation de vos données stockées.
24
25## Vous avez oublié votre mot de passe
26
27Si vous avez oublié votre mot de passe pour vous connecter à Framabag, un formulaire est disponible [depuis la page d'accueil du service](https://www.framabag.org).
28Remplissez-le, un email de confirmation vous sera envoyé et vous permettra de saisir votre nouveau mot de passe.
29
30## Suppression de votre compte
31
32Si vous souhaitez supprimer votre compte, contactez-nous par email : [hello@wallabag.org](mailto:hello@wallabag.org) avec l'adresse de création de votre compte, en nous indiquant votre nom d'utilisateur.
33
34Nous vous répondrons quand votre compte sera supprimé : dès cet instant, plus aucune information vous concernant ne sera stockée sur Framabag.
diff --git a/docs/fr/Utilisateur/Importer_exporter.md b/docs/fr/Utilisateur/Importer_exporter.md
new file mode 100644
index 00000000..f5dda060
--- /dev/null
+++ b/docs/fr/Utilisateur/Importer_exporter.md
@@ -0,0 +1,78 @@
1---
2language: Français
3currentMenu: import
4subTitle: Importer ou exporter ses données
5---
6
7# Importer ou exporter ses données
8## Importer
9
10Pour importer des données dans wallabag, vous devez vous rendre dans la page **Configuration**.
11
12### Mise en garde
13
14L'import de données peut être une **opération gourmande** pour votre serveur. C'est pourquoi elle s'effectue en deux étapes :
15
16* l'insertion des URL dans la base de données de wallabag
17* dans un second temps, la récupération, pour chaque article, du contenu complet
18
19Ces deux actions ne peuvent pas être effectuées simultanément, car nous vous donnons la possibilité d'importer des milliers de liens, mais aujourd'hui, wallabag n'a pas les possibilités techniques nécessaires pour effectuer tout ce travail automatiquement.
20
21### Depuis Pocket
22#### Exporter ses données depuis Pocket
23
24Depuis votre compte Pocket, rendez-vous dans vos options.
25TODO
26
27#### Importer ses données Pocket
28
29Depuis la page de configuration de wallabag, partie **Import**, sélectionnez le fichier `ril_export.html` que Pocket a généré puis cliquez sur **Import**.
30wallabag ne fait qu'insérer les liens dans sa base de données. Il faut maintenant lui faire récupérer le contenu de chaque article.
31
32Pour cela, cliquez sur `Click to finish import` : wallabag récupèrera alors le contenu de 10 articles à la fois.
33
34TODO
35
36TODO nouveau ticket : pourquoi quand on clique une fois, ça ne charge pas en boucle ? Il me semblait que ça faisait ça ping @mariroz
37
38### Depuis Instapaper
39#### Exporter ses données depuis Instapaper
40
41TODO
42
43#### Importer ses données Instapaper
44
45TODO
46
47### Depuis Readability
48#### Exporter ses données depuis Readability
49
50TODO
51
52#### Importer ses données Readability
53
54TODO
55
56### Depuis wallabag
57
58Puisque vous pouvez exporter vos données de wallabag (lire ci-dessous), il est évidemment possible de les réimporter.
59
60Dans le formulaire d'import, sélectionnez votre fichier d'export wallabag (au format JSON). Démarrez l'import et voila.
61
62Contrairement aux imports ci-dessus, le traitement est moins long car toutes les données (titre et contenu des articles) sont déjà présentes dans le fichier, il n'est pas nécessaire pour wallabag d'accéder à chacune des URL.
63Par contre, le fichier d'import est forcément plus conséquent.
64
65### Depuis un fichier HTML ou JSON
66
67TODO
68
69## Exporter
70Il est possible d'exporter ses données depuis la page **Configuration** de wallabag. Plusieurs raisons possibles :
71
72* réinstaller wallabag
73* quitter le service Framabag pour installer soi-même wallabag
74* un compte sur un wallabag multi-utilisateurs souhaite avoir sa propre installation de wallabag
75* ...
76
77Vous téléchargerez alors un fichier [au format JSON](http://fr.wikipedia.org/wiki/JavaScript_Object_Notation).
78Comme nous l'avons vu ci-dessus, il est possible d'importer ce fichier dans wallabag. \ No newline at end of file
diff --git a/docs/fr/Utilisateur/Lire_un_article.md b/docs/fr/Utilisateur/Lire_un_article.md
new file mode 100644
index 00000000..72ebc07e
--- /dev/null
+++ b/docs/fr/Utilisateur/Lire_un_article.md
@@ -0,0 +1,58 @@
1---
2language: Français
3currentMenu: read_article
4subTitle: Lire un article
5---
6
7# Lire un article
8
9Lire un article n'est pas la chose la plus compliquée dans wallabag. Vous n'avez qu'à cliquer sur le titre d'un article pour l'afficher.
10
11## Revenir là où vous avez laissé votre article
12
13Si vous quittez un article alors que vous n'êtes qu'à la moitié de celui-ci par exemple, lorsque vous reviendrez, wallabag vous renverra là où vous avez laissé l'article.
14
15Cette astuce ne fonctionne qu'avec l'application web et pas les applications smartphones.
16
17## Actions possibles depuis l'article
18
19Ces actions sont possibles grâce aux icônes affichés en haut de la page. Nous partons du principe que vous utilisez le thème Baggy ([lire la documentation pour changer de thème](Configurer_wallabag.md)), les icônes dans les autres thèmes sont sensiblement les mêmes.
20Voici donc ces actions, par ordre d'apparition des icônes.
21
22### Lire l'article original
23
24Renvoie vers l'article original.
25
26### Marquer l'article comme lu
27
28Archive l'article, qui se retrouvera dans la catégorie **Archive** du menu de wallabag.
29Recliquer dessus permet de replacer cet article en état non lu.
30
31### Mettre l'article en favori
32
33Marque l'article comme favori, qui se retrouvera dans la catégorie **Favoris** du menu de wallabag.
34Recliquer dessus permet d'enlever le statut de favori.
35
36### Supprimer l'article
37
38Supprime complètement l'article de wallabag. Il ne pourra être restauré. Attention, aucune confirmation n'est demandée.
39
40### Partager vers twitter
41
42Partage le titre et le lien original de l'article sur twitter.
43
44### Partager par email
45
46Partage le titre et le lien original de l'article par email.
47
48### Imprimer l'article
49
50Ouvre la fenêtre d'impression du navigateur.
51
52### Convertir en ePub
53
54Convertit l'article au format ePub. [Un chapitre complet existe](Convertir_en_ePub.md).
55
56### Signaler que l'article s'affiche mal
57
58Permet de signaler qu'un article ne s'affiche pas comme attendu. [Un chapitre complet existe](Un_article_est_mal_affiche.md).
diff --git a/docs/fr/Utilisateur/Rechercher.md b/docs/fr/Utilisateur/Rechercher.md
new file mode 100644
index 00000000..2f84e075
--- /dev/null
+++ b/docs/fr/Utilisateur/Rechercher.md
@@ -0,0 +1,21 @@
1---
2language: Français
3currentMenu: search
4subTitle: Rechercher du contenu dans wallabag
5---
6
7# Rechercher du contenu dans wallabag
8
9Pour que vous puissiez retrouver un article au plus vite, nous avons mis en place un moteur de recherche complet.
10
11Cliquez sur **Rechercher** dans le menu de wallabag. Là, saisissez un terme de recherche.
12
13wallabag ira parcourir tous vos articles et affichera ceux qui contiennent le terme de recherche dans son titre, son contenu ou son URL.
14
15## Convertir cette recherche au format ePub
16
17Vous pouvez convertir les articles retournés au format ePub, pour les lire sur une liseuse par exemple. Lisez [Convertir en ePub](Convertir_en_ePub.md) pour en savoir plus.
18
19## Assigner un tag aux résultats de cette recherche
20
21Vous pouvez créer un tag en fonction du critère de recherche. Lisez [Classer ses articles](Classer_ses_articles.md) pour en savoir plus.
diff --git a/docs/fr/Utilisateur/Sauvegarder_son_premier_article.md b/docs/fr/Utilisateur/Sauvegarder_son_premier_article.md
new file mode 100644
index 00000000..e533f78f
--- /dev/null
+++ b/docs/fr/Utilisateur/Sauvegarder_son_premier_article.md
@@ -0,0 +1,101 @@
1---
2language: Français
3currentMenu: save_article
4subTitle: Sauvegarder son premier article
5---
6
7# Sauvegarder son premier article
8
9Une fois connecté sur wallabag, vous avez plusieurs moyens pour sauvegarder un article.
10
11## Depuis l'application web
12
13Voyons d'abord comment faire depuis l'application web. Dans le menu, vous avez un lien **Sauvegarder un lien**. En cliquant dessus, un formulaire s'affiche : vous n'avez qu'à saisir l'adresse internet de l'article concerné.
14
15Validez et le contenu de l'article est enregistré.
16
17Par défaut, seul le texte est sauvegardé. Si vous souhaitez également conserver une copie des images sur votre serveur, il faut activer le paramètre `DOWNLOAD_PICTURES`. Lisez le chapitre [Les options cachées](../Administrateur/Options_cachees.md) pour en savoir plus.
18
19## Depuis le bookmarklet
20
21[Définition Wikipedia](http://fr.wikipedia.org/wiki/Bookmarklet)
22
23 Un bookmarklet est un petit programme JavaScript pouvant être stocké :
24 * soit en tant qu'URL dans un signet (marque-page ou lien favori) avec la plupart des navigateurs Web ;
25 * soit en tant qu'hyperlien dans une page web.
26
27Depuis le menu de wallabag, cliquez sur **configuration**. Dans la première partie de cette page, nous avons listé les différents moyens de sauvegarder un article. Vous trouverez ainsi le bookmarklet (c'est le lien `bag it !`) à glisser / déposer dans la barre de favoris de votre navigateur.
28
29Dorénavant, lorsque vous souhaitez sauvegarder un article sur lequel vous êtes en train de surfer, vous n'avez qu'à cliquer sur ce bookmarklet et l'article sera automatiquement enregistré.
30
31## Depuis son smartphone
32### Avant toute chose
33
34Pour pouvoir utiliser une application smartphone, vous devez activer les flux RSS depuis la partie **configuration** de wallabag. Certaines informations seront ainsi affichées, comme votre **token** (jeton de sécurité). Lisez le chapitre [Flux RSS](Flux_RSS.md) pour en savoir plus.
35
36### Android
37#### Installation et configuration
38
39Vous pouvez télécharger l'application Android depuis le [Google Play Store](https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche) et depuis [F-droid](https://f-droid.org/app/fr.gaulupeau.apps.InThePoche). C'est exactement la même application sur ces deux plateformes de téléchargement.
40
41Une fois installée, démarrez l'application, rendez-vous dans la partie **settings** et renseignez les champs **URL** (Adresse complète de votre installation de wallabag ou de votre compte Framabag), **User ID** (très souvent, il vous faudra mettre 1 comme valeur). Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et **Token** (recopiez bien tous les caractères du token, disponible dans la **configuration** de wallabag).
42
43#### Sauvegarde d'un article
44
45Maintenant que tout est bien configuré, dès que vous naviguerez avec le navigateur de votre smartphone, vous pourrez à tout moment partager un article dans wallabag depuis le menu **Partager** : vous trouverez une entrée **Bag it!** qui ajoutera l'article dans wallabag.
46
47#### Lecture
48
49Lorsque vous ouvrez l'application, cliquez sur **Synchronize** : vos articles dernièrement sauvegardés seront ainsi téléchargés sur votre smartphone.
50
51Vous n'avez maintenant plus besoin de connexion internet : cliquez sur le bouton **List articles** pour commencer votre lecture.
52
53En bas de chaque article, un bouton **Mark as read** vous permet d'archiver l'article.
54
55Aujourd'hui, la synchronisation ne s'effectue que dans un sens (de wallabag vers l'application), ce qui empêche de marquer comme lu un article sur wallabag depuis votre smartphone.
56
57### iOS
58#### Installation et configuration
59TODO
60
61#### Utilisation
62TODO
63
64### Windows Phone
65#### Installation et configuration
66
67Vous pouvez télécharger l'application Windows Phone depuis le [Windows Store](http://www.windowsphone.com/fr-fr/store/app/wallabag/ff890514-348c-4d0b-9b43-153fff3f7450) ou directement dans le Store de votre smartphone.
68
69Une fois installée, l'application affichera une notification au premier lancement, demandant la configuration du serveur wallabag. Rendez-vous dans la partie **Configuration** de l'application en appuyant sur les 3 petits points du menu en bas de l'écran, puis renseignez les champs **URL** (Adresse complète de votre installation de wallabag ou de votre compte Framabag), **User ID** (très souvent, il vous faudra mettre 1 comme valeur).
70Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et **Token** (recopiez bien tous les caractères du token, disponible dans la **configuration** de wallabag).
71Enfin, sauvegardez les paramètres entrés.
72
73## Depuis son navigateur
74### Extension Firefox classique
75
76Téléchargez l'extension Firefox [sur le site addons.mozilla.org](https://addons.mozilla.org/firefox/addon/wallabag/) et installez-la comme toute autre extension Firefox.
77
78Dans les préférences de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.
79
80Personnalisez la barre d'outils de Firefox pour ajouter wallabag (icône `w`). Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une nouvelle fenêtre s'ouvrira pour ajouter l'article et elle se refermera automatiquement.
81
82### Extension Mozilla Services (Social API)
83
84*Disponible uniquement à compter de wallabag 1.9.1*
85
86Avec les versions 29 et supérieures de Firefox, votre navigateur possède une interface intégrée permettant le partage direct vers de multiples réseaux sociaux. Dans l'interface de Firefox, elle est symbolisée par un icône en forme d'avion en papier que vous pourrez utiliser pour partager une page, ce qui signifie ici enregistrer un article dans wallabag.
87Vous pouvez ajouter ce service depuis la page de configuration de wallabag en cliquant sur Extension Mozilla Services (Social API). Vous devez aussi accepter l'utilisation des Services Firefox.
88
89### Chrome
90
91Téléchargez l'extension Chrome [sur le site dédié](https://chrome.google.com/webstore/detail/wallabag/bepdcjnnkglfjehplaogpoonpffbdcdj) et installez-la comme toute autre extension Chrome.
92
93Dans les options de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.
94
95Lors de l'installation de l'extension, une nouvelle icône est apparue dans la barre d'outils de Chrome, une icône `w`. Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une popup s'ouvrira et vous confirmera que l'article a bien été sauvegardé.
96
97### Opera
98
99Les dernières versions d'Opera (15+) permettent d'installer des extensions compatibles avec Chrome.
100
101Il faut tout d'abord installer l'extension [Download Chrome Extensions](https://addons.opera.com/en/extensions/details/download-chrome-extension-9/) pour installer des extensions à partir du Chrome Web Store. Ensuite, on peut se rendre [sur le site de Google](https://chrome.google.com/webstore/detail/wallabag/bepdcjnnkglfjehplaogpoonpffbdcdj) et récupérer l'extension Chrome en cliquant sur *Add to Opera*. Vous obtiendrez un message qui vous invitera à confirmer l'action car l'extension ne provient pas d'une source approuvée. Le comportement sera ensuite le même que pour Chrome (ci-dessus).
diff --git a/docs/fr/Utilisateur/Un_article_est_mal_affiche.md b/docs/fr/Utilisateur/Un_article_est_mal_affiche.md
new file mode 100644
index 00000000..70b70cd4
--- /dev/null
+++ b/docs/fr/Utilisateur/Un_article_est_mal_affiche.md
@@ -0,0 +1,32 @@
1---
2language: Français
3currentMenu: issue
4subTitle: Mon article s'affiche mal dans wallabag
5---
6
7# Mon article s'affiche mal dans wallabag
8
9Si vous pensez que wallabag récupère mal le contenu d'un article (texte absent ou incomplet), nous vous proposons plusieurs possibilités.
10
11## Demande d'aide
12
13Que ça soit par mail ou via un ticket, n'oubliez pas de nous donner certaines informations qui sont importantes pour que nous puissions résoudre le problème au mieux :
14
15* l'URL de l'article concerné
16* ce que wallabag affiche
17* ce à quoi vous vous attendiez
18* la version de wallabag ou alors si vous utilisez Framabag
19
20### Ouvrir un ticket sur github
21
22Pour ouvrir un nouveau ticket, il faut [aller sur github](https://github.com/wallabag/wallabag/issues/new). Un compte est nécessaire.
23N'oubliez pas de nous envoyer les informations ci-dessus.
24
25### Nous envoyer un email
26
27Envoyez-nous un lien à l'adresse [hello@wallabag.org](mailto:hello@wallabag.org?subject=Mauvais%20affichage%20dans%20wallabag).
28N'oubliez pas de nous envoyer les informations ci-dessus.
29
30## Résoudre ce problème d'affichage
31
32TODO \ No newline at end of file
diff --git a/docs/fr/conf.py b/docs/fr/conf.py
new file mode 100644
index 00000000..5c3657c0
--- /dev/null
+++ b/docs/fr/conf.py
@@ -0,0 +1,87 @@
1# -*- coding: utf-8 -*-
2#
3# wallabag documentation build configuration file, created by
4# sphinx-quickstart on Fri Oct 16 06:47:23 2015.
5
6import sys
7import os
8
9extensions = []
10templates_path = ['_templates']
11source_suffix = '.rst'
12master_doc = 'index'
13project = u'wallabag-fr'
14copyright = u'2013-2015, Nicolas Lœuillet - MIT Licence'
15version = '2.0.0'
16release = version
17exclude_patterns = ['_build']
18pygments_style = 'sphinx'
19html_theme = 'default'
20html_static_path = ['_static']
21htmlhelp_basename = 'wallabagfrdoc'
22
23latex_elements = {
24}
25
26latex_documents = [
27 ('index', 'wallabag-fr.tex', u'wallabag Documentation',
28 u'Nicolas Lœuillet', 'manual'),
29]
30
31man_pages = [
32 ('index', 'wallabagfr', u'wallabag Documentation',
33 [u'Nicolas Lœuillet'], 1)
34]
35
36texinfo_documents = [
37 ('index', 'wallabagfr', u'wallabag Documentation',
38 u'Nicolas Lœuillet', 'wallabagfr', 'One line description of project.',
39 'Miscellaneous'),
40]
41
42##### Guzzle sphinx theme
43
44import guzzle_sphinx_theme
45html_translator_class = 'guzzle_sphinx_theme.HTMLTranslator'
46html_theme_path = guzzle_sphinx_theme.html_theme_path()
47html_theme = 'guzzle_sphinx_theme'
48
49# Custom sidebar templates, maps document names to template names.
50html_sidebars = {
51 '**': ['logo-text.html', 'globaltoc.html', 'searchbox.html']
52}
53
54# Register the theme as an extension to generate a sitemap.xml
55extensions.append("guzzle_sphinx_theme")
56
57# Guzzle theme options (see theme.conf for more information)
58html_theme_options = {
59
60 # Set the path to a special layout to include for the homepage
61 # "index_template": "homepage.html",
62
63 # Allow a separate homepage from the master_doc
64 # homepage = index
65
66 # Set the name of the project to appear in the nav menu
67 # "project_nav_name": "Guzzle",
68
69 # Set your Disqus short name to enable comments
70 # "disqus_comments_shortname": "my_disqus_comments_short_name",
71
72 # Set you GA account ID to enable tracking
73 # "google_analytics_account": "my_ga_account",
74
75 # Path to a touch icon
76 # "touch_icon": "",
77
78 # Specify a base_url used to generate sitemap.xml links. If not
79 # specified, then no sitemap will be built.
80 #"base_url": "http://guzzlephp.org"
81
82 # Allow the "Table of Contents" page to be defined separately from "master_doc"
83 # tocpage = Contents
84
85 # Allow the project link to be overriden to a custom URL.
86 # projectlink = http://myproject.url
87}
diff --git a/docs/fr/index.rst b/docs/fr/index.rst
new file mode 100644
index 00000000..c48bd7f2
--- /dev/null
+++ b/docs/fr/index.rst
@@ -0,0 +1,29 @@
1Documentation de wallabag
2=========================
3
4**wallabag** est une application de lecture différée : elle permet
5simplement d’archiver une page web en ne conservant que le contenu. Les
6éléments superflus (menu, publicité, etc.) sont supprimés.
7
8Principales fonctionnalités
9---------------------------
10
11- tout le contenu est archivé : le texte et les photos
12- l’application web est entièrement responsive
13- vous pouvez convertir vos articles au format ePub pour les charger
14 sur votre liseuse
15- des applications smartphones vous permettent de lire vos articles
16 tout en étant déconnecté
17- des extensions pour votre navigateur vous permettent d'archiver
18 rapidement un nouvel article
19- plusieurs thèmes graphiques vous permettent d'habiller votre
20 wallabag comme vous le souhaitez
21- et forcément plein d’autres fonctionnalités !
22
23Cette documentation est justement là pour faire découvrir toutes les
24possibilités de wallabag. C’est parti !
25
26.. toctree::
27 :maxdepth: 2
28
29 index
diff --git a/docs/fr/requirements.txt b/docs/fr/requirements.txt
new file mode 100644
index 00000000..06fc8973
--- /dev/null
+++ b/docs/fr/requirements.txt
@@ -0,0 +1,2 @@
1Sphinx>=1.3.0,<1.4.0
2guzzle_sphinx_theme>=0.7.0,<0.8.0