Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code

Delta Between Two Patch Sets: pages/filters.html

Issue 29501555: Issue 2373 - Add/change a sentence on filters page regarding EHH removing tag names by default (Closed) Base URL: https://hg.adblockplus.org/web.adblockplus.org
Left Patch Set: Created July 31, 2017, 10:47 a.m.
Right Patch Set: Remove "only" in s85 Created Aug. 2, 2017, 9:55 a.m.
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments.
Jump to:
Left: Side by side diff | Download
Right: Side by side diff | Download
« no previous file with change/comment | « no previous file | no next file » | no next file with change/comment »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
LEFTRIGHT
1 title=Writing Adblock Plus filters 1 title=Writing Adblock Plus filters
2 2
3 3
4 <p>{{s1 Current Adblock Plus versions allow you to "tweak" your filters in many different ways. This document explains the choices that you have and how they ca n be used.}}</p> 4 <p>{{s1 Current Adblock Plus versions allow you to "tweak" your filters in many different ways. This document explains the choices that you have and how they ca n be used.}}</p>
5 5
6 <p>{{s2 <em>Disclaimer</em>: All filter examples given here are really only ex amples and are not meant to be used.}}</p> 6 <p>{{s2 <em>Disclaimer</em>: All filter examples given here are really only ex amples and are not meant to be used.}}</p>
7 7
8 <h2 id="introduction">{{s3 Introduction to Adblock Plus filters}}</h2> 8 <h2 id="introduction">{{s3 Introduction to Adblock Plus filters}}</h2>
9 9
10 <p>{{s4 The options described in this section should be enough for users who h ave to create a filter occasionally.}}</p> 10 <p>{{s4 The options described in this section should be enough for users who h ave to create a filter occasionally.}}</p>
(...skipping 189 matching lines...) Expand 10 before | Expand all | Expand 10 after
200 &lt;div id=&quot;sponsorad&quot;&gt; 200 &lt;div id=&quot;sponsorad&quot;&gt;
201 Really cheap tofu, click here! 201 Really cheap tofu, click here!
202 &lt;/div&gt; 202 &lt;/div&gt;
203 &lt;textad&gt; 203 &lt;textad&gt;
204 Only here you get the best tofu! 204 Only here you get the best tofu!
205 &lt;/textad&gt; 205 &lt;/textad&gt;
206 </pre> 206 </pre>
207 207
208 <p>{{s84 You need to download the web page so you will necessarily download th e advertisements. All you can do here is to hide the advertisement so you don't need to see it. That's what element hiding is meant for.}}</p> 208 <p>{{s84 You need to download the web page so you will necessarily download th e advertisements. All you can do here is to hide the advertisement so you don't need to see it. That's what element hiding is meant for.}}</p>
209 209
210 <p>{{s85 The first advertisement above is contained inside an element with cla ss attribute "textad". The following rule will hide exactly any such element: <c ode><fix>##.textad</fix></code>. Here ## marks an element hiding rule while the rest is a selector identifying the elements that need to be hidden. You can hide elements by their id attribute similarly, <code><fix>###sponsorad</fix></code> will hide the second advertisement. And you can hide elements by element name on ly, e.g. <code><fix>##textad</fix></code> for the third advertisement.}}</p> 210 <p>{{s85 The first advertisement above is contained inside an element with cla ss attribute "textad". The following rule will hide exactly any such element: <c ode><fix>##.textad</fix></code>. Here ## marks an element hiding rule while the rest is a selector identifying the elements that need to be hidden. You can hide elements by their id attribute similarly, <code><fix>###sponsorad</fix></code> will hide the second advertisement. And you can hide elements by element name, e .g. <code><fix>##textad</fix></code> for the third advertisement.}}</p>
Wladimir Palant 2017/08/01 13:49:36 Nit: "only" doesn't make sense here any more.
ire 2017/08/02 09:56:00 Done.
211 211
212 <p>{{s86 The <a href="elemhidehelper">Element Hiding Helper extension</a> help s selecting the correct element and writing the corresponding rule without havin g to view the source code of the page. Basic HTML knowledge is useful neverthele ss.}}</p> 212 <p>{{s86 The <a href="elemhidehelper">Element Hiding Helper extension</a> help s selecting the correct element and writing the corresponding rule without havin g to view the source code of the page. Basic HTML knowledge is useful neverthele ss.}}</p>
213 213
214 <p>{{s87 <em>Note</em>: Element hiding works very differently from normal filt ers. This has the implication that no wildcards are supported in element hiding rules.}}</p> 214 <p>{{s87 <em>Note</em>: Element hiding works very differently from normal filt ers. This has the implication that no wildcards are supported in element hiding rules.}}</p>
215 215
216 <h3 id="elemhide_domains">{{s88 Limiting rules to certain domains}}</h3> 216 <h3 id="elemhide_domains">{{s88 Limiting rules to certain domains}}</h3>
217 217
218 <p>{{s89 Usually you want to hide a specific ad on one specific site, you don' t want your rule to be applied on other sites. For example the rule <code><fix># #.sponsor</fix></code> might hide valid code on some sites. But if you write it as <code><fix>example.com##.sponsor</fix></code> it will be applied on <code><fi x>http://example.com/</fix></code> and <code><fix>http://something.example.com/< /fix></code> but not on <code><fix>http://example.org/</fix></code>. You can als o specify multiple domains — simply separate them with commas: <code><fix>domain 1.example,domain2.example,domain3.example##.sponsor</fix></code>.}}</p> 218 <p>{{s89 Usually you want to hide a specific ad on one specific site, you don' t want your rule to be applied on other sites. For example the rule <code><fix># #.sponsor</fix></code> might hide valid code on some sites. But if you write it as <code><fix>example.com##.sponsor</fix></code> it will be applied on <code><fi x>http://example.com/</fix></code> and <code><fix>http://something.example.com/< /fix></code> but not on <code><fix>http://example.org/</fix></code>. You can als o specify multiple domains — simply separate them with commas: <code><fix>domain 1.example,domain2.example,domain3.example##.sponsor</fix></code>.}}</p>
219 219
220 <p>{{s90 If a domain name is preceded with "~", the rule will <strong>not</str ong> be applied on pages from this domain (requires Adblock Plus 1.1 or higher). For example, <code><fix>~example.com##.sponsor</fix></code> will be be applied on pages from any domain but "example.com" and <code><fix>example.com,~foo.examp le.com##.sponsor</fix></code> makes the rule apply on "example.com" domain with the exception of "foo.example.com" subdomain.}}</p> 220 <p>{{s90 If a domain name is preceded with "~", the rule will <strong>not</str ong> be applied on pages from this domain (requires Adblock Plus 1.1 or higher). For example, <code><fix>~example.com##.sponsor</fix></code> will be be applied on pages from any domain but "example.com" and <code><fix>example.com,~foo.examp le.com##.sponsor</fix></code> makes the rule apply on "example.com" domain with the exception of "foo.example.com" subdomain.}}</p>
(...skipping 74 matching lines...) Expand 10 before | Expand all | Expand 10 after
295 {{s110 The data used for creating the signature is a concatenated list of requ est variables (namely URI, host and user agent) separated by the <code><fix>NUL< /fix></code> character "\0". For example:}} 295 {{s110 The data used for creating the signature is a concatenated list of requ est variables (namely URI, host and user agent) separated by the <code><fix>NUL< /fix></code> character "\0". For example:}}
296 </p> 296 </p>
297 297
298 <pre> 298 <pre>
299 /index.html?q=foo\0www.example.com\0Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv :30.0) Gecko/20100101 Firefox/30.0 299 /index.html?q=foo\0www.example.com\0Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv :30.0) Gecko/20100101 Firefox/30.0
300 </pre> 300 </pre>
301 301
302 <p> 302 <p>
303 {{s111 Finally, generate the signature for this string by using the signature algorithm SEC_OID_ISO_SHA_WITH_RSA_SIGNATURE (default when using OpenSSL).}} 303 {{s111 Finally, generate the signature for this string by using the signature algorithm SEC_OID_ISO_SHA_WITH_RSA_SIGNATURE (default when using OpenSSL).}}
304 </p> 304 </p>
LEFTRIGHT
« no previous file | no next file » | Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Toggle Comments ('s')

Powered by Google App Engine
This is Rietveld