docs/fr/Developpeur/ecrire_fichier_configuration.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="utf-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">

        <title>wallabag - Écrire un fichier de configuration</title>

        <link rel="stylesheet" href="http://doc.wallabag.org/css/bootstrap.min.css">
        <link rel="stylesheet" href="http://doc.wallabag.org/css/font-awesome.min.css">
        <link rel="stylesheet" href="http://doc.wallabag.org/css/highlight.tomorrow-night.css">
        <link rel="stylesheet" href="http://doc.wallabag.org/css/main.css">
    </head>
    <body>

        <header class="navbar navbar-default navbar-fixed-top">

            <a class="navbar-brand" href="http://doc.wallabag.org/">
                wallabag
                <small class="hidden-xs hidden-sm">
                    Écrire un fichier de configuration
                </small>
            </a>
            <a href="http://doc.wallabag.org/en">EN</a> - <a href="http://doc.wallabag.org/fr">FR</a> - <a href="http://doc.wallabag.org/de">DE</a> - <a href="http://doc.wallabag.org/ru">RU</a>

            
        </header>

        <main class="container-fluid">
            <div class="row">

                
                    <nav id="sidebar" class="col-sm-3 col-lg-2" role="navigation">

                                                                                                                                        <ul class="nav nav-pills nav-stacked">
                                    
                                    <h4 class="text-muted">
                                        
                                    </h4>

                                        <ul class="nav nav-pills nav-stacked">
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/index.html">
                                                   Pour commencer
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/contribuer_au_projet.html">
                                                   Aidez-nous
                                                </a>
                                            </li>
                                                                                </ul>
                                    
                                    <h4 class="text-muted">
                                        Administrateur
                                    </h4>

                                        <ul class="nav nav-pills nav-stacked">
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Administrateur/telechargement_et_installation.html">
                                                   Téléchargement et installation
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Administrateur/maj_wallabag.html">
                                                   Mettre à jour wallabag
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Administrateur/options_cachees.html">
                                                   Options cachées
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Administrateur/multi-utilisateurs.html">
                                                   wallabag multi-utilisateurs
                                                </a>
                                            </li>
                                                                                </ul>
                                    
                                    <h4 class="text-muted">
                                        Utilisateur
                                    </h4>

                                        <ul class="nav nav-pills nav-stacked">
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/sauvegarder_son_premier_article.html">
                                                   Sauvegarder son premier article
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/lire_un_article.html">
                                                   Lire un article
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/classer_ses_articles.html">
                                                   Classer ses articles
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/configurer_wallabag.html">
                                                   Configurer wallabag
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/rechercher.html">
                                                   Rechercher
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/convertir_en_epub.html">
                                                   Convertir en ePub
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/un_article_est_mal_affiche.html">
                                                   Problème d'affichage d'un article
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/flux_rss.html">
                                                   Flux RSS
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/importer_exporter.html">
                                                   Importer / Exporter
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Utilisateur/framabag.html">
                                                   Se créer un compte sur Framabag
                                                </a>
                                            </li>
                                                                                </ul>
                                    
                                    <h4 class="text-muted">
                                        Développeur
                                    </h4>

                                        <ul class="nav nav-pills nav-stacked">
                                                                                    <li class="test active">
                                                <a href="http://doc.wallabag.org/fr/Developpeur/ecrire_fichier_configuration.html">
                                                   Écrire un fichier de configuration
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Developpeur/creer_un_nouveau_theme.html">
                                                   Créer un nouveau thème
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Developpeur/depot_git.html">
                                                   Dépôt git de wallabag
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Developpeur/docker.html">
                                                   Docker
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Developpeur/vagrant.html">
                                                   Vagrant
                                                </a>
                                            </li>
                                                                                    <li class="test ">
                                                <a href="http://doc.wallabag.org/fr/Developpeur/v2.html">
                                                   wallabag v2 / symfony2
                                                </a>
                                            </li>
                                                                                </ul>
                                                                    </ul>
                                                                                                                                                            
                    </nav>

                
                <section class="col-lg-10">
                    <h1 id="crire-un-fichier-de-configuration">Écrire un fichier de configuration</h1>
<p>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 <a href="https://github.com/wallabag/wallabag/tree/master/inc/3rdparty/site_config/standard"><code>inc/3rdparty/site_config/standard</code></a>.</p>
<p>Le format utilisé pour ces fichiers est <a href="http://www.w3.org/TR/xpath20/">XPath</a>. Inspirez-vous des exemples dans le répertoire pour en créer de nouveaux.</p>
<h2 id="gnration-automatique-de-fichiers-de-configuration">Génération automatique de fichiers de configuration</h2>
<p>@FiveFilters a créé un <a href="http://siteconfig.fivefilters.org/">outil très utile</a> 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.</p>
<p><img src="https://lut.im/RNaO7gGe/l9vRnO1b" alt="siteconfig" /></p>
<p>Vous devez confirmer cette zone en essayant avec d'autres articles.
Quand vous avez trouvé la bonne zone, cliquez simplement sur <em>Download Full-Text RSS site config</em> (Téléchargez la configuration du site Full-Text RSS) pour télécharger le fichier à inclure dans le répertoire.</p>
<h2 id="gnration-manuelle-de-fichiers-de-configuration">Génération manuelle de fichiers de configuration</h2>
<p>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 <code>class</code> ou <code>id</code> de la zone que vous souhaitez.</p>
<p>Une fois que vous avez obtenu l'attribut <code>id</code> ou <code>class</code>, vous pouvez écrire par exemple l'une ou l'autre de ces lignes :</p>
<pre><code>body: //div[@class='myclass']
body: //div[@id='myid']</code></pre>
<p>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 <code>class</code> correspondant à la partie inutile) :</p>
<pre><code>strip: //div[@class='hidden']</code></pre>
<p>Vous pouvez regarder d'autres options pour les fichiers de configuration de sites <a href="http://help.fivefilters.org/customer/portal/articles/223153-site-patterns">sur l'aide du site de  FiveFilters</a>.</p>
                </section>

            </div>
        </main>

        <script src="//code.jquery.com/jquery-1.11.0.min.js"></script>
        <script src="//netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js"></script>
        <script src="http://yandex.st/highlightjs/7.5/highlight.min.js"></script>

        <script>
            $(function() {
                $("section>h1").wrap('<div class="page-header" />');
                // Syntax highlighting
                hljs.initHighlightingOnLoad();
            });
        </script>

    </body>
</html>