X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fconfiguration.html;h=dc602a708bdf05354d903d74f4299ab8a493622f;hp=7b77fcd87f51145755a8b14e0d761acedd488b82;hb=473cfd051580edfa1e2a3f6beeb9a0d09a8253fd;hpb=e0dbf1d74567dc0bec4c358a3bab44ef62af4aa8 diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html index 7b77fcd8..dc602a70 100644 --- a/doc/webserver/user-manual/configuration.html +++ b/doc/webserver/user-manual/configuration.html @@ -1,13 +1,13 @@ +
Privoxy User Manual | Privoxy 3.0.9 User Manual|
---|---|
Prev | Next |
|
This should be self-explanatory. Note the first item leads to an editor for the - "actions list", which is where the ad, banner, cookie, - and URL blocking magic is configured as well as other advanced features of + actions files, which is where the ad, banner, + cookie, and URL blocking magic is configured as well as other advanced features of PrivoxyPrivoxy continues - to run as a proxy in this case, but all filtering is disabled. There + to run as a proxy in this case, but all manipulation is disabled, i.e. + Privoxy acts like a normal forwarding proxy. There is even a toggle BookmarkletPrivoxy with one click from your browser.
Note that several of the features described above are disabled by default + in Privoxy 3.0.7 beta and later. + Check the + configuration file to learn why + and in which cases it's safe to enable them again.
For Unix, *BSD and Linux, all configuration files are located in @@ -257,9 +288,12 @@ CLASS="APPLICATION" >
The main configuration file is named The configmain configuration file is named config on Linux, Unix, BSD, OS/2, and AmigaOS and (the main actions file) is used to define - the default settings for various ) + is used to define which "actions" relating to images, banners, - pop-ups, access restrictions, banners and cookies. +> relating to banner-blocking, images, pop-ups, + content modification, cookie handling etc should be applied by default. It also defines many + exceptions (both positive and negative) from this default set of actions that enable + Privoxy to selectively eliminate the junk, and only the junk, on + as many websites as possible.
Multiple actions files may be defined in config. These are processed in the order they are defined. Local customizations and locally - preferred exceptions to the default policies as defined in + preferred exceptions to the default policies as defined in default.action are probably best applied in +> (which you will most probably want + to define sooner or later) are probably best applied in user.action, which should be preserved across +>, where you can preserve them across upgrades. standard.action is also included. This is mostly - for is only for + Privoxy's internal use. @@ -311,23 +352,23 @@ CLASS="APPLICATION" > There is also a web based editor that can be accessed from http://config.privoxy.org/show-status/http://config.privoxy.org/show-status (Shortcut: http://p.p/show-status/http://p.p/show-status) for the various actions files.
The syntax of the configuration and filter files may change between different + Privoxy versions, unfortunately some enhancements cost backwards compatibility. +
All files use the "#" character to denote a - comment (the rest of the line will be ignored) angd understand line continuation + comment (the rest of the line will be ignored) and understand line continuation through placing a backslash ("\# in front of an otherwise valid configuration line to prevent it from being interpreted is called "commenting - out" that line.
The actions files and default.filter +> The actions files and filter files can use Perl style regular expressions"wake up" requests - must obviously be sent to the old listening address.
While under development, the configuration content is subject to change. @@ -411,6 +471,7 @@ CLASS="NAVFOOTER" >
Home | Next | Starting PrivoxyStarting Privoxy