diff options
Diffstat (limited to 'docs/fr')
| -rw-r--r-- | docs/fr/contributing.md | 2 | ||||
| -rw-r--r-- | docs/fr/index.md | 20 | ||||
| -rw-r--r-- | docs/fr/users/03_Main_view.md | 14 | ||||
| -rw-r--r-- | docs/fr/users/04_Subscriptions.md | 8 | ||||
| -rw-r--r-- | docs/fr/users/05_Configuration.md | 19 | ||||
| -rw-r--r-- | docs/fr/users/06_Mobile_access.md | 3 | ||||
| -rw-r--r-- | docs/fr/users/08_PubSubHubbub.md | 23 |
7 files changed, 61 insertions, 28 deletions
diff --git a/docs/fr/contributing.md b/docs/fr/contributing.md index c7ccb4d8a..b74f2e673 100644 --- a/docs/fr/contributing.md +++ b/docs/fr/contributing.md @@ -15,6 +15,6 @@ Vous pouvez notamment regarder [les tickets ouverts avec le tag "Documentation"] ## Contribuer au blog -Vous souhaitez écrire un article à propos des technologies RSS/Atom/PubSubHubbub ou tout simplement nous donner un coup de main à la rédaction d'un billet ? Vous pouvez nous aider ! +Vous souhaitez écrire un article à propos des technologies RSS/Atom/WebSub ou tout simplement nous donner un coup de main à la rédaction d'un billet ? Vous pouvez nous aider ! Pour cela, il suffit de vous rendre sur le dépôt GitHub [FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss.org) et de nous proposer une « Pull Request ». Les articles de blog doivent se trouver dans le répertoire `./blog` et être écrits en Markdown. diff --git a/docs/fr/index.md b/docs/fr/index.md index d43eaec4e..6a9b27cb2 100644 --- a/docs/fr/index.md +++ b/docs/fr/index.md @@ -1,22 +1,24 @@  -FreshRSS est un agrégateur et lecteur de flux RSS. Il permet de regrouper l'actualité de plusieurs sites différents dans un endroit unique pour que vous puissiez la lire sans devoir aller de site en site. +FreshRSS est un agrégateur et lecteur de flux RSS. Il permet de regrouper l’actualité de plusieurs sites différents dans un endroit unique pour que vous puissiez la lire sans devoir aller de site en site. FreshRSS a été conçu comme un agrégateur puissant et propose des tas de fonctionnalités : - Agrégation des flux RSS et Atom. - Utilisez les favoris pour marquer les articles qui vous ont plu ou que vous souhaitez lire plus tard. - Le système de filtrage et de recherche permettent de cibler exactement les articles que vous souhaitez lire. -- Les statistiques permettent de savoir en un coup d'œil quels sont les sites qui publient le plus, ou à l'inverse, le moins. +- Les statistiques permettent de savoir en un coup d’œil quels sont les sites qui publient le plus, ou à l’inverse, le moins. - Importation / exportation des flux au format OPML. -- Multi-thèmes pour changer l'habillage de FreshRSS. -- « *Responsive design* » : l'application s'adapte aux petits écrans pour emporter FreshRSS dans votre poche. +- Multi-thèmes pour changer l’habillage de FreshRSS. +- « *Responsive design* » : l’application s’adapte aux petits écrans pour emporter FreshRSS dans votre poche. - Multi-utilisateurs pour héberger plusieurs personnes sur une même installation. - API Google Reader pour pouvoir y brancher des applications Android. -- Auto-hébergeable : le code source est libre (AGPL3) et vous pouvez donc l'héberger sur votre propre serveur. -- Et bien d'autres ! +- Auto-hébergeable : le code source est libre (AGPL3) et vous pouvez donc l’héberger sur votre propre serveur. +- Et bien d’autres ! -Cette documentation est partagée en deux parties : +Cette documentation est divisée en plusieurs parties : -- La [documentation utilisateurs](users/02_First_steps.md) pour découvrir plus en profondeur les fonctionnalités de FreshRSS. -- La [documentation développeurs](developers/01_First_steps.md) pour savoir comment contribuer et mieux comprendre le code source de FreshRSS. +* La [documentation utilisateurs](./users/02_First_steps.md) pour découvrir les fonctionnalités de FreshRSS. +* La [documentation administrateurs](./users/01_Installation.md) pour l’installation et la maintenance de FreshRSS. +* La [documentation développeurs](./developers/01_First_steps.md) pour savoir comment contribuer et mieux comprendre le code source de FreshRSS. +* Le [guide de contribution](./contributing.md) pour nous aider à développer FreshRSS. diff --git a/docs/fr/users/03_Main_view.md b/docs/fr/users/03_Main_view.md index af3a5a1db..8382340c5 100644 --- a/docs/fr/users/03_Main_view.md +++ b/docs/fr/users/03_Main_view.md @@ -35,14 +35,20 @@ Ci-dessous vous trouverez un exemple permettant la mise à jour des articles tou 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. +Pour cela vous devez paramétrer une tâche cron qui devra charger régulièrement une url spécifique : https://freshrss.example.net/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' +0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize' +``` + +Vous pouvez également choisir un utilisateur différent en ajoutant son nom d'utilisateur à la chaîne de requête, avec `&user=nom-dutilisateur` : + +```cron +0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&user=someone&token=my-token' ``` ##### Authentification par formulaire @@ -60,7 +66,7 @@ Vous pouvez aussi configurer un jeton d’authentification pour accorder un droi 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' +0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=mon-token' ``` @@ -69,7 +75,7 @@ La tâche cron à utiliser sera de la forme suivante : 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' +0 * * * * curl -u alice:password123 'https://freshrss.example.net/i/?c=feed&a=actualize' ``` ## Mise à jour manuelle diff --git a/docs/fr/users/04_Subscriptions.md b/docs/fr/users/04_Subscriptions.md index ae4541c29..0f8389462 100644 --- a/docs/fr/users/04_Subscriptions.md +++ b/docs/fr/users/04_Subscriptions.md @@ -6,9 +6,13 @@ **TODO** -# Utiliser le « bookmark » +# Utiliser le « bookmarklet » -**TODO** +Les « bookmarklets » sont de petits scripts que vous pouvez exécuter pour effectuer des tâches utiles ou frivoles. FreshRSS offre un signet ( « bookmark » ) pour s'abonner aux fils de nouvelles. + + 1. Ouvrez "Gestion des abonnements". + 2. Cliquez sur "Outils d'abonnement". + 3. Glissez le bouton "S'abonner" dans la barre d'outils des signets ou cliquez droit et choisissez l'action "Lien vers les signets" de votre navigateur. # Organisation des flux diff --git a/docs/fr/users/05_Configuration.md b/docs/fr/users/05_Configuration.md index 75deff462..b1bda9043 100644 --- a/docs/fr/users/05_Configuration.md +++ b/docs/fr/users/05_Configuration.md @@ -1,21 +1,25 @@ # 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. +À l'heure actuelle, FreshRSS est disponible en 13 langues. Après validation de ce choix, l'interface sera affichée dans la langue choisie, même si certaines parties de l'interface peuvent ne pas encore avoir été traduites. Si vous voulez aider à la traduction, regardez comment vous pouvez [contribuer au projet](../contributing.md#contribute-to-internationalization-i18n). 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. +Les langues disponibles sont : cz, de, en, es, fr, he, it, kr, nl, oc, pt-br, ru, tr, zh-cn. + ##Thème -Les goûts et les couleurs, ça ne se discute pas. C'est pourquoi FreshRSS propose six thèmes officiels : +Les goûts et les couleurs, ça ne se discute pas. C'est pourquoi FreshRSS propose huit thèmes officiels : * *Blue Lagoon* par **Mister aiR** * *Dark* par **AD** * *Flat design* par **Marien Fressinaud** * *Origine* par **Marien Fressinaud** + * *Origine-compact* par **Kevin Papst** * *Pafat* par **Plopoyop** * *Screwdriver* par **Mister aiR** + * *Swage* par **Patrick Crandol** -Si aucun de ceux proposés ne convient, il est toujours possible de créer son propre thème. +Si aucun de ceux proposés ne convient, il est toujours possible de [créer son propre thème](../developers/04_Frontend/02_Design.md). 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. @@ -97,7 +101,7 @@ Plus d'informations dans [la documentation d'Apache.](http://httpd.apache.org/do ## Avancé -### Récupérer un flux tronqué +### Récupérer un flux tronqué à partir de FreshRSS 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 :) @@ -116,4 +120,11 @@ On trouve ici que le bloc qui englobe uniquement le contenu de l'article est ``` * Rue89 : ```#article .content``` * PCINpact : ```#actu_content``` * Lesnumériques : ```article#body div.text.clearfix``` +* Phoronix : ```#main .content``` + +### Récupérer un flux tronqué à l'aide d'outils externes + +Des outils complémentaires peuvent être utilisés pour récupérer le contenu complet d'un article, comme : +* [RSS-Bridge](https://github.com/RSS-Bridge/rss-bridge) +* [Full-Text RSS](https://bitbucket.org/fivefilters/full-text-rss) diff --git a/docs/fr/users/06_Mobile_access.md b/docs/fr/users/06_Mobile_access.md index 6981a74a6..6f7d92ade 100644 --- a/docs/fr/users/06_Mobile_access.md +++ b/docs/fr/users/06_Mobile_access.md @@ -67,7 +67,8 @@ Tout client supportant une API de type Google Reader. Sélection : * [EasyRSS](https://github.com/Alkarex/EasyRSS) (Libre, F-Droid) * Linux * [FeedReader 2.0+](https://jangernert.github.io/FeedReader/) (Libre) - +* MacOS + * [Vienna RSS](http://www.vienna-rss.com/) (Libre) # API compatible Google Reader diff --git a/docs/fr/users/08_PubSubHubbub.md b/docs/fr/users/08_PubSubHubbub.md index 0f2f14794..6e220b25b 100644 --- a/docs/fr/users/08_PubSubHubbub.md +++ b/docs/fr/users/08_PubSubHubbub.md @@ -1,15 +1,24 @@ -# Qu'est-ce que PubSubHubbub ? +# Qu’est-ce que [WebSub](https://www.w3.org/TR/websub/) ? -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. +Derrière ce nom (anciennement [PubSubHubbub](https://github.com/pubsubhubbub/PubSubHubbub)) 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 WebSub](https://www.w3.org/TR/websub/) 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 +# Fonctionnement de WebSub -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. +On va retrouver trois notions dans WebSub : 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. +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 +# WebSub 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 ». +Depuis la version 1.1.2-beta, FreshRSS supporte officiellement WebSub. +Vous pouvez donc recevoir en temps réel les articles des sites qui affichent dans leur flux RSS un « hub », +tels [Mastodon](https://joinmastodon.org), [Friendica](https://friendi.ca), WordPress (WordPress.com ou avec [une extension](https://wordpress.org/plugins/pubsubhubbub/)), Blogger, FeedBurner, Slashdot, etc. + +Vous pouvez tester avec http://push-pub.appspot.com. |