X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fquickstart.html;h=32e54ebd7b24ec5c74fdd9e2bbb80fde7e61e417;hp=ca1147bc88dc7938ac2284ffc6dd58af96560d7e;hb=7ecdaff4e6e989eaa70d1ffec88c0e5dfbeb19bb;hpb=3438a9978a79dbb702e70e2e8a80d727f0ddd6e1 diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index ca1147bc..32e54ebd 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"> +HREF="../p_doc.css">
A default installation should provide a reasonable starting point for +> 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. + configuration, but that can be dealt with as the need arises. Little + 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.
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, problems with websites or to get - help. + help.
- This section will provide a quick summary of ad blocking so +> 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 recommended.
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. And the more likely that some things + more aggressive you are about it, the more likely you are to block + 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 + configuration to solve these unintended consequences. In short, there is not an easy way to eliminate all ads. Either take +> ads. Either take the easy way and settle for . "Actions" in this context, are +> in this context, are the directives we use to tell Privoxy to perform - some task relating to WWW transactions (i.e. web browsing). We tell + some task relating to HTTP transactions (i.e. web browsing). We tell PrivoxyPrivoxy's configuration, - followed by one or more URLs to which the action should apply. URLs + followed by one or more URLs to which the action should apply. URLs can actually be URL type patternshandle-as-image, +>, :
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 ). 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 @@ -636,12 +678,11 @@ CLASS="APPLICATION" >
A quick and simple step by step example:
Right click on the ad image to be blocked, then select +> Right click on the ad image to be blocked, then select "Copy Link Location" from the - pop-up menu. + pop-up menu.
Set your browser to +> Set your browser to Find user.action in the top section, and click +> in the top section, and click on "":
-
block listed under +> listed under "Actions:"Insert new section below" - button, and in the new section that just appeared, click the + button, and in the new section that just appeared, click the Edit
This is a very crude and simple example. There might be good reasons to use a +> 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 +>, and the entire actions concept, see the Actions @@ -820,17 +857,17 @@ HREF="actions-file.html#ACT-EXAMPLES" >. The ideas explained therein also apply to the web-based editor.
There are also various +> There are also various filters that can be used for ad blocking - (filters are a special subset of actions). These +> 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.