X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fquickstart.html;h=f342399ba3a9ca519a6ec05d3b0f80c8ecf86247;hp=cf3eebe67c061d3c4d5afb00c19197345214831e;hb=e61fdec519cef582a2dc5507543a006b539ad3f4;hpb=80b13c5019d561424b3ed8224b6dc4e830e24f67 diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index cf3eebe6..f342399b 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -4,19 +4,22 @@ >Quickstart to Using Privoxy + +
Privoxy 3.0.7 User Manual4. Quickstart to Using Privoxy4. Quickstart to Using Privoxy

4.1. Quickstart to Ad Blocking4.1. Quickstart to Ad Blocking

Ad blocking is but one of This section will provide a quick summary of ad blocking so you can get up to speed quickly without having to read the more extensive - information provided below, though this is highly recommeneded.

First a bit of a warning ... blocking ads is much like blocking SPAM: the more aggressive you are about it, the more likely you are to block - things that were not intended. So there is a trade off here. If you want + things that were not intended. And the more likely that some things + may not work as intended. So there is a trade off here. If you want extreme ad free browsing, be prepared to deal with more "problem" sites, and to spend more time adjusting the configuration to solve these unintended consequences. In short, there is - not an easy way to eliminate all ads. Either take - the easy way and settle for most ads blocked with the default configuration, or jump in and tweak it for your personal surfing habits and preferences.

Privoxy to perform - some task relating to HTTP transactions (i.e. web browsing). We tell + some task relating to WWW transactions (i.e. web browsing). We tell PrivoxyPrivoxy will perform the - respective actions. If not, then nothing special happens. Futhermore, web + respective actions. If not, then nothing special happens. Furthermore, 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 + original page's HTML content. An ad image for instance, is just an 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.

Privoxy can deal with each URL individually, so, for + instance, the main page text is not touched, but images from such-and-such + server are blocked.

The actions we need to know about for ad blocking are: The most important actions for basic ad blocking are: handle-as-image, and +>, + handle-as-empty-document,and block - 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 and sends - this is perhaps + the single most used action, and is particularly important for ad blocking. + 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 and sends + Privoxy's - own built-in BLOCKED page instead to let you now what has happened. +>'s own built-in BLOCKED page instead to + let you now what has happened (with some exceptions, see below).

  • Privoxy'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 + is not so 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 of + some kind, can we replace it with an image of our choosing, instead of the Privoxy BLOCKED page (which would only result in + a "broken image" 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. +> icon). There are some limitations to this + though. For instance, you can't just brute-force an image substitution for + an entire HTML page in most situations. +

  • handle-as-empty-document - + sends an empty document instead of Privoxy's + normal BLOCKED HTML page. This is useful for file types that are neither + HTML nor images, such as blocking JavaScript files.

  • block action somewhere in the - configuration, and, it must also match an

    • @@ -742,7 +818,19 @@ HREF="actions-file.html" HREF="actions-file.html#ACT-EXAMPLES" >Actions Files Tutorial. - The ideas explained thererin 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.

    Privoxy User Manual
    PrevNext
           pattern - a checkboard pattern, so that an ad +> - 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
           http://<URL> - A redirect to any image anywhere of the user's choosing (advanced usage).
    PrevNote to UpgradersWhat's New in this ReleaseStarting Privoxy
    HomeNext
    Starting Privoxy