>Actions Files</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
><H2
CLASS="SECT2"
><A
-NAME="AEN1527"
+NAME="AEN1553"
>8.1. Finding the Right Mix</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1534"
+NAME="AEN1560"
>8.2. How to Edit</A
></H2
><P
HREF="actions-file.html#ALIASES"
>alias</A
>"</SPAN
-> sections which will be discussed later. For now
- let's concentrate on regular sections: They have a heading line (often split
- up to multiple lines for readability) which consist of a list of actions,
- separated by whitespace and enclosed in curly braces. Below that, there
- is a list of URL patterns, each on a separate line.</P
+> sections which will
+ be discussed later. For now let's concentrate on regular sections: They have a
+ heading line (often split up to multiple lines for readability) which consist
+ of a list of actions, separated by whitespace and enclosed in curly braces.
+ Below that, there is a list of URL patterns, each on a separate line.</P
><P
> To determine which actions apply to a request, the URL of the request is
compared to all patterns in each action file file. Every time it matches, the list of
applicable actions for the URL is incrementally updated, using the heading
of the section in which the pattern is located. If multiple matches for
the same URL set the same action differently, the last match wins. If not,
- the effects are aggregated (e.g. a URL might match both the
- <A
+ the effects are aggregated. E.g. a URL might match a regular section with
+ a heading line of <TT
+CLASS="LITERAL"
+>{
+ +<A
HREF="actions-file.html#HANDLE-AS-IMAGE"
TARGET="_top"
-><SPAN
-CLASS="QUOTE"
->"+handle-as-image"</SPAN
-></A
->
- and <A
+>handle-as-image</A
+> }</TT
+>,
+ then later another one with just <TT
+CLASS="LITERAL"
+>{
+ +<A
HREF="actions-file.html#BLOCK"
TARGET="_top"
-><SPAN
-CLASS="QUOTE"
->"+block"</SPAN
-></A
-> actions).
- </P
+>block</A
+> }</TT
+>, resulting
+ in <I
+CLASS="EMPHASIS"
+>both</I
+> actions to apply.</P
><P
> You can trace this process for any given URL by visiting <A
HREF="http://config.privoxy.org/show-url-info"
><H3
CLASS="SECT3"
><A
-NAME="AEN1597"
+NAME="AEN1624"
>8.4.1. The Domain Pattern</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN1659"
+NAME="AEN1686"
>8.4.2. The Path Pattern</A
></H3
><P
> (regular expression speak
for the beginning of a line).</P
><P
-> Please also note that matching in the path is case
- <I
+> Please also note that matching in the path is <I
CLASS="EMPHASIS"
->INSENSITIVE</I
-> by default, but you can switch to case
- sensitive at any point in the pattern by using the
+>CASE INSENSITIVE</I
+>
+ by default, but you can switch to case sensitive at any point in the pattern by using the
<SPAN
CLASS="QUOTE"
>"(?-i)"</SPAN
-> switch:
- <TT
+> switch: <TT
CLASS="LITERAL"
>www.example.com/(?-i)PaTtErN.*</TT
-> will match only
- documents whose path starts with <TT
+> will match
+ only documents whose path starts with <TT
CLASS="LITERAL"
>PaTtErN</TT
> in
CLASS="SECT3"
><A
NAME="ADD-HEADER"
->8.5.1. <I
-CLASS="EMPHASIS"
->add-header</I
-></A
+>8.5.1. add-header</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="BLOCK"
->8.5.2. <I
-CLASS="EMPHASIS"
->block</I
-></A
+>8.5.2. block</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="CRUNCH-INCOMING-COOKIES"
->8.5.3. <I
-CLASS="EMPHASIS"
->crunch-incoming-cookies</I
-></A
+>8.5.3. crunch-incoming-cookies</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="CRUNCH-OUTGOING-COOKIES"
->8.5.4. <I
-CLASS="EMPHASIS"
->crunch-outgoing-cookies</I
-></A
+>8.5.4. crunch-outgoing-cookies</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="DEANIMATE-GIFS"
->8.5.5. <I
-CLASS="EMPHASIS"
->deanimate-gifs</I
-></A
+>8.5.5. deanimate-gifs</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="DOWNGRADE-HTTP-VERSION"
->8.5.6. <I
-CLASS="EMPHASIS"
->downgrade-http-version</I
-></A
+>8.5.6. downgrade-http-version</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="FAST-REDIRECTS"
->8.5.7. <I
-CLASS="EMPHASIS"
->fast-redirects</I
-></A
+>8.5.7. fast-redirects</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="FILTER"
->8.5.8. <I
-CLASS="EMPHASIS"
->filter</I
-></A
+>8.5.8. filter</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="HANDLE-AS-IMAGE"
->8.5.9. <I
-CLASS="EMPHASIS"
->handle-as-image</I
-></A
+>8.5.9. handle-as-image</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="HIDE-FORWARDED-FOR-HEADERS"
->8.5.10. <I
-CLASS="EMPHASIS"
->hide-forwarded-for-headers</I
-></A
+>8.5.10. hide-forwarded-for-headers</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="HIDE-FROM-HEADER"
->8.5.11. <I
-CLASS="EMPHASIS"
->hide-from-header</I
-></A
+>8.5.11. hide-from-header</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="HIDE-REFERRER"
->8.5.12. <I
-CLASS="EMPHASIS"
->hide-referrer</I
-></A
+>8.5.12. hide-referrer</A
></H4
><A
NAME="HIDE-REFERER"
CLASS="SECT3"
><A
NAME="HIDE-USER-AGENT"
->8.5.13. <I
-CLASS="EMPHASIS"
->hide-user-agent</I
-></A
+>8.5.13. hide-user-agent</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="KILL-POPUPS"
->8.5.14. <I
-CLASS="EMPHASIS"
->kill-popups<A
+>8.5.14. kill-popups<A
NAME="KILL-POPUP"
></A
-></I
></A
></H4
><P
CLASS="SECT3"
><A
NAME="LIMIT-CONNECT"
->8.5.15. <I
-CLASS="EMPHASIS"
->limit-connect</I
-></A
+>8.5.15. limit-connect</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="PREVENT-COMPRESSION"
->8.5.16. <I
-CLASS="EMPHASIS"
->prevent-compression</I
-></A
+>8.5.16. prevent-compression</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="SEND-VANILLA-WAFER"
->8.5.17. <I
-CLASS="EMPHASIS"
->send-vanilla-wafer</I
-></A
+>8.5.17. send-vanilla-wafer</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="SEND-WAFER"
->8.5.18. <I
-CLASS="EMPHASIS"
->send-wafer</I
-></A
+>8.5.18. send-wafer</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="SESSION-COOKIES-ONLY"
->8.5.19. <I
-CLASS="EMPHASIS"
->session-cookies-only</I
-></A
+>8.5.19. session-cookies-only</A
></H4
><P
></P
CLASS="SECT3"
><A
NAME="SET-IMAGE-BLOCKER"
->8.5.20. <I
-CLASS="EMPHASIS"
->set-image-blocker</I
-></A
+>8.5.20. set-image-blocker</A
></H4
><P
></P
><H3
CLASS="SECT3"
><A
-NAME="AEN2593"
+NAME="AEN2600"
>8.5.21. Summary</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2645"
+NAME="AEN2652"
>8.7.1. default.action</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2799"
+NAME="AEN2806"
>8.7.2. user.action</A
></H3
><P
>Appendix</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
><H2
CLASS="SECT2"
><A
-NAME="AEN3346"
+NAME="AEN3353"
>14.2. <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
Privoxy main page:
</P
><A
-NAME="AEN3361"
+NAME="AEN3368"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
editing of actions files:
</P
><A
-NAME="AEN3369"
+NAME="AEN3376"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the source code version numbers:
</P
><A
-NAME="AEN3374"
+NAME="AEN3381"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the browser's request headers:
</P
><A
-NAME="AEN3379"
+NAME="AEN3386"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN3384"
+NAME="AEN3391"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
to run, but only as a pass-through proxy, with no actions taking place:
</P
><A
-NAME="AEN3390"
+NAME="AEN3397"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN3394"
+NAME="AEN3401"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
</P
></BLOCKQUOTE
><A
-NAME="AEN3397"
+NAME="AEN3404"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
>The Main Configuration File</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
>Privoxy</SPAN
> will
bind to all interfaces (addresses) on your machine and may become reachable
- from the Internet. In that case, consider using access control lists (ACL's)
- (see <SPAN
-CLASS="QUOTE"
->"ACLs"</SPAN
-> below), or a firewall.
+ from the Internet. In that case, consider using <A
+HREF="config.html#ACLS"
+>access control lists</A
+> (ACL's, see below), and/or
+ a firewall.
+ </P
+><P
+> If you open <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> to untrusted users, you will
+ also want to turn off the <TT
+CLASS="LITERAL"
+><A
+HREF="config.html#ENABLE-EDIT-ACTIONS"
+>enable-edit-actions</A
+></TT
+> and
+ <TT
+CLASS="LITERAL"
+><A
+HREF="config.html#ENABLE-REMOTE-TOGGLE"
+>enable-remote-toggle</A
+></TT
+>
+ options!
</P
></DD
><DT
>7.4.5. ACLs: permit-access and deny-access</A
></H4
><A
-NAME="PERMIT-ACCES"
+NAME="PERMIT-ACCESS"
></A
><A
-NAME="DENY-ACCES"
+NAME="DENY-ACCESS"
></A
><P
></P
>Privoxy Configuration</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
><H2
CLASS="SECT2"
><A
-NAME="AEN481"
+NAME="AEN501"
>6.1. Controlling <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
Requests</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
>Privoxy Copyright, License and History</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
><H2
CLASS="SECT2"
><A
-NAME="AEN3096"
+NAME="AEN3103"
>12.1. License</A
></H2
><P
>The Filter File</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
><H2
CLASS="SECT2"
><A
-NAME="AEN2902"
+NAME="AEN2909"
>9.1. Filter File Tutorial</A
></H2
><P
>Privoxy User Manual</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="NEXT"
TITLE="Introduction"
HREF="introduction.html"><LINK
><BR></P
><P
CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.118 2002/05/21 04:54:55 hal9 Exp $<BR></P
+>$Id: user-manual.sgml,v 1.121 2002/05/23 23:20:17 oes Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
><DT
>2.1.1. <A
HREF="installation.html#INSTALLATION-PACK-RPM"
->Red Hat, SuSE and Conectiva RPMs</A
+>Red Hat, SuSE RPMs and Conectiva</A
></DT
><DT
>2.1.2. <A
><DL
><DT
>5.1. <A
-HREF="startup.html#START-REDHATDEBIAN"
->RedHat, Conectiva and Debian</A
+HREF="startup.html#START-REDHAT"
+>RedHat and Conectiva</A
></DT
><DT
>5.2. <A
+HREF="startup.html#START-DEBIAN"
+>Debian</A
+></DT
+><DT
+>5.3. <A
HREF="startup.html#START-SUSE"
>SuSE</A
></DT
><DT
HREF="startup.html#START-WINDOWS"
>Windows</A
></DT
><DT
HREF="startup.html#START-UNICES"
>Solaris, NetBSD, FreeBSD, HP-UX and others</A
></DT
><DT
HREF="startup.html#START-OS2"
>OS/2</A
></DT
><DT
HREF="startup.html#START-MACOSX"
>MAX OSX</A
></DT
><DT
HREF="startup.html#START-AMIGAOS"
>AmigaOS</A
></DT
><DT
HREF="startup.html#CMDOPTIONS"
>Command Line Options</A
></DT
><DL
><DT
>6.1. <A
-HREF="configuration.html#AEN481"
+HREF="configuration.html#AEN501"
>Controlling <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><DL
><DT
>8.1. <A
-HREF="actions-file.html#AEN1527"
+HREF="actions-file.html#AEN1553"
>Finding the Right Mix</A
></DT
><DT
>8.2. <A
-HREF="actions-file.html#AEN1534"
+HREF="actions-file.html#AEN1560"
>How to Edit</A
></DT
><DT
><DD
><DL
><DT
+>22<A
+HREF="actions-file.html#AEN1591"
+></A
+></DT
+><DT
>8.4.1. <A
-HREF="actions-file.html#AEN1597"
+HREF="actions-file.html#AEN1624"
>The Domain Pattern</A
></DT
><DT
>8.4.2. <A
-HREF="actions-file.html#AEN1659"
+HREF="actions-file.html#AEN1686"
>The Path Pattern</A
></DT
></DL
><DT
>8.5.1. <A
HREF="actions-file.html#ADD-HEADER"
-><I
-CLASS="EMPHASIS"
->add-header</I
-></A
+>add-header</A
></DT
><DT
>8.5.2. <A
HREF="actions-file.html#BLOCK"
-><I
-CLASS="EMPHASIS"
->block</I
-></A
+>block</A
></DT
><DT
>8.5.3. <A
HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
-><I
-CLASS="EMPHASIS"
->crunch-incoming-cookies</I
-></A
+>crunch-incoming-cookies</A
></DT
><DT
>8.5.4. <A
HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
-><I
-CLASS="EMPHASIS"
->crunch-outgoing-cookies</I
-></A
+>crunch-outgoing-cookies</A
></DT
><DT
>8.5.5. <A
HREF="actions-file.html#DEANIMATE-GIFS"
-><I
-CLASS="EMPHASIS"
->deanimate-gifs</I
-></A
+>deanimate-gifs</A
></DT
><DT
>8.5.6. <A
HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
-><I
-CLASS="EMPHASIS"
->downgrade-http-version</I
-></A
+>downgrade-http-version</A
></DT
><DT
>8.5.7. <A
HREF="actions-file.html#FAST-REDIRECTS"
-><I
-CLASS="EMPHASIS"
->fast-redirects</I
-></A
+>fast-redirects</A
></DT
><DT
>8.5.8. <A
HREF="actions-file.html#FILTER"
-><I
-CLASS="EMPHASIS"
->filter</I
-></A
+>filter</A
></DT
><DT
>8.5.9. <A
HREF="actions-file.html#HANDLE-AS-IMAGE"
-><I
-CLASS="EMPHASIS"
->handle-as-image</I
-></A
+>handle-as-image</A
></DT
><DT
>8.5.10. <A
HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
-><I
-CLASS="EMPHASIS"
->hide-forwarded-for-headers</I
-></A
+>hide-forwarded-for-headers</A
></DT
><DT
>8.5.11. <A
HREF="actions-file.html#HIDE-FROM-HEADER"
-><I
-CLASS="EMPHASIS"
->hide-from-header</I
-></A
+>hide-from-header</A
></DT
><DT
>8.5.12. <A
HREF="actions-file.html#HIDE-REFERRER"
-><I
-CLASS="EMPHASIS"
->hide-referrer</I
-></A
+>hide-referrer</A
></DT
><DT
>8.5.13. <A
HREF="actions-file.html#HIDE-USER-AGENT"
-><I
-CLASS="EMPHASIS"
->hide-user-agent</I
-></A
+>hide-user-agent</A
></DT
><DT
>8.5.14. <A
HREF="actions-file.html#KILL-POPUPS"
-><I
-CLASS="EMPHASIS"
>kill-popups<A
NAME="KILL-POPUP"
></A
-></I
></A
></DT
><DT
>8.5.15. <A
HREF="actions-file.html#LIMIT-CONNECT"
-><I
-CLASS="EMPHASIS"
->limit-connect</I
-></A
+>limit-connect</A
></DT
><DT
>8.5.16. <A
HREF="actions-file.html#PREVENT-COMPRESSION"
-><I
-CLASS="EMPHASIS"
->prevent-compression</I
-></A
+>prevent-compression</A
></DT
><DT
>8.5.17. <A
HREF="actions-file.html#SEND-VANILLA-WAFER"
-><I
-CLASS="EMPHASIS"
->send-vanilla-wafer</I
-></A
+>send-vanilla-wafer</A
></DT
><DT
>8.5.18. <A
HREF="actions-file.html#SEND-WAFER"
-><I
-CLASS="EMPHASIS"
->send-wafer</I
-></A
+>send-wafer</A
></DT
><DT
>8.5.19. <A
HREF="actions-file.html#SESSION-COOKIES-ONLY"
-><I
-CLASS="EMPHASIS"
->session-cookies-only</I
-></A
+>session-cookies-only</A
></DT
><DT
>8.5.20. <A
HREF="actions-file.html#SET-IMAGE-BLOCKER"
-><I
-CLASS="EMPHASIS"
->set-image-blocker</I
-></A
+>set-image-blocker</A
></DT
><DT
>8.5.21. <A
-HREF="actions-file.html#AEN2593"
+HREF="actions-file.html#AEN2600"
>Summary</A
></DT
></DL
><DL
><DT
>8.7.1. <A
-HREF="actions-file.html#AEN2645"
+HREF="actions-file.html#AEN2652"
>default.action</A
></DT
><DT
>8.7.2. <A
-HREF="actions-file.html#AEN2799"
+HREF="actions-file.html#AEN2806"
>user.action</A
></DT
></DL
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN2902"
+HREF="filter-file.html#AEN2909"
>Filter File Tutorial</A
></DT
></DL
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN3096"
+HREF="copyright.html#AEN3103"
>License</A
></DT
><DT
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN3346"
+HREF="appendix.html#AEN3353"
><SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>Installation</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
CLASS="SECT3"
><A
NAME="INSTALLATION-PACK-RPM"
->2.1.1. Red Hat, SuSE and Conectiva RPMs</A
+>2.1.1. Red Hat, SuSE RPMs and Conectiva</A
></H3
><P
> RPMs can be installed with <TT
> If you have problems with failed dependencies, try rebuilding the SRC RPM:
<TT
CLASS="LITERAL"
->rpm --rebuild privoxy-2.9.15-1.src.rpm</TT
+>rpm --rebuild privoxy-2.9.15-1.src.rpm;</TT
>. This
will use your locally installed libraries and RPM version. </P
><P
>2.1.2. Debian</A
></H3
><P
-> FIXME.</P
+> DEBs can be installed with <TT
+CLASS="LITERAL"
+>dpkg -i
+ privoxy_2.9.15-1.deb</TT
+>, and will use
+ <TT
+CLASS="FILENAME"
+>/etc/privoxy</TT
+> for the location of configuration
+ files.</P
></DIV
><DIV
CLASS="SECT3"
>Introduction</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
>Quickstart to Using Privoxy</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
HREF="actions-file.html#AF-PATTERNS"
>patterns</A
> that use
- wildcards so they can apply potentially to a range of similar URLs.</P
+ wildcards so they can apply potentially to a range of similar URLs. The
+ actions, together with the URL patterns are called a section.</P
><P
-> When you connect to a website, the full path of the URL will either match one
- of the <SPAN
-CLASS="QUOTE"
->"actions"</SPAN
-> as defined in
- <SPAN
+> When you connect to a website, the full URL will either match one or more
+ of the sections as defined in <SPAN
CLASS="APPLICATION"
>Privoxy's</SPAN
-> configuration, or not. If so, then
- <SPAN
+> configuration,
+ or not. If so, then <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> will perform the action accordingly. If
- not, then nothing special happens. Futhermore, web pages may contain
- embedded, secondary URLs that your web browser will display as it parses the
+> will perform the
+ respective actions. If not, then nothing special happens. Futhermore, web
+ pages may contain embedded, secondary URLs that your web browser will
+ use to load additional components of the page, as it parses the
original page's HTML content. An ad image for instance, is just a URL
embedded in the page somewhere. The image itself may be on the same server,
or a server somewhere else on the Internet. Complex web pages will have many
such embedded URLs.</P
><P
-> The actions we need to know about for ad blocking are: <A
+> The actions we need to know about for ad blocking are: <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#BLOCK"
>block</A
->, <A
+></TT
+>, <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#HANDLE-AS-IMAGE"
>handle-as-image</A
->, and <A
+></TT
+>, and
+ <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#SET-IMAGE-BLOCKER"
>set-image-blocker</A
+></TT
>:</P
><P
> <P
><UL
><LI
><P
-> <A
+> <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#BLOCK"
-><I
-CLASS="EMPHASIS"
->block</I
-></A
+>block</A
+></TT
> - this action stops
any contact between your browser and any URL patterns that match this
action's configuration. It can be used for blocking ads, but also anything
that is determined to be unwanted. By itself, it simply stops any
- communication with the remote server. If this is the only action that
- matches for this particular URL, then <SPAN
+ communication with the remote server and sends <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> will
- display its own BLOCKED page to let you now what has happened.
+>'s
+ own built-in BLOCKED page instead to let you now what has happened.
</P
></LI
><LI
><P
-> <A
+> <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#HANDLE-AS-IMAGE"
-><I
-CLASS="EMPHASIS"
->handle-as-image</I
-></A
+>handle-as-image</A
+></TT
> -
- forces <SPAN
+ tells <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> to treat this URL as if it were
- an image. <SPAN
+> to treat this URL as an image.
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> knows about common image
- types (e.g. GIF), but there are many situations where this does not apply.
- So we'll force it. This is particularly important for ad blocking, since
- once we can treat it as an image, we can make more intelligent decisisions
- on how to handle it. There are some limitations to this though. For
- instance, you can't just force an image substituion for an entire HTML page
+>'s default configuration already does this
+ for all common image types (e.g. GIF), but there are many situations where this
+ is not as easy to determine. So we'll force it in these cases. This is particularly
+ important for ad blocking, since only if we know that it's an image, we can replace
+ it by an image instead of the BLOCKED page, which would only result in a
+ <SPAN
+CLASS="QUOTE"
+>"broken image"</SPAN
+> icon. There are some limitations to this though. For
+ instance, you can't just brute-force an image substituion for an entire HTML page
in most situations.
</P
></LI
><LI
><P
-> <A
+> <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#SET-IMAGE-BLOCKER"
-><I
-CLASS="EMPHASIS"
->set-image-blocker</I
-></A
-> -
- tells <SPAN
+>set-image-blocker</A
+></TT
+> - tells
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> what to display in place of
- an ad image that has hit a block rule. For this to come into play,
- the URL must match a block action somewhere in the configuration.
- <I
+> what to display in place of an ad image that
+ has hit a block rule. For this to come into play, the URL must match a
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#BLOCK"
+>block</A
+></TT
+> action somewhere in the
+ configuration, <I
CLASS="EMPHASIS"
->And</I
->, it must also either be of a known image type, or
- match an <A
+>and</I
+>, it must also match an
+ <TT
+CLASS="LITERAL"
+><A
HREF="actions-file.html#HANDLE-AS-IMAGE"
-><I
-CLASS="EMPHASIS"
->handle-as-image</I
-></A
->
- action.
+>handle-as-image</A
+></TT
+> action.
</P
><P
> The configuration options on what to display instead of the ad are:
> <I
CLASS="EMPHASIS"
>http://<URL></I
-> - A redirect to any URL of the
- user's choosing (advanced usage).
+> - A redirect to any image anywhere
+ of the user's choosing (advanced usage).
</TD
></TR
></TBODY
the special <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
+> editor at <A
HREF="http://config.privoxy.org/show-status"
TARGET="_top"
>http://config.privoxy.org/show-status</A
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN349"
+NAME="AEN356"
></A
><P
><B
></LI
><LI
><P
-> You should have an Actions section labeled <I
-CLASS="EMPHASIS"
->+block</I
->.
- If not, click the <SPAN
+> You should have a section with only
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#BLOCK"
+>block</A
+></TT
+> listed under
+ <SPAN
+CLASS="QUOTE"
+>"Actions:"</SPAN
+>.
+ If not, click a <SPAN
CLASS="QUOTE"
>"<SPAN
CLASS="GUIBUTTON"
->Edit</SPAN
+>Insert new section below</SPAN
>"</SPAN
-> button just
- under the word <SPAN
-CLASS="QUOTE"
->"Actions"</SPAN
->. This will bring up a list of all
- actions. Find <I
-CLASS="EMPHASIS"
->block</I
-> near the top, and click in the
+>
+ button, and in the new section that just appeared, click the
<SPAN
+CLASS="GUIBUTTON"
+>Edit</SPAN
+> button right under the word <SPAN
+CLASS="QUOTE"
+>"Actions:"</SPAN
+>.
+ This will bring up a list of all actions. Find
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#BLOCK"
+>block</A
+></TT
+> near the top, and click
+ in the <SPAN
CLASS="QUOTE"
>"Enabled"</SPAN
-> column, then
- <SPAN
+> column, then <SPAN
CLASS="QUOTE"
>"<SPAN
CLASS="GUIBUTTON"
>Submit</SPAN
>"</SPAN
-> just below the list.
+>
+ just below the list.
</P
></LI
><LI
><P
-> Now, in the <I
-CLASS="EMPHASIS"
->+block</I
-> actions section, click the
- <SPAN
+> Now, in the <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#BLOCK"
+>block</A
+></TT
+> actions section,
+ click the <SPAN
CLASS="QUOTE"
>"<SPAN
CLASS="GUIBUTTON"
CLASS="QUOTE"
>"<SPAN
CLASS="GUIMENUITEM"
->Copy Link
- Location</SPAN
+>Copy Link Location</SPAN
>"</SPAN
->. Remove the <TT
+>.
+ Remove the <TT
CLASS="LITERAL"
>http://</TT
-> at
- the beginning of the URL. Then, click
+> at the beginning of the URL. Then, click
<SPAN
CLASS="QUOTE"
>"<SPAN
CLASS="GUIBUTTON"
>Submit</SPAN
>"</SPAN
->.
+> (or
+ <SPAN
+CLASS="QUOTE"
+>"<SPAN
+CLASS="GUIBUTTON"
+>OK</SPAN
+>"</SPAN
+> if in a pop-up window).
</P
></LI
><LI
to now go to the <A
HREF="actions-file.html#ACT-EXAMPLES"
>Actions Files Tutorial</A
->.</P
+>.
+ The ideas explained thererin also apply to the web-based editor.</P
></DIV
></DIV
><DIV
>See Also</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
>Starting Privoxy</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
><H2
CLASS="SECT2"
><A
-NAME="START-REDHATDEBIAN"
->5.1. RedHat, Conectiva and Debian</A
+NAME="START-REDHAT"
+>5.1. RedHat and Conectiva</A
></H2
><P
>We use a script. Note that RedHat does not start Privoxy upon booting per
CLASS="FILENAME"
>/etc/privoxy/config</TT
> as its
-main configuration file. FIXME: Debian??</P
+main configuration file.</P
><P
> <TABLE
BORDER="0"
><H2
CLASS="SECT2"
><A
+NAME="START-DEBIAN"
+>5.2. Debian</A
+></H2
+><P
+> We use a script. Note that Debian starts Privoxy upon booting per
+ default. It will use the file
+ <TT
+CLASS="FILENAME"
+>/etc/privoxy/config</TT
+> as its main configuration
+ file.</P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+> # /etc/init.d/privoxy start</PRE
+></TD
+></TR
+></TABLE
+></P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
NAME="START-SUSE"
->5.2. SuSE</A
+>5.3. SuSE</A
></H2
><P
>We use a script. It will use the file <TT
CLASS="SECT2"
><A
NAME="START-WINDOWS"
->5.3. Windows</A
+>5.4. Windows</A
></H2
><P
>Click on the Privoxy Icon to start Privoxy. If no configuration file is
CLASS="SECT2"
><A
NAME="START-UNICES"
->5.4. Solaris, NetBSD, FreeBSD, HP-UX and others</A
+>5.5. Solaris, NetBSD, FreeBSD, HP-UX and others</A
></H2
><P
>Example Unix startup command:</P
CLASS="SECT2"
><A
NAME="START-OS2"
->5.5. OS/2</A
+>5.6. OS/2</A
></H2
><P
>FIXME.</P
CLASS="SECT2"
><A
NAME="START-MACOSX"
->5.6. MAX OSX</A
+>5.7. MAX OSX</A
></H2
><P
>FIXME.</P
CLASS="SECT2"
><A
NAME="START-AMIGAOS"
->5.7. AmigaOS</A
+>5.8. AmigaOS</A
></H2
><P
>FIXME.</P
CLASS="SECT2"
><A
NAME="CMDOPTIONS"
->5.8. Command Line Options</A
+>5.9. Command Line Options</A
></H2
><P
> <SPAN
>Templates</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
>Note to Upgraders</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
REL="HOME"
TITLE="Privoxy User Manual"
HREF="index.html"><LINK
projects / privoxy.git / commitdiff