From 59e91bc8931a386974a3817e9849aad1ca7fc186 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 21 Oct 2015 14:14:51 +0200 Subject: add docs --- .../fr/Developpeur/Ecrire_fichier_configuration.md | 39 ++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 docs/fr/Developpeur/Ecrire_fichier_configuration.md (limited to 'docs/fr/Developpeur/Ecrire_fichier_configuration.md') 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 @@ +--- +language: Français +currentMenu: site_config +subTitle: Écrire un fichier de configuration +--- + +# Écrire un fichier de configuration + +wallabag 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). + +Le 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. + +## Génération automatique de fichiers de configuration + +@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. + +![siteconfig](https://lut.im/RNaO7gGe/l9vRnO1b) + +Vous devez confirmer cette zone en essayant avec d'autres articles. +Quand 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. + +## Génération manuelle de fichiers de configuration + +Si 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. + +Une fois que vous avez obtenu l'attribut `id` ou `class`, vous pouvez écrire par exemple l'une ou l'autre de ces lignes : + +``` +body: //div[@class='myclass'] +body: //div[@id='myid'] +``` + +Ensuite, 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) : + +``` +strip: //div[@class='hidden'] +``` + +Vous 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). -- cgit v1.2.3