>Effect:</DT
><DD
><P
-> Text documents, including HTML and JavaScript, to which this action applies, are filtered on-the-fly
- through the specified regular expression based substitutions.
+> Text documents, including HTML and JavaScript, to which this action
+ applies, are filtered on-the-fly through the specified regular expression
+ based substitutions.
</P
></DD
><DT
option in the <A
HREF="config.html"
>config file</A
->)
+>). Filtering
+ can be completely disabled without the use of parameters. Example:
+ </P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+> { -filter }
+ .example.com</PRE
+></TD
+></TR
+></TABLE
+>
+ </P
+><P
+> Disables filters for that site.
</P
></DD
><DT
>Notes:</DT
><DD
><P
-> For your convenience, there are a bunch of pre-defined filters available
- in the distribution filter file that you can use. See the example below for
+> For your convenience, there are a number of pre-defined filters available
+ in the distribution filter file that you can use. See the examples below for
a list.
</P
><P
noticeable on slower connections.
</P
><P
+> The amount of data that can be filtered is limited to the
+ <TT
+CLASS="LITERAL"
+><A
+HREF="config.html#BUFFER-LIMIT"
+>buffer-limit</A
+></TT
+>
+ option in the main <A
+HREF="config.html"
+>config file</A
+>. The
+ default is 4096 KB (4 Megs). Once this limit is exceeded, the buffered
+ data, and all pending data, is passed through unfiltered.
+ </P
+><P
> At this time, <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>.
</P
><P
-> Filtering can achieve some of the effects as the
+> Filtering can achieve some of the same effects as the
<TT
CLASS="LITERAL"
><A
>block</A
></TT
>
- action, i.e. it can be used to block ads and banners.
+ action, i.e. it can be used to block ads and banners. But the mechanism
+ works quite differently. One effective use, is to block ad banners
+ based on their size (see below), since many of these seem to be somewhat
+ standardized.
</P
><P
> <A
HREF="contact.html"
>Feedback</A
-> with suggestions for new or improved filters is particularly
- welcome!
+> with suggestions for new or
+ improved filters is particularly welcome!
</P
></DD
><DT
><TD
><PRE
CLASS="SCREEN"
->+filter{banners-by-size} # Kill banners by size (<SPAN
+>+filter{banners-by-size} # Kill banners based on their size for this page (<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
><H3
CLASS="SECT3"
><A
-NAME="AEN2631">8.5.21. Summary</H3
+NAME="AEN2638">8.5.21. Summary</H3
><P
> Note that many of these actions have the potential to cause a page to
misbehave, possibly even not to display at all. There are many ways
><H3
CLASS="SECT3"
><A
-NAME="AEN2683">8.7.1. default.action</H3
+NAME="AEN2690">8.7.1. default.action</H3
><P
>Every config file should start with a short comment stating its purpose:</P
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2837">8.7.2. user.action</H3
+NAME="AEN2844">8.7.2. user.action</H3
><P
> So far we are painting with a broad brush by setting general policies,
which would be a reasonable starting point for many people. Now,
><H2
CLASS="SECT2"
><A
-NAME="AEN3384">14.2. <SPAN
+NAME="AEN3391">14.2. <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>'s Internal Pages</H2
Privoxy main page:
</P
><A
-NAME="AEN3399"><BLOCKQUOTE
+NAME="AEN3406"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
editing of actions files:
</P
><A
-NAME="AEN3407"><BLOCKQUOTE
+NAME="AEN3414"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
Show the source code version numbers:
</P
><A
-NAME="AEN3412"><BLOCKQUOTE
+NAME="AEN3419"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
Show the browser's request headers:
</P
><A
-NAME="AEN3417"><BLOCKQUOTE
+NAME="AEN3424"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN3422"><BLOCKQUOTE
+NAME="AEN3429"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
to run, but only as a pass-through proxy, with no actions taking place:
</P
><A
-NAME="AEN3428"><BLOCKQUOTE
+NAME="AEN3435"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN3432"><BLOCKQUOTE
+NAME="AEN3439"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
</P
></BLOCKQUOTE
><A
-NAME="AEN3435"><BLOCKQUOTE
+NAME="AEN3442"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>
HREF="appendix.html#BOOKMARKLETS"
>the Bookmarklets</A
> section on a quick
- and easy way to do this (be sure to flush caches afterward!).</P
+ and easy way to do this (be sure to flush caches afterward!). Looking at the
+ logs is a good idea too.</P
><P
> <SPAN
CLASS="APPLICATION"
One likely cause would be one of the <SPAN
CLASS="QUOTE"
>"{+filter}"</SPAN
-> actions. Try
- adding the URL for the site to one of aliases that turn off <SPAN
+> actions. These
+ tend to be harder to troubleshoot. Try adding the URL for the site to one of
+ aliases that turn off <SPAN
CLASS="QUOTE"
>"+filter"</SPAN
>:</P
></TABLE
></P
><P
-> This would probably be most appropriately put in <TT
+> This would turn off all filtering for that site. This would probably be most
+ appropriately put in <TT
CLASS="FILENAME"
>user.action</TT
->,
- for local site exceptions.</P
+>, for local site
+ exceptions.</P
+><P
+> Images that are inexplicably being blocked, may well be hitting the
+ <SPAN
+CLASS="QUOTE"
+>"+filter{banners-by-size}"</SPAN
+> rule, which assumes
+ that images of certain sizes are ad banners (works well most of the time
+ since these tend to be standardized).</P
><P
> <SPAN
CLASS="QUOTE"
><H2
CLASS="SECT2"
><A
-NAME="AEN3134">12.1. License</H2
+NAME="AEN3141">12.1. License</H2
><P
> <SPAN
CLASS="APPLICATION"
><H2
CLASS="SECT2"
><A
-NAME="AEN2940">9.1. Filter File Tutorial</H2
+NAME="AEN2947">9.1. Filter File Tutorial</H2
><P
> Now, let's complete our <SPAN
CLASS="QUOTE"
CLASS="QUOTE"
>"microsoft"</SPAN
>
- in the page. This prevents links to microsoft.com from being messed, while
+ in the page. This prevents links to microsoft.com from being trashed, while
still replacing the word everywhere else.</P
><P
> <TABLE
><BR></P
><P
CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.123.2.5 2002/05/29 02:01:02 hal9 Exp $<BR></P
+>$Id: user-manual.sgml,v 1.123.2.6 2002/06/06 23:11:03 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
></DT
><DT
>8.5.21. <A
-HREF="actions-file.html#AEN2631"
+HREF="actions-file.html#AEN2638"
>Summary</A
></DT
></DL
><DL
><DT
>8.7.1. <A
-HREF="actions-file.html#AEN2683"
+HREF="actions-file.html#AEN2690"
>default.action</A
></DT
><DT
>8.7.2. <A
-HREF="actions-file.html#AEN2837"
+HREF="actions-file.html#AEN2844"
>user.action</A
></DT
></DL
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN2940"
+HREF="filter-file.html#AEN2947"
>Filter File Tutorial</A
></DT
></DL
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN3134"
+HREF="copyright.html#AEN3141"
>License</A
></DT
><DT
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN3384"
+HREF="appendix.html#AEN3391"
><SPAN
CLASS="APPLICATION"
>Privoxy</SPAN