From 1476ac19503b5f64f2cb694ef96fde2ecd64b849 Mon Sep 17 00:00:00 2001 From: hal9 Date: Tue, 21 May 2002 04:54:55 +0000 Subject: [PATCH] -New Section: Quickstart to Ad Blocking -Reformat Actions Anatomy to match new CGI layout --- doc/source/user-manual.sgml | 275 +++++++++++++++++++++++++++++------- 1 file changed, 224 insertions(+), 51 deletions(-) diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index e2a2a7d1..3829fc67 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -21,7 +21,7 @@ - + ]> - Quickstart to Ad Blocking Ad blocking is but one of Privoxy's array of features. Many of these features are for the technically minded advanced - user. But, ad blocking is surely common ground for everybody. + user. But, ad and banner blocking is surely common ground for everybody. - This section will provide a quick overview 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 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 a few + 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 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. + 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. - Secondly, a quick note on Privoxy's + Secondly, a brief explanation of Privoxy's actions. Actions in this context, are the directives we use to tell Privoxy to perform some task relating to HTTP transactions (i.e. web browsing). We tell @@ -566,21 +571,22 @@ automatically start Privoxy in the boot process. When you connect to a website, the full path of the URL will either match one - of actions as defined in Privoxy's configuration, - or not. If so, then Privoxy will perform the - action accordingly. If not, then nothing special happens. Futhermore, web - pages may contain embedded, secondary URLs that your web browser will - display as it parses the original page's HTML content. An ad image for - instance, is just a 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. + of the actions as defined in + Privoxy's configuration, or not. If so, then + Privoxy will perform the action accordingly. If + not, then nothing special happens. Futhermore, web pages may contain + embedded, secondary URLs that your web browser will display as it parses the + original page's HTML content. An ad image for instance, is just a 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. The actions we need to know about for ad blocking are: block, handle-as-image, and set-image-blocker. + linkend="set-image-blocker">set-image-blocker: @@ -593,7 +599,7 @@ automatically start Privoxy in the boot process. 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. If this is the only action that - matches for a particular URL, then Privoxy will + matches for this particular URL, then Privoxy will display its own BLOCKED page to let you now what has happened. @@ -642,7 +648,7 @@ automatically start Privoxy in the boot process.    http://<URL> - A redirect to any URL of the - user's choosing. + user's choosing (advanced usage). @@ -650,8 +656,107 @@ automatically start Privoxy in the boot process. + + 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. 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: + + + + +
Actions Files in Use + + + + + + Screenshot of Files in Use + + +
+ + + + + + You should have an Actions section labeled +block. + If not, click the Edit button just + 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. + + + + + Now, in the +block actions section, click the + 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. + + + + + 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. + + -]]> @@ -6675,19 +6780,38 @@ Requests Matches for http://google.com: ---- File standard --- -(no matches in this file) - ---- File default --- - -{ -add-header -block +deanimate-gifs{last} -downgrade-http-version +fast-redirects - -filter{popups} -filter{fun} -filter{shockwave-flash} -filter{crude-parental} - +filter{html-annoyances} +filter{js-annoyances} +filter{content-cookies} - +filter{webbugs} +filter{refresh-tags} +filter{nimda} +filter{banners-by-size} - +hide-forwarded-for-headers +hide-from-header{block} +hide-referer{forge} - -hide-user-agent -handle-as-image +set-image-blocker{pattern} -limit-connect - +prevent-compression +session-cookies-only -crunch-outgoing-cookies - -crunch-incoming-cookies -kill-popups -send-vanilla-wafer -send-wafer } + In file: default.action [ View ] [ Edit ] + +{-add-header + -block + -crunch-outgoing-cookies + -crunch-incoming-cookies + +deanimate-gifs{last} + -downgrade-http-version + +fast-redirects + -filter{popups} + -filter{fun} + -filter{shockwave-flash} + -filter{crude-parental} + +filter{html-annoyances} + +filter{js-annoyances} + +filter{content-cookies} + +filter{webbugs} + +filter{refresh-tags} + +filter{nimda} + +filter{banners-by-size} + +hide-forwarded-for-headers + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent + -handle-as-image + -kill-popups + -limit-connect + +prevent-compression + -send-vanilla-wafer + -send-wafer + +session-cookies-only + +set-image-blocker{pattern} } / { -session-cookies-only } @@ -6696,7 +6820,7 @@ Requests { -fast-redirects } .google.com ---- File user --- +In file: user.action [ View ] [ Edit ] (no matches in this file) @@ -6750,14 +6874,37 @@ Requests Final results: - -add-header -block +deanimate-gifs{last} -downgrade-http-version -fast-redirects - -filter{popups} -filter{fun} -filter{shockwave-flash} -filter{crude-parental} - +filter{html-annoyances} +filter{js-annoyances} +filter{content-cookies} - +filter{webbugs} +filter{refresh-tags} +filter{nimda} +filter{banners-by-size} - +hide-forwarded-for-headers +hide-from-header{block} +hide-referer{forge} - -hide-user-agent -handle-as-image +set-image-blocker{pattern} -limit-connect - +prevent-compression -session-cookies-only -crunch-outgoing-cookies - -crunch-incoming-cookies -kill-popups -send-vanilla-wafer -send-wafer + + -add-header + -block + -crunch-outgoing-cookies + -crunch-incoming-cookies + +deanimate-gifs{last} + -downgrade-http-version + -fast-redirects + -filter{popups} + -filter{fun} + -filter{shockwave-flash} + -filter{crude-parental} + +filter{html-annoyances} + +filter{js-annoyances} + +filter{content-cookies} + +filter{webbugs} + +filter{refresh-tags} + +filter{nimda} + +filter{banners-by-size} + +hide-forwarded-for-headers + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent + -handle-as-image + -kill-popups + -limit-connect + +prevent-compression + -send-vanilla-wafer + -send-wafer + -session-cookies-only + +set-image-blocker{pattern} @@ -6819,13 +6966,34 @@ Requests Matches for http://www.rhapsodyk.net/adsl/HOWTO/: - { -add-header -block +deanimate-gifs -downgrade-http-version +fast-redirects - +filter{html-annoyances} +filter{js-annoyances} +filter{kill-popups} - +filter{webbugs} +filter{nimda} +filter{banners-by-size} +filter{hal} - +filter{fun} +hide-forwarded-for-headers +hide-from-header{block} - +hide-referer{forge} -hide-user-agent -handle-as-image +set-image-blocker{blank} - +prevent-compression +session-cookies-only -crunch-incoming-cookies - -crunch-outgoing-cookies +kill-popups -send-vanilla-wafer -send-wafer } + In file: default.action [ View ] [ Edit ] + + {-add-header + -block + -crunch-incoming-cookies + -crunch-outgoing-cookies + +deanimate-gifs + -downgrade-http-version + +fast-redirects + +filter{html-annoyances} + +filter{js-annoyances} + +filter{kill-popups} + +filter{webbugs} + +filter{nimda} + +filter{banners-by-size} + +filter{hal} + +filter{fun} + +hide-forwarded-for-headers + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent + -handle-as-image + +kill-popups + +prevent-compression + -send-vanilla-wafer + -send-wafer + +session-cookies-only + +set-image-blocker{blank} } / { +block +handle-as-image } @@ -6940,6 +7108,11 @@ Requests Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: user-manual.sgml,v $ + Revision 1.117 2002/05/17 13:56:16 oes + - Reworked & extended Templates chapter + - Small changes to Regex appendix + - #included authors.sgml into (C) and hist chapter + Revision 1.116 2002/05/17 03:23:46 hal9 Fixing merge conflict in Quickstart section. -- 2.39.2