X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fquickstart.html;h=f7e26a6fae7476265f260786d61ba652b089ad50;hp=8cb3e8c37c5387fced8bc25890a8daf8585a6eba;hb=3c890b0540031fa87cc28514b3e4d0e23124fbcd;hpb=51dd3416173631d3cdbd51bd35d8cf6a349e13c2 diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index 8cb3e8c3..f7e26a6f 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -1,13 +1,13 @@ +
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.
Ad blocking is but one of Privoxy's - array of features. Many of these features are for the technically minded advanced + array of features. Many of these features are for the technically minded advanced user. But, ad and banner blocking is surely common ground for everybody.
- 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.