X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fquickstart.html;h=9591320bb605b3ca9670c46a80aaf23996856c81;hp=1237292300ae3751779ae3a205cdf905f580b7f5;hb=322389db65561716cdc35949eea8ae911f8a0aa8;hpb=d74ec2c8f9726f42df2ce1e45749d74dee43b781 diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index 12372923..9591320b 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -1,13 +1,13 @@ + Quickstart to Using Privoxy + +Privoxy 3.0.4 User ManualPrivoxy 3.0.11 User Manual4. Quickstart to Using Privoxy4. Quickstart to Using Privoxy

Privoxy as HTTP and - HTTPS (SSL) proxy by setting the proxy configuration for address of + HTTPS (SSL) proxy + by setting the proxy configuration for address of 127.0.0.18118. - (Junkbuster and earlier versions of Privoxy used port 8000.) See the section Starting Privoxy below - for more details on this. +CLASS="emphasis" +>DO NOT activate proxying for FTP or + any protocols besides HTTP and HTTPS (SSL) unless you intend to prevent your + browser from using these protocols.

  • Privoxy to manage cookies, you should - remove any currently stored cookies too. +> to manage + cookies, + you should remove any currently stored cookies too.

  • A default installation should provide a reasonable starting point for most. There will undoubtedly be occasions where you will want to adjust the configuration, but that can be dealt with as the need arises. Little - to no initial configuration is required in most cases. + to no initial configuration is required in most cases, you may want + to enable the + web-based action editor though. + Be sure to read the warnings first.

    See the Configuration section for more configuration options, and how to customize your installation. -

    next section for a quick + introduction to how Privoxy blocks ads and + banners.

  • If you experience ads that slipped through, innocent images that are +> If you experience ads that slip through, innocent images that are blocked, or otherwise feel the need to fine-tune Privoxy's behaviour, take a look at the behavior, take a look at the actions files. As a quick start, you might @@ -207,10 +231,10 @@ TARGET="_top" CLASS="QUOTE" >"Anatomy of an +>Troubleshooting: Anatomy of an Action" has hints how to debug actions that +> has hints on how to understand and debug actions that "misbehave"

  • For easy access to Privoxy's most important controls, drag the provided - Bookmarklets into your browser's - personal toolbar. -

  • Please see the section Contacting the Developers on how to report bugs or problems with websites or to get +> on how to report bugs, problems with websites or to get help.

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

    Ad blocking is but one of

    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 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).

  • 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. +

  • set-image-blocker

    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 http://p.p/show-status). This - is an internal page, and does not require Internet access. Select the - appropriate

    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 @@ -632,7 +727,7 @@ CLASS="GUIBUTTON" >

    @@ -771,6 +866,18 @@ HREF="actions-file.html#ACT-EXAMPLES" >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.

    Starting PrivoxyStarting Privoxy