OLD | NEW |
(Empty) | |
| 1 { |
| 2 "title": { |
| 3 "message": "Créer des filtres Adblock Plus" |
| 4 }, |
| 5 "s1": { |
| 6 "message": "Les versions actuelles d'Adblock Plus vous permettent de fabriqu
er vos propres filtres de plusieurs manières différentes. Ce document explique l
es possibilités qui sont à votre disposition et comment les utiliser." |
| 7 }, |
| 8 "s2": { |
| 9 "message": "<em>Décharge de responsabilité</em> : tous les exemples de filtr
es donnés ici ne sont vraiment que des exemples et ne sont pas destinés à être u
tilisés." |
| 10 }, |
| 11 "s3": { |
| 12 "message": "Introduction aux filtres Adblock Plus" |
| 13 }, |
| 14 "s4": { |
| 15 "message": "Les options décrites dans cette rubrique devraient être suffisan
tes pour les utilisateurs ayant besoin de créer un filtre occasionnellement." |
| 16 }, |
| 17 "s5": { |
| 18 "message": "Règles de filtres basiques" |
| 19 }, |
| 20 "s6": { |
| 21 "message": "Le filtre le plus trivial que vous puissiez créer est naturellem
ent l'adresse de la publicité que vous souhaitez bloquer. Cependant, souvent cet
te adresse change lorsque vous affichez votre page. Cela pourrait être par exemp
le <code>{1}</code> où 123 est un nombre aléatoire. Dans ce cas, bloquer cette a
dresse ne sera pas d'une grande utilité, vous devriez donc créer un filtre plus
général — tel que <code>{2}</code>, ou peut-être <code>{3}</code> seule." |
| 22 }, |
| 23 "s7": { |
| 24 "message": "<em>Remarque</em> : assurez-vous que vous ne remplacez pas trop
de choses par des jokers (*). Le filtre <code>{1}</code> bloquera toutes les pub
licités mais bloquera également toutes autres pages provenant de example.com que
vous souhaiteriez peut-être tout de même voir." |
| 25 }, |
| 26 "s8": { |
| 27 "message": "Définition de règles d'exception" |
| 28 }, |
| 29 "s9": { |
| 30 "message": "De temps à autres vous constaterez qu'un de vos filtres qui fonc
tionne habituellement correctement, bloque quelque chose qu'il ne devrait pas bl
oquer. Vous ne souhaitez pas supprimer ce filtre mais il ne devrait plus bloquer
ce qu'il vient de bloquer." |
| 31 }, |
| 32 "s10": { |
| 33 "message": "Ce sont les règles d'exception (liste blanche) qui se chargent d
e cela — Elles vous permettent de définir des situations dans lesquelles les fil
tres ne devront pas être appliqués. Par exemple, si vous n'êtes pas satisfait de
votre filtre <code>{1}</code> qui bloque <code>{2}</code>, vous pouvez créer un
e règle d'exception <code>{3}</code>. Les règles d'exception ne sont pas très di
fférentes des filtres de publicités, vous pouvez utiliser des jokers (*) et des
expressions régulières. Vous n'avez qu'à les faire débuter par <code>{4}</code>
pour indiquer que ce sont des règles d'exception." |
| 34 }, |
| 35 "s11": { |
| 36 "message": "Les règles d'exception peuvent faire davantage. Si une règle d'e
xception commence par http:// ou https:// (avec une barre verticale | optionnell
ement avant) cela permettra d'ajouter toutes les pages Web dans les exceptions (
liste blanche). Par exemple, si votre règle d'exception est <code>{1}</code> et
vous ouvrez des pages de example.com — Adblock Plus sera complètement désactivée
pour cette page et rien ne sera bloqué." |
| 37 }, |
| 38 "s12": { |
| 39 "message": "Coïncidence avec le début/la fin d'une adresse" |
| 40 }, |
| 41 "s13": { |
| 42 "message": "Normalement Adblock Plus traite chaque filtre comme s'il posséda
it un joker (*) au début et à la fin. Exemple : il n'y a aucune différence entre
les filtres <code>{1}</code> et <code>{2}</code>. Ceci ne pose aucun problème e
n général, mais quelquefois vous souhaiteriez peut-être que le filtre que vous a
vez défini ne corresponde qu'au début ou qu'à la fin d'une adresse. Vous souhait
ez, par exemple, bloquer toutes les animations Flash, mais si vous ajoutez le fi
ltre <code>{3}</code> (extension des animations Flash) l'adresse <code>{4}</code
> sera également bloquée." |
| 43 }, |
| 44 "s14": { |
| 45 "message": "La solution à ce problème : ajouter le symbole trait vertical (|
) au filtre pour indiquer que c'est la fin de l'adresse qui devra correspondre a
u filtre pour être bloquée. Par exemple le filtre <code>{1}</code> bloquera <cod
e>{2}</code> mais pas <code>{3}</code>. Et le filtre <code>|http://mauvaisdomain
e.exemple/</code> bloquera <code>http://mauvaisdomaine.exemple/banner.gif</code>
mais pas <code>http://bondomaine.exemple/analyze?http://mauvaisdomaine.exemple<
/code> seule." |
| 46 }, |
| 47 "s15": { |
| 48 "message": "De temps à autre vous voudriez bloquer <code>{1}</code> ainsi qu
e <code>{2}</code> et que <code>{3}</code>. Cela peut se faire en plaçant deux t
raits verticaux devant le filtre qui vérifie si le filtre correspond au début du
nom de domaine : <code>{4}</code> bloquera toutes ces adresses mais pas celle-l
à : <code>http://mauvaisexample.com/banniere.gif</code> ou <code>http://bondomai
n.example/analyze?http://example.com/banniere.gif</code> (Adblock Plus 1.1 ou su
périeur est nécessaire)." |
| 49 }, |
| 50 "s16": { |
| 51 "message": "Marquage des caractères séparateurs" |
| 52 }, |
| 53 "s17": { |
| 54 "message": "Souvent vous devez accepter des caractères séparateurs dans des
filtres. Par exemple, vous pouvez créer un filtre qui bloque <code>{1}</code> et
<code>{2}</code> mais pas <code>{3}</code>. Dans ce cas, le symbole ^ pourra êt
re utilisé comme un remplaçant d'un caractère séparateur : <code>{4}</code> (Adb
lock Plus 1.1 ou supérieur est nécessaire)." |
| 55 }, |
| 56 "s18": { |
| 57 "message": "Un caractère séparateur est tout sauf une lettre, un nombre ou u
n des caractères suivants : {1}. La fin d'une adresse est également acceptée com
me étant un séparateur. Dans l'exemple suivant, tous les caractères séparateurs
sont affichés en rouge :" |
| 58 }, |
| 59 "s19": { |
| 60 "message": ". Cette adresse pourra être bloquée par le filtre <code>{1}</cod
e> ou <code>{2}</code> ou <code>{3}</code> seule." |
| 61 }, |
| 62 "s20": { |
| 63 "message": "Commentaires" |
| 64 }, |
| 65 "s21": { |
| 66 "message": "Toute règle débutant par un point d'exclamation sera considérée
comme étant un commentaire. Elle sera affichée dans la liste de filtres mais gri
sée au lieu d'être en noir. Adblock Plus ignorera cette règle pour le blocage, e
lle permet donc d'écrire ce que l'on veut. Vous pouvez ainsi placer un commentai
re pour décrire la fonction de tels ou tels filtres. Vous pouvez également indiq
uer votre nom et la propriété de votre liste en haut de la liste de filtres (bea
ucoup d'auteurs de listes le font)." |
| 67 }, |
| 68 "s51": { |
| 69 "message": "Fonctionnalités avancées" |
| 70 }, |
| 71 "s52": { |
| 72 "message": "Les fonctions décrites dans cette rubrique ne sont utilisées hab
ituellement que par les utilisateurs confirmés et les créateurs de listes de fil
tres. Vous n'êtes donc pas obligé de lire cette rubrique." |
| 73 }, |
| 74 "s53": { |
| 75 "message": "Spécification des options de filtrage" |
| 76 }, |
| 77 "s54": { |
| 78 "message": "Adblock Plus vous permet de spécifier un certain nombre d'option
s pour modifier le comportement d'un filtre. Vous devez lister ces options en le
s séparant par une virgule et en les faisant débuter par un dollar ($) à la fin
du filtre. Exemple :" |
| 79 }, |
| 80 "s55": { |
| 81 "message": "Ici <code>{1}</code> est le filtre et <code>{2}</code> et <code
>{3}</code> sont ses options. Pour le moment, sont disponibles les options suiva
ntes :" |
| 82 }, |
| 83 "s56": { |
| 84 "message": "Options de type : détermine quel type d'éléments le filtre peut
bloquer (ou autoriser en cas de liste blanche). De nombreux types d'options peuv
ent être spécifiés pour indiquer que le filtre devra être appliqué à plusieurs t
ypes d'éléments. Les types possibles sont :" |
| 85 }, |
| 86 "s57": { |
| 87 "message": "<code>{1}</code> — scripts externes chargés via la balise HTML s
cript" |
| 88 }, |
| 89 "s58": { |
| 90 "message": "<code>{1}</code> — images normales, chargées typiquement via la
balise HTML img" |
| 91 }, |
| 92 "s59": { |
| 93 "message": "<code>{1}</code> — fichiers de feuille de style CSS externes" |
| 94 }, |
| 95 "s60": { |
| 96 "message": "<code>{1}</code> — contenu traité par des plugins du navigateur
comme par exemple Flash ou Java" |
| 97 }, |
| 98 "s62": { |
| 99 "message": "<code>{1}</code> — requêtes démarrées par <a>l'objet XMLHttpRequ
est</a> " |
| 100 }, |
| 101 "s63": { |
| 102 "message": "<code>{1}</code> — requêtes démarrées par les plugins comme Flas
h" |
| 103 }, |
| 104 "s64": { |
| 105 "message": "<code>{1}</code> — pages incorporées (embedded), habituellement
incluses via la balise HTML frames" |
| 106 }, |
| 107 "s65": { |
| 108 "message": "<code>{1}</code> — la page elle-même (uniquement les <a>règles d
'exception</a> peuvent être appliquées à la page)" |
| 109 }, |
| 110 "s66": { |
| 111 "message": "<code>{1}</code> — uniquement pour les règles d'exception, comme
pour <code>{2}</code> mais ne désactive que les <a>règles de masquage d'élément
</a> sur la page plutôt que toutes les règles de filtre (Adblock Plus 1.2 et su
périeur nécessaire)" |
| 112 }, |
| 113 "s67": { |
| 114 "message": "<code>{1}</code> — d'autres types de requêtes telles que liaison
s XBL, requêtes http XML ou données demandées par des objets. Cela signifie : le
s types de requêtes non appréhéndées par la liste ci-dessus" |
| 115 }, |
| 116 "s68": { |
| 117 "message": "Les options de type <code>{1}</code>, <code>{2}</code>, <code>{
3}</code> et <code>{4}</code> sont obsolètes et ne doivent plus être utilisées." |
| 118 }, |
| 119 "s69": { |
| 120 "message": "Options de type inverse : spécifie les types d'éléments auxquels
le filtre <strong>ne doit pas</strong> être appliqué. Les options de type inver
se possibles sont : <code>{1}</code>, <code>{2}</code>, <code>{3}</code>, <code>
{4}</code>, <code>{5}</code>, <code>{6}</code>, <code>{7}</code>, <code>{8}</cod
e>, <code>{9}</code>, <code>{10}</code>" |
| 121 }, |
| 122 "s70": { |
| 123 "message": "Restriction aux requêtes third-party/first-party (provenant d'un
autre/du même site) : Si l'option <code>{1}</code> est spécifiée, le filtre n'e
st appliqué qu'aux requêtes provenant d'une autre origine que la page actuelleme
nt affichée. De manière similaire, <code>{2}</code> restreint l'action du filtre
aux requêtes provenant de la même origine que la page couramment affichée." |
| 124 }, |
| 125 "s71": { |
| 126 "message": "Restrictions de domaines : l'option <code>{1}</code> signifie qu
e le filtre ne devra s'appliquer qu'aux pages provenant du domaine \"example.com
\". Plusieurs domaines peuvent être spécifiés en utilisant \"|\" comme séparateu
r : avec l'option <code>{2}</code> le filtre ne s'appliquera qu'aux pages proven
ant des domaines \"example.com\" ou \"example.net\". Si un nom de domaine est p
récédé par \"~\", le filtre <strong>ne s'appliquera pas</strong> aux pages de ce
domaine. Par exemple, <code>{3}</code> signifie que le filtre devra s'appliquer
à toutes les pages sauf celles provenant de \"example.com\" et <code>{4}</code>
restreint l'action du filtre au domaine \"example.com\" avec comme exception le
sous-domaine \"foo.example.com\"." |
| 127 }, |
| 128 "s73": { |
| 129 "message": "<code>{1}</code> — fait en sorte que le filtre ne s'applique qu'
aux adresses correspondant à la casse (prise en compte des minuscules et des maj
uscules), par exemple, le filtre <code>{2}</code> bloquera <code>{3}</code> mais
pas <code>{4}</code> seule." |
| 130 }, |
| 131 "s74": { |
| 132 "message": "<code>{1}</code> — cette option va se substituer à l’option glob
ale « Masquer les conteneurs des éléments bloqués » et va faire en sorte que le
filtre masque le conteneur à coup sûr. De la même façon, l'option <code>{2}</cod
e> permet d’éviter que le conteneur de l’élément ne soit masqué." |
| 133 }, |
| 134 "s75": { |
| 135 "message": "<code>{1}</code> — pour toute adresse correspondant à une règle
de blocage et ne correspondant à aucune règle d’exception, un en-tête <a>Do-Not
-Track</a> sera envoyé grâce à cette option (requiert Adblock Plus 1.3.5 ou supé
rieur)." |
| 136 }, |
| 137 "s76": { |
| 138 "message": "Pour assurer une rétrocompatibilité, il est recommandé d’utilise
r cette option en association avec des options de type contradictoires, ce qui p
ermettra d’éviter que le filtre ne bloque rien avec les versions antérieurs d’Ad
block Plus : <code>{1}</code>" |
| 139 }, |
| 140 "s77": { |
| 141 "message": "Utilisation d'expressions régulières" |
| 142 }, |
| 143 "s79": { |
| 144 "message": "Si vous souhaitez davantage de précision de filtrage vous pouvez
utiliser des expressions régulières. Par exemple, le filtre <code>{1}</code> bl
oquera <code>{2}</code> et <code>{3}</code> mais pas <code>{4}</code>. Vous pouv
ez lire une <a>documentation sur les expressions régulières</a> pour apprendre à
en créer." |
| 145 }, |
| 146 "s80": { |
| 147 "message": "<em>Remarque</em> : Pour des raisons de performances il est reco
mmandé de ne pas utiliser d'expressions régulières tant que cela peut être évité
." |
| 148 }, |
| 149 "s81": { |
| 150 "message": "Cacher des éléments" |
| 151 }, |
| 152 "s82": { |
| 153 "message": "Règles basiques" |
| 154 }, |
| 155 "s83": { |
| 156 "message": "Parfois vous trouverez des publicités impossible à bloquer car e
lles sont intégrées en tant que texte dans la page Web. Si vous affichez le code
source de cette page, vous trouverez probablement quelque chose de ce style :" |
| 157 }, |
| 158 "s84": { |
| 159 "message": "Vous devez charger la page Web, vous téléchargerez donc obligato
irement les publicités. Tout ce que vous pouvez encore faire, c'est de cacher la
publicité pour ne pas la voir s'afficher. La fonctionnalité \"Cacher les élémen
ts\" vous permettra de faire cela." |
| 160 }, |
| 161 "s85": { |
| 162 "message": "La première publicité dans l'exemple ci-dessus est contenue dans
un élément div avec un attribut de classe \"textad\". Le filtre suivant cachera
exactement cette combinaison : <code>{1}</code>. Ici ## marque une règle de mas
quage d'élément alors que le reste est un sélecteur identifiant les éléments dev
ant être masqués. Vous pouvez de la même manière cacher des éléments par leur at
tribut d'id, <code>{2}</code> cachera la seconde publicité. Vous n'êtes pas obli
gé de spécifier le nom d'élément, le filtre <code>{3}</code> fonctionnera tout a
ussi bien. Sur le même principe, vous pouvez cacher des éléments par leur nom, p
ar exemple <code>{4}</code> pour la troisième publicité." |
| 163 }, |
| 164 "s86": { |
| 165 "message": "L'extension <a>Element Hiding Helper extension</a> aide à sélect
ionner le bon élément et à écrire la règle correspondante sans avoir à afficher
le code source de la page. Des connaissances basiques en HTML sont tout de même
utiles." |
| 166 }, |
| 167 "s87": { |
| 168 "message": "<em>Remarque</em> : cacher les éléments fonctionne totalement di
fféremment par rapport aux filtres normaux. Ce qui implique que les jokers ne pe
uvent être utilisés dans ce genre de filtres." |
| 169 }, |
| 170 "s88": { |
| 171 "message": "Limitation des règles à certains domaines" |
| 172 }, |
| 173 "s89": { |
| 174 "message": "En général vous souhaitez cacher une publicité spécifique sur un
site spécifique, vous ne souhaitez pas appliquer le filtre à d'autres sites. Pa
r exemple le filtre <code>{1}</code> pourrait cacher des codes valides sur certa
ins sites. Mais si vous écrivez <code>{2}</code> il sera appliqué aux sites <cod
e>{3}</code> et <code>{4}</code> mais pas à <code>{5}</code>. Vous pouvez égalem
ent spécifier plusieurs domaines — séparez-les simplement par des virgules : <co
de>{6}</code> seule." |
| 175 }, |
| 176 "s90": { |
| 177 "message": "Si un nom de domaine est précédé par un \"~\", la règle <strong>
ne sera pas</strong> appliquée pour les pages de ce domaine (Adblock Plus 1.1 ou
supérieur est nécessaire). Par exemple, <code>{1}</code> sera appliqué à toutes
les pages de tout domaine sauf \"example.com\" et <code>{2}</code> fera appliqu
er la règle sur le domaine \"example.com\" avec comme exception le sous-domaine
\"foo.example.com\"." |
| 178 }, |
| 179 "s91": { |
| 180 "message": "<em>Remarque</em> : A cause de la manière avec laquelle \"cacher
les éléments\" est implémentée, vous ne pouvez que vous limiter à des noms de d
omaines complets. Vous ne pouvez utiliser une autre partie de l'adresse et vous
ne pouvez pas utiliser <code>{1}</code> afin de remplacer <code>{2}</code> seule
." |
| 181 }, |
| 182 "s92": { |
| 183 "message": "<em>Remarque</em> : Les règles pour cacher des éléments en limit
ant par domaine peuvent également être utilisées pour cacher des éléments de l'i
nterface utilisateur. Exemple : le filtre <code>{1}</code> cachera l'entrée \"Co
nsole javascript\" dans le menu \"Outils\" de Firefox." |
| 184 }, |
| 185 "s93": { |
| 186 "message": "Sélecteurs d'attribut" |
| 187 }, |
| 188 "s94": { |
| 189 "message": "Certains publicitaires ne vous facilitent pas la tâche — leur te
xte publicitaire ne comporte ni un attribut classe, ni un attribut id. Dans ce c
as, vous pouvez utiliser d'autres attributs pour cacher les publicités, par exem
ple <code>{1}</code> cachera les tableaux ayant un attribut width (largeur) de 8
0%. Si vous ne souhaitez pas spécifier la valeur entière de l'attribut, <code>{2
}</code> cachera tous les éléments div avec un attribut title (titre) contenant
la suite de caractères \"adv\". Vous pouvez également vérifier le début et la fi
n d'un attribut, par exemple <code>{3}</code> cachera les éléments div dont l'at
tribut title commence par \"adv\" et se termine par \"ert\". Comme vous le const
atez, vous pouvez également utiliser plusieurs conditions — <code>{4}</code> cor
respondra aux tableaux dont l'attribut width est fixé à 80% et l'attribut bgcolo
r défini à white (couleur blanche)." |
| 190 }, |
| 191 "s95": { |
| 192 "message": "Sélecteurs avancés" |
| 193 }, |
| 194 "s97": { |
| 195 "message": "En général, tout sélecteur CSS pris en charge par Firefox pourra
être utilisé pour le masquage d'élément. Par exemple la règle suivante masquera
tout ce qui suit un élément div avec pour classe \"adheader\": <code>{1}</code>
. Pour obtenir une liste complète CSS rendez-vous sur la page de la <a>spécific
ation W3C CSS</a> (veuillez prendre note que tous les sélecteurs ne sont pas enc
ore pris en charge par Firefox)." |
| 196 }, |
| 197 "s98": { |
| 198 "message": "<em>Remarque</em>: Cette fonctionnalité n'est prévue que pour le
s utilisateurs chevronnés, il faut que vous soyez à l'aise avec les sélecteurs C
SS pour l'utiliser. Adblock Plus ne pourra pas vérifier la syntaxe du sélecteur
que vous ajoutez, si vous utilisez une syntaxe CSS invalide vous risquez d'endom
mager d'autres règles (valides) que vous avez. Vérifiez la console Javascript po
ur détecter d'éventuelles erreurs CSS." |
| 199 }, |
| 200 "s99": { |
| 201 "message": "Règles d'exception" |
| 202 }, |
| 203 "s100": { |
| 204 "message": "Les règles d'exception permettent de désactiver un filtre exista
nt sur certains domaines." |
| 205 }, |
| 206 "s101": { |
| 207 "message": "Cela est surtout utile pour les gestionnaires de listes compléme
ntaires qui viennent étendre l'action de listes de filtres qu'ils ne peuvent mod
ifier." |
| 208 }, |
| 209 "s102": { |
| 210 "message": "Par exemple, le filtre <code>{1}</code> peut être désactivé sur
<code>{2}</code> grâce à la règle d'exception <code>{3}</code> seule." |
| 211 }, |
| 212 "s103": { |
| 213 "message": "La combinaison de ces deux règles a exactement le même effet que
la règle <code>{1}</code> seule." |
| 214 }, |
| 215 "s104": { |
| 216 "message": "L'utilisation des règles d'exception est recommandée uniquement
lorsque vous ne pouvez pas modifier une règle de masquage d'élément prédominante
; il est sinon préférable de limiter cette règle aux domaines qui le nécessite.
" |
| 217 }, |
| 218 "s105": { |
| 219 "message": "Syntaxe simplifiée pour masquage d'élément" |
| 220 }, |
| 221 "s106": { |
| 222 "message": "Adblock Plus prend en charge une syntaxe simplifiée pour le masq
uage d'élément (ex. <code>{1}</code>) pour une compatibilité rétrograde uniqueme
nt. L'utilisation de cette syntaxe est déconseillée, les sélecteurs CSS usuels s
ont préférés. L'aide concernant cette syntaxe sera probablement abandonnée à un
moment." |
| 223 }, |
| 224 "s62-link": { |
| 225 "message": "http://www.w3.org/TR/XMLhttpRequest/" |
| 226 }, |
| 227 "s79-link": { |
| 228 "message": "https://developer.mozilla.org/fr/Guide_JavaScript_1.5/Expression
s_rationnelles" |
| 229 }, |
| 230 "s97-link": { |
| 231 "message": "http://www.w3.org/TR/css3-selectors/" |
| 232 } |
| 233 } |
OLD | NEW |