Merge pull request #1549 from FreshRSS/dev1.7.0

Version 1.7.0

8 files changed, 487 insertions, 0 deletions

diff --git a/docs/fr/users/01_Installation.md b/docs/fr/users/01_Installation.md
new file mode 100644
index 000000000..86daa636a
--- /dev/null
+++ b/docs/fr/users/01_Installation.md
@@ -0,0 +1,94 @@
+# Les pré-requis sur le serveur
+
+FreshRSS est un logiciel développé en PHP reposant sur le modèle client - serveur. C'est-à-dire qu'il vous faudra un serveur web pour en profiter. Ensuite, FreshRSS ne demande pas une configuration très fournie et peut donc, en théorie, tourner sur la plupart des serveurs mutualisés.
+
+Il est toutefois de votre responsabilité de vérifier que votre hébergement permettra de faire tourner FreshRSS avant de nous taper dessus. Dans le cas où les informations listées ci-dessous ne seraient pas à jour, vous pourrez.
+
+ | Logiciel         | Recommandé                                                                                                     | Fonctionne aussi avec          |
+ | --------         | -----------                                                                                                    | ---------------------          |
+ | Serveur web      | **Apache 2**                                                                                                   | Nginx                          |
+ | PHP              | **PHP 5.3.7+**                                                                                                 | PHP 5.2+                       |
+ | Modules PHP      | Requis : libxml, cURL, PDO_MySQL, PCRE et ctype \\ Requis (32 bits seulement) : GMP \\ Recommandé : JSON, Zlib, mbstring et iconv, ZipArchive |                                |
+ | Base de données  | **MySQL 5.0.3+**                                                                                               | SQLite 3.7.4+                  |
+ | Navigateur       | **Firefox**                                                                                                    | Chrome, Opera, Safari or IE 9+ |
+
+## Note importante
+
+FreshRSS **PEUT** fonctionner sur la version de PHP 5.3.3. En effet, nous utilisons des fonctions spécifiques pour la connexion par formulaire et notamment la bibliothèque ''password_compat''. Celle-ci est compatible avec PHP >= 5.3.7 ou certaines versions plus anciennes incluant un patch spécifique. Cela dépend de la distribution :
+
+*  CentOS et la Red Hat Enterprise Linux 6.5 sont supportés.
+*  En revanche, **Debian avec PHP 5.3.3 n'est pas supporté !** ([Plus d'informations](https://github.com/ircmaxell/password_compat#requirements))
+
+# Choisir la bonne version de FreshRSS
+
+FreshRSS possède trois versions différentes (nous parlons de branches) qui sortent à des fréquences plus ou moins rapides. Aussi prenez le temps de comprendre à quoi correspond chacune de ces versions.
+
+## La version stable
+
+[Téléchargement](https://github.com/FreshRSS/FreshRSS/archive/master.zip)
+
+Cette version sort lorsqu'on considère qu'on a répondu à nos objectifs en terme de nouvelles fonctionnalités. Deux versions peuvent ainsi sortir de façon très rapprochée si les développeurs travaillent bien. En pratique, comme nous nous fixons de nombreux objectifs et que nous travaillons sur notre temps libre, les versions sont souvent assez espacées (plusieurs mois). Son avantage est que le code est particulièrement stable et vous ne devriez pas faire face à de méchants bugs.
+
+## La version de développement
+
+[Téléchargement](https://github.com/FreshRSS/FreshRSS/archive/dev.zip)
+
+Comme son nom l'indique, il s'agit de la version sur laquelle les développeurs travaillent. **Elle est donc totalement instable !** Si vous souhaitez recevoir les améliorations au jour le jour, vous pouvez l'utiliser, mais attention à bien suivre les évolutions sur Github (via [le flux RSS de la branche](https://github.com/FreshRSS/FreshRSS/commits/dev.atom) par exemple). On raconte que les développeurs principaux l'utilisent quotidiennement sans avoir de soucis. Sans doute savent-ils ce qu'ils font…
+
+# Installation sur Apache
+
+**TODO**
+
+Cette partie n'a pas encore été écrite. Néanmoins, comme il s'agit d'une bête application PHP, cela ne pose généralement pas de soucis à installer :)
+
+# Installation sur Nginx
+
+Voici un fichier de configuration pour nginx. Il couvre la configuration pour http, https et php.
+
+_Vous pourrez trouver d'autres fichiers de configuration plus simples mais ces derniers ne seront peut-être pas compatibles avec l'API FreshRSS._
+
+```
+server {
+  listen 80; # http sur le port 80
+  listen 443 ssl; # https sur le port 443
+
+  # configuration https 
+  ssl on;
+  ssl_certificate      /etc/nginx/server.crt;
+  ssl_certificate_key  /etc/nginx/server.key;
+
+  # l'url ou les urls de votre serveur
+  server_name example.com rss.example.com;
+
+  # le répertoire où se trouve le dossier p de FreshRSS
+  root /srv/FreshRSS/p/;
+
+  index index.php index.html index.htm;
+
+  # les fichiers de log nginx
+  access_log /var/log/nginx/rss.access.log;
+  error_log /var/log/nginx/rss.error.log;
+
+  # gestion des fichiers php
+  # il est nécessaire d'utiliser cette expression régulière pour le bon fonctionnement de l'API 
+  location ~ ^.+?\.php(/.*)?$ {
+    fastcgi_pass unix:/var/run/php5-fpm.sock;
+    fastcgi_split_path_info ^(.+\.php)(/.*)$;
+    # Par défaut la variable PATH_INFO n'est pas définie sous PHP-FPM
+    # or l'API FreshRSS greader.php en a besoin. Si vous avez un "Bad Request", vérifiez bien cette dernière !
+    fastcgi_param PATH_INFO $fastcgi_path_info;
+    include fastcgi_params;
+    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+  }
+  
+  location / {
+    try_files $uri $uri/ index.php;
+  }
+}
+```
+
+Pour un tutoriel pas à pas, vous pouvez suivre [cet article dédié](http://www.pihomeserver.fr/2013/05/08/raspberry-pi-home-server-installer-un-agregateur-de-flux-rss-pour-remplacer-google-reader/).
+
+# Conseils de sécurité
+
+**TODO**
diff --git a/docs/fr/users/02_First_steps.md b/docs/fr/users/02_First_steps.md
new file mode 100644
index 000000000..589453f28
--- /dev/null
+++ b/docs/fr/users/02_First_steps.md
@@ -0,0 +1,25 @@
+Découvrir un nouveau logiciel n'est pas toujours facile. Si nous avons voulu FreshRSS le plus intuitif possible, vous aurez peut-être besoin d'un coup de main pour le maîtriser.
+
+Cette section se propose de vous aider dans la prise en main de l'outil. Il ne s'agit que de liens menant vers les autres pages de la documentation mais ordonnées dans un ordre spécifique aux nouveaux arrivants.
+
+[Après l'installation](01_Installation.md), la première chose à faire est d'ajouter un ou plusieurs sites à suivre. Pour cela plusieurs choix s'offrent à vous :
+
+ 1.  [Ajouter un flux manuellement](04_Subscriptions.md#ajouter-un-flux)
+ 2.  [Importer un fichier OPML ou JSON](04_Subscriptions.md#import-et-export)
+ 3.  [Utiliser le bookmark dédié](04_Subscriptions.md#utiliser-le-bookmark)
+
+Une fois que vous avez ajouté vos flux à FreshRSS, il est temps de les lire. Pour cela, trois modes de lecture s'offrent à vous :
+
+ 1.  [La vue normale](03_Main_view.md#la-vue-normale) qui permet de voir et de lire rapidement les nouveaux articles
+ 2.  [La vue globale](03_Main_view.md#la-vue-globale) est destinée à vous offrir un panorama de l'état de vos flux
+ 3.  [La vue lecture](03_Main_view.md#la-vue-lecture) est pensée pour vous offrir un meilleur confort de lecture
+
+Bien, vous maitrisez maintenant la vue que vous préférez ? Il est temps de vous offrir un peu plus de confort de lecture. FreshRSS est grandement configurable et c'est à vous de trouver la configuration qui vous conviendra le plus. Voici tout de même quelques pistes pour améliorer votre quotidien sur FreshRSS :
+
+* [Rangez vos flux dans des catégories](04_Subscriptions.md#organisation_des_flux)
+* [Configurez votre page d'accueil](05_Configuration.md#personnaliser-la-vue)
+* [Configurez vos options de lecture](05_Configuration.md#options-de-lecture)
+* [Mettez à jour vos flux](03_Main_view.md#rafraichir-les-flux)
+* [Filtrez les articles](03_Main_view.md#filtrer-les-articles) pour accéder rapidement à ceux que vous voulez lire en priorité
+* [Retrouvez un article](03_Main_view.md#rechercher-des-articles) qui a été publié il y a quelques jours ou mois
+* [Accédez à vos flux même sur mobile](06_Mobile_access.md)
diff --git a/docs/fr/users/03_Main_view.md b/docs/fr/users/03_Main_view.md
new file mode 100644
index 000000000..744141b7d
--- /dev/null
+++ b/docs/fr/users/03_Main_view.md
@@ -0,0 +1,183 @@
+# La vue normale
+
+**TODO**
+
+# La vue globale
+
+**TODO**
+
+# La vue lecture
+
+**TODO**
+
+# Rafraîchir les flux
+
+Pour profiter pleinement de FreshRSS, il faut qu’il récupère les nouveaux articles disponibles des flux auxquels vous avez souscrit. Pour cela, il existe plusieurs méthodes.
+
+## Mise à jour automatique
+
+C’est la méthode recommandée car il n’y a pas besoin d’y penser, elle se fait toute seule, à la fréquence que vous avez choisi.
+
+### Par le script actualize_script.php
+
+Cette méthode n’est possible que si vous avez accès aux tâches planifiées de la machine sur laquelle est installée votre instance de FreshRSS.
+
+Le script qui permet de mettre à jour les articles s’appelle *actualize_script.php* et se trouve dans le répertoire *app* de votre instance de FreshRSS. La syntaxe des tâches planifiées ne sera pas expliqué ici, cependant voici [une introduction rapide à crontab](http://www.adminschoice.com/crontab-quick-reference/) qui peut vous aider.
+
+Ci-dessous vous trouverez un exemple permettant la mise à jour des articles toutes les heures.
+
+```cron
+0 * * * * php /chemin/vers/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log 2>&1
+```
+
+
+### Cron en-ligne
+
+Il se peut que vous n’ayez pas accès aux tâches planifiées du serveur hébergeant votre instance de FreshRSS. Il reste une possibilité pour mettre les flux à jour automatiquement.
+
+Pour cela vous devez paramétrer une tâche cron qui devra charger régulièrement une url spécifique : https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize (à adapter selon votre installation). Différents cas de figure peuvent se présenter à vous désormais.
+
+##### Aucune authentification
+
+C’est le cas le plus simple, puisque votre instance est publique, vous n’avez rien de particulier à préciser :
+
+```cron
+0 * * * * curl 'https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize'
+```
+
+##### Authentification par formulaire ou Persona
+
+Dans ces cas-là, si vous avez autorisé la lecture anonyme des articles, vous pouvez aussi permettre à n’importe qui de rafraîchir vos flux (« Autoriser le rafraîchissement anonyme des flux »).
+
+![Configuration de l’accès anonymes](../img/users/anonymous_access.1.png)
+
+L’url précédente devient donc accessible à n’importe qui et vous pouvez utiliser la tâche cron de la partie précédente.
+
+Vous pouvez aussi configurer un jeton d’authentification pour accorder un droit spécial sur votre serveur.
+
+![Configuration du token](../img/users/token.1.png)
+
+La tâche cron à utiliser sera de la forme suivante :
+
+```cron
+0 * * * * curl 'https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize&token=mon-token'
+```
+
+
+##### Authentification HTTP
+
+Dans ce cas-là, le token et les permissions “anonymes” sont inutilisables et il vous sera nécessaire d’indiquer vos identifiants dans la tâche cron. **Notez que cette solution est grandement déconseillée puisqu’elle implique que vos identifiants seront visibles en clair !**
+
+```cron
+0 * * * * curl -u alice:password123 'https://votre.serveur.net/FreshRSS/p/i/?c=feed&a=actualize'
+```
+
+## Mise à jour manuelle
+
+Si vous ne pouvez pas ou ne voulez pas utiliser la méthode automatique, vous pouvez le faire de façon manuelle. Il existe deux méthodes qui permettent de mettre à jour tout ou partie des flux.
+
+### Mise à jour complète
+
+Cette mise à jour se fait pour l’ensemble des flux de l’instance. Pour initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour disponible dans le menu de navigation.
+
+![Menu de navigation](../img/users/refresh.1.png)
+
+Lorsque la mise à jour démarre, une barre de progression apparait et s’actualise au fur et à mesure de la récupération des articles.
+
+![Barre de progression](../img/users/refresh.5.png)
+
+### Mise à jour partielle
+
+Cette mise à jour se fait pour le flux sélectionné uniquement. Pour initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour disponible dans le menu du flux.
+
+![Menu du flux](../img/users/refresh.2.png)
+
+# Filtrer les articles
+
+Avec le nombre croissant d’articles stockés par FreshRSS, il devient important d’avoir des filtres efficaces pour n’afficher qu’une partie des articles. Il existe plusieurs méthodes qui filtrent selon des critères différents. Ces méthodes peuvent être combinées dans la plus part des cas.
+
+##Par catégorie
+
+C’est la méthode la plus simple. Il suffit de cliquer sur le titre d’une catégorie dans le panneau latéral. Il existe deux catégories spéciales qui sont placées en haut dudit panneau :
+
+  * *Flux principal* qui affiche uniquement les articles des flux marqués comme visible dans cette catégorie
+  * *Favoris* qui affiche uniquement les articles, tous flux confondus, marqués comme favoris
+
+##Par flux
+
+Il existe plusieurs méthodes pour filtrer les articles par flux :
+
+  * en cliquant sur le titre du flux dans le panneau latéral
+  * en cliquant sur le titre du flux dans le détail de l’article
+  * en filtrant dans les options du flux dans le panneau latéral
+  * en filtrant dans la configuration du flux
+
+![Filtrer par flux](../img/users/feed.filter.1.png)
+
+##Par statut
+
+Chaque article possède deux attributs qui peuvent être combinés. Le premier attribut indique si l’article a été lu ou non. Le second attribut indique si l’article a été noté comme favori ou non.
+
+Dans la version 0.7.x, les filtres sur les attributs sont accessibles depuis la liste déroulante qui gère l’affichage des articles. Dans cette version, il n’est pas possible de combiner les filtres. Par exemple, on ne peut pas afficher les articles lus qui ont été notés comme favori.
+
+![Filtrer par attribut en version 0.7](../img/users/status.filter.0.7.png)
+
+À partir de la version 0.8, les filtres sur les attributs sont directement accessibles. Il est maintenant possible de les combiner. Comme il est possible de faire toutes les combinaisons, il y en a certaines qui retournent le même résultat. Par exemple, si les quatre filtres sont activés ou désactivés, le résultat sera le même.
+
+![Filtrer par attribut en version 0.8](../img/users/status.filter.0.8.png)
+
+Par défaut, le filtre n’affiche que les articles qui n’ont pas été lus.
+
+##Par contenu
+
+Il est possible de filtrer les articles par leur contenu en entrant une chaine de caractères dans le champ de recherche prévu à cet effet.
+
+##Grâce au champ de recherche
+
+Il est possible d’utiliser le champ de recherche pour raffiner les résultats :
+
+* par auteur : `author:nom` or `author:'nom composé'`
+* par titre : `intitle:mot` or `intitle:'mot composé'`
+* par URL: `inurl:mot` or `inurl:'mot composé'`
+* par tag: `#tag`
+* par texte libre : `mot` or `'mot composé'`
+* par date de découverte, en utilisant le [format d’intervalle de dates ISO 8601](https://fr.wikipedia.org/wiki/ISO_8601#Les_dur.C3.A9es_et_intervalles) : `date:<intervalle>`
+	* D’un jour, mois, ou année :
+		* `date:2014-03-30`
+		* `date:2014-03` or `date:201403`
+		* `date:2014`
+	* D’une heure précise d’un jour donné :
+		* `date:2014-05-30T13`
+		* `date:2014-05-30T13:30`
+	* Entre deux dates :
+		* `date:2014-02/2014-04`
+		* `date:2014-02--2014-04`
+		* `date:2014-02/04`
+		* `date:2014-02-03/05`
+		* `date:2014-02-03T22:00/22:15`
+		* `date:2014-02-03T22:00/15`
+	* Après une date donnée :
+		* `date:2014-03/`
+	* Avant une date donnée :
+		* `date:/2014-03`
+	* Pour une certaine durée après une date donnée :
+		* `date:2014-03/P1W`
+	* Pour une certaine durée avant une date donnée :
+		* `date:P1W/2014-05-25T23:59:59`
+	* Pour une certaine durée avant l’instant présent (la barre oblique est optionnelle) :
+		* `date:P1Y/` ou `date:P1Y` (depuis un an)
+		* `date:P2M/` (depuis deux mois)
+		* `date:P3W/` (depuis trois semaines)
+		* `date:P4D/` (depuis quatre jours)
+		* `date:PT5H/` (depuis cinq heures)
+		* `date:PT30M/` (depuis trente minutes)
+		* `date:PT90S/` (depuis 90 seconds)
+		* `date:P1DT1H/` (depuis un jour et une heure)
+* par date de publication, en utilisant le même format : `pubdate:<intervalle>`
+
+Attention à ne pas introduire d’espace entre l’opérateur et la valeur recherchée.
+
+Certains opérateurs peuvent être utilisé négativement, pour exclure des articles, avec la même syntaxe que ci-dessus, mais préfixé par `!` ou `-` :
+`-author:nom`, `-intitle:mot`, `-inurl:mot`, `-#tag`, `!mot`.
+
+Il est également possible de combiner les mots-clefs pour faire un filtrage encore plus précis, and et il est autorisé d’avoir plusieurs instances de : `author:`, `intitle:`, `inurl:`, `#`, et texte libre.
diff --git a/docs/fr/users/04_Subscriptions.md b/docs/fr/users/04_Subscriptions.md
new file mode 100644
index 000000000..ae4541c29
--- /dev/null
+++ b/docs/fr/users/04_Subscriptions.md
@@ -0,0 +1,15 @@
+# Ajouter un flux
+
+**TODO**
+
+# Import et export
+
+**TODO**
+
+# Utiliser le « bookmark »
+
+**TODO**
+
+# Organisation des flux
+
+**TODO**
diff --git a/docs/fr/users/05_Configuration.md b/docs/fr/users/05_Configuration.md
new file mode 100644
index 000000000..75deff462
--- /dev/null
+++ b/docs/fr/users/05_Configuration.md
@@ -0,0 +1,119 @@
+# Personnaliser la vue
+
+##Langue
+À l'heure actuelle, FreshRSS est disponible en français et en anglais. Après validation de ce choix, la totalité de l'interface sera affichée dans la langue choisie.
+
+Il y a des parties de FreshRSS qui ne sont pas traduites et qui n'ont pas vocation à l'être. Pour le moment, les logs visibles dans l'application ainsi que celle générées par le script de mise à jour automatique en font partie.
+
+##Thème
+Les goûts et les couleurs, ça ne se discute pas. C'est pourquoi FreshRSS propose six thèmes officiels :
+
+ * *Blue Lagoon* par **Mister aiR**
+ * *Dark* par **AD**
+ * *Flat design* par **Marien Fressinaud**
+ * *Origine* par **Marien Fressinaud**
+ * *Pafat* par **Plopoyop**
+ * *Screwdriver* par **Mister aiR**
+
+Si aucun de ceux proposés ne convient, il est toujours possible de créer son propre thème.
+
+Pour sélectionner un thème, il suffit de faire défiler les thèmes jusqu'à l'apparition du thème choisi. Après validation, le thème sera appliqué à l'interface.
+
+##Largeur du contenu
+Il y en a qui préfère des lignes de texte courtes, d'autres qui préfèrent maximiser l'espace disponible sur l'écran. Pour satisfaire le maximum de personne, il est possible de choisir la largeur du contenu affiché. Il y a quatre réglages disponibles :
+
+ * **Fine** qui affiche le contenu jusqu'à 550 pixels
+ * **Moyenne** qui affiche le contenu jusqu'à 800 pixels
+ * **Large** qui affiche le contenu jusqu'à 1000 pixels
+ * **Pas de limite** qui affiche le contenu sur 100% de la place disponible
+
+##Icônes d'article
+
+**TODO**
+
+##Temps d'affichage de la notification HTML5
+Après la mise à jour automatique des flux, FreshRSS utilise l'API de notification de HTML5 pour avertir de l'arrivée de nouveaux articles.
+
+Il est possible de régler la durée d'affichage de cette notification. Par défaut, la valeur est 0.
+
+# Options de lecture
+
+**TODO**
+
+# Archivage
+
+**TODO**
+
+# Partage
+
+**TODO**
+
+# Raccourcis
+
+**TODO**
+
+# Filtres
+
+**TODO**
+
+# Utilisateurs
+
+**TODO**
+
+## Méthodes d'authentification
+
+**Brouillon**
+
+### Authentification HTTP
+
+ 1.  Ne laisse rien de visible
+ 2.  Pour Apache, basé sur un fichier .htaccess
+    - Exemple de .htaccess pour un utilisateur "marie" à placer dans le répertoire de FreshRSS ou dans un répertoire parent :
+
+```
+AuthUserFile /home/marie/repertoire/.htpasswd
+AuthGroupFile /dev/null
+AuthName "Chez Marie"
+AuthType Basic
+Require user marie
+```
+
+Plus d'informations dans [la documentation d'Apache.](http://httpd.apache.org/docs/trunk/howto/auth.html#gettingitworking)
+
+
+# Gestion des flux
+
+## Informations
+
+**TODO**
+
+## Archivage
+
+**TODO**
+
+## Identification
+
+**TODO**
+
+## Avancé
+
+### Récupérer un flux tronqué
+
+La question revient régulièrement, je vais essayer de clarifier ici comment on peut récupérer un flux RSS tronqué avec FreshRSS. Sachez avant tout que la manière de s'y prendre n'est absolument pas "user friendly", mais elle fonctionne :)
+
+Sachez aussi que par cette manière vous générez beaucoup plus de trafic vers les sites d'origines et qu'ils peuvent vous bloquer par conséquent. Les performances de FreshRSS sont aussi moins bonnes car vous devez alors aller chercher le contenu des articles un par un. C'est donc une fonctionnalité à utiliser avec parcimonie !
+
+Ce que j'entends par "Chemin CSS des articles sur le site d’origine" correspond en fait au "chemin" constitué par les IDs et les classes (en html, correspond aux attributs id et class) pour récupérer uniquement la partie intéressante qui correspond à l'article. L'idéal est que ce chemin commence par un id (qui est unique pour la page)
+
+#### Exemple 1 : Rue89
+
+Pour trouver ce chemin, il faut se rendre à l'adresse d'un des articles tronqués (par exemple http://www.rue89.com/2013/10/15/prof-maths-jai-atteint-lextase-dihn-pedagogie-inversee-246635). Il faut alors chercher le "bloc" HTML correspondant au contenu de l'article (dans le code source !)
+
+On trouve ici que le bloc qui englobe uniquement le contenu de l'article est ```<div class="content clearfix">```. On ne va garder que la classe .content ici. Néanmoins, comme je le disais plus haut, il est préférable de commencer le chemin avec un id. Si on remonte au bloc parent, il s'agit du bloc ```<div id="article">``` et c'est parfait ! Le chemin sera donc ```#article .content```
+
+#### Liste de correspondances site -> chemin css
+
+*  Rue89 : ```#article .content```
+*  PCINpact : ```#actu_content```
+*  Lesnumériques : ```article#body div.text.clearfix```
+
diff --git a/docs/fr/users/06_Mobile_access.md b/docs/fr/users/06_Mobile_access.md
new file mode 100644
index 000000000..e1a23c8ba
--- /dev/null
+++ b/docs/fr/users/06_Mobile_access.md
@@ -0,0 +1 @@
+**TODO**
diff --git a/docs/fr/users/07_Frequently_Asked_Questions.md b/docs/fr/users/07_Frequently_Asked_Questions.md
new file mode 100644
index 000000000..9dc80b2e4
--- /dev/null
+++ b/docs/fr/users/07_Frequently_Asked_Questions.md
@@ -0,0 +1,35 @@
+Il est possible que nous n'ayons pas répondu à toutes vos questions dans les parties précédentes. La FAQ regroupe certaines interrogations qui n'ont pas trouvé leur réponse ailleurs.
+
+## C'est quoi ce /i à la fin de l'URL ?
+
+Bien entendu, le ```/i``` n'est pas là pour faire joli ! Il s'agit d'une question de performances et de praticité :
+
+* Cela permet de servir les icônes, images, styles, scripts sans cookie. Sans cela, ces fichiers seraient souvent re-téléchargés, en particulier lorsque Persona ou le formulaire de connexion sont utilisés. De plus, les requêtes vers ces ressources seraient plus lourdes.
+* La racine publique ```./p/``` peut être servie sans restriction d'accès HTTP (qui peut avantageusement être mise en place dans ```./p/i/```).
+* Cela permet d'éviter des problèmes pour des fichiers qui doivent être publics pour bien fonctionner, comme ```favicon.ico```, ```robots.txt```, etc.
+* Cela permet aussi d'avoir un logo FreshRSS plutôt qu'une page blanche pour accueillir l'utilisateur par exemple dans le cas de la restriction d'accès HTTP ou lors de l'attente du chargement plus lourd du reste de l'interface.
+
+## Pourquoi le ```robots.txt``` se trouve dans un sous-répertoire ?
+
+Afin d'améliorer la sécurité, FreshRSS est découpé en deux parties : une partie publique (le répertoire ```./p```) et une partie privée (tout le reste !). Le ```robots.txt``` se trouve donc dans le sous-répertoire ```./p```.
+
+Comme expliqué dans les [conseils de sécurité](01_Installation.md#conseils-de-securite), il est recommandé de faire pointer un nom de domaine vers ce sous-répertoire afin que seule la partie publique ne soit accessible par un navigateur web. De cette manière http://demo.freshrss.org/ pointe vers le répertoire ```./p``` et le ```robots.txt``` se trouve bien à la racine du site : http://demo.freshrss.org/robots.txt.
+
+L'explication est la même pour les fichiers ```favicon.ico``` et ```.htaccess```.
+
+## Pourquoi j'ai des erreurs quand j'essaye d'enregistrer un flux ?
+
+Il peut y avoir différentes origines à ce problème.  
+Le flux peut avoir une syntaxe invalide, il peut ne pas être reconnu par la bibliothèque SimplePie, l'hébergement peut avoir des problèmes, FreshRSS peut être boggué.
+Il faut dans un premier temps déterminer la cause du problème.  
+Voici la liste des étapes à suivre pour la déterminer :
+
+1. __Vérifier la validité du flux__ grâce à l'[outil en ligne du W3C](http://validator.w3.org/feed/ "Validateur en ligne de flux RSS et Atom"). Si ça ne fonctionne pas, nous ne pouvons rien faire.
+1. __Vérifier la reconnaissance par SimplePie__ grâce à l'[outil en ligne de SimplePie](http://simplepie.org/demo/ "Démo officielle de SimplePie"). Si ça ne fonctionne pas, nous ne pouvons rien faire.
+1. __Vérifier l'intégration dans FreshRSS__ grâce à la [démo](http://demo.freshrss.org "Démo officielle de FreshRSS"). Si ça ne fonctionne pas, il faut [créer un ticket sur Github](https://github.com/FreshRSS/FreshRSS/issues/new "Créer un ticket pour FreshRSS") pour que l'on puisse regarder ce qui se passe. Si ça fonctionne, il y a probablement un problème avec l'hébergement.
+
+Voici une liste des flux qui ne fonctionnent pas :
+
+* http://foulab.org/fr/rss/Foulab_News : ne passe pas la validation W3C (novembre 2014)
+* http://eu.battle.net/hearthstone/fr/feed/news : ne passe pas la validation W3C (novembre 2014)
+* http://webseriesmag.blogs.liberation.fr/we/atom.xml : ne fonctionne pas chez l'utilisateur mais passe l'ensemble des validations ci-dessus (novembre 2014)
diff --git a/docs/fr/users/08_PubSubHubbub.md b/docs/fr/users/08_PubSubHubbub.md
new file mode 100644
index 000000000..0f2f14794
--- /dev/null
+++ b/docs/fr/users/08_PubSubHubbub.md
@@ -0,0 +1,15 @@
+# Qu'est-ce que PubSubHubbub ?
+
+Derrière ce nom barbare se cache un protocole qui vient compléter Atom et RSS. En effet, le fonctionnement de base de ces deux derniers implique de vérifier à intervalles réguliers s'il existe de nouveaux articles sur les sites suivis. Cela même si le site concerné n'a rien publié depuis la dernière synchronisation. Le protocole PubSubHubbub permet d'éviter des synchronisations inutiles en notifiant en temps réel l'agrégateur de la présence de nouveaux articles.
+
+# Fonctionnement de PubSubHubbub
+
+On va retrouver trois notions dans PubSubHubbub : les éditeurs (les sites qui publient du contenu), les abonnés (les agrégateurs de flux RSS) et les hubs.
+
+Lorsqu'un agrégateur s'abonne à un site et récupère son flux RSS, il peut y trouver l'adresse d'un hub. Si c'est le cas — car un site peut ne pas en préciser —, l'agrégateur va s'abonner au hub et non pas à l'éditeur directement. Ainsi, lorsqu'un éditeur va publier du contenu, il va notifier le hub qui va lui-même notifier et envoyer le contenu à tous ses abonnés.
+
+Pour pouvoir être notifié, les abonnés doivent fournir une adresse accessible publiquement sur Internet.
+
+# PubSubHubbub et FreshRSS
+
+Depuis la version 1.1.2-beta, FreshRSS supporte officiellement PubSubHubbub. Vous pouvez donc recevoir en temps réel les articles des sites qui affichent dans leur flux RSS un « hub ».