X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fquickstart.html;h=c81f0131139e64734b899768e8fc37f7418cebd0;hp=e3f8711f34e9231c556db2e3c7c8fb75f549c22c;hb=3db7a58b2bbed7b6356b2a0600e93ec4f2846499;hpb=0212c18282eaa5f73843cbbec12c9137ea596e1c diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index e3f8711f..c81f0131 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -1,23 +1,28 @@ +
Privoxy User Manual | Privoxy 3.0.17 User Manual|
---|---|
Prev | Next |
pattern - a checkerboard pattern, so that an ad + replacement is obvious. This is the default. + |
blank - A very small empty GIF image is displayed. + This is the so-called "invisible" configuration option. + |
http://<URL> - A redirect to any image anywhere + of the user's choosing (advanced usage). + |
Advanced users will eventually want to explore Privoxy + filters as well. Filters + are very different from blocks. + A "block" blocks a site, page, or unwanted contented. Filters + are a way of filtering or modifying what is actually on the page. An example + filter usage: a text replacement of "no-no" for + "nasty-word". That is a very simple example. This process can be + used for ad blocking, but it is more in the realm of advanced usage and has + some pitfalls to be wary off.
The quickest way to adjust any of these settings is with your browser through + the special Privoxy editor at http://config.privoxy.org/show-status + (shortcut: http://p.p/show-status). This + is an internal page, and does not require Internet access.
Note that as of Privoxy 3.0.7 beta the + action editor is disabled by default. Check the + enable-edit-actions + section in the configuration file to learn why and in which + cases it's safe to enable again.
If you decided to enable the action editor, select the appropriate + "actions" file, and click + "Edit". It is best to put personal or + local preferences in user.action since this is not + meant to be overwritten during upgrades, and will over-ride the settings in + other files. Here you can insert new "actions", and URLs for ad + blocking or other purposes, and make other adjustments to the configuration. + Privoxy will detect these changes automatically.
A quick and simple step by step example:
Right click on the ad image to be blocked, then select + "Copy Link Location" from the + pop-up menu. +
Set your browser to + http://config.privoxy.org/show-status +
Find user.action in the top section, and click + on "Edit": +
Figure 1. Actions Files in Use
You should have a section with only + block listed under + "Actions:". + If not, click a "Insert new section below" + button, and in the new section that just appeared, click the + Edit button right under the word "Actions:". + This will bring up a list of all actions. Find + block near the top, and click + in the "Enabled" column, then "Submit" + just below the list.
If you experience problems with sites that Now, in the block actions section, + click the "misbehave", see - the Anatomy of an Action section in the - Appendix. +>"Add" button, and paste the URL the + browser got from "Copy Link Location". + Remove the http:// at the beginning of the URL. Then, click + "Submit" (or + "OK" if in a pop-up window).
Please see the section Contacting the - Developers on how to report bugs or problems with websites or to get - help. +> Now go back to the original page, and press SHIFT-Reload + (or flush all browser caches). The image should be gone now.
This is a very crude and simple example. There might be good reasons to use a + wildcard pattern match to include potentially similar images from the same + site. For a more extensive explanation of "patterns", and + the entire actions concept, see the Actions + section.
For advanced users who want to hand edit their config files, you might want + to now go to the Actions Files Tutorial. + The ideas explained therein also apply to the web-based editor.
There are also various + filters that can be used for ad blocking + (filters are a special subset of actions). These + fall into the "advanced" usage category, and are explained in + depth in later sections.