From b24c3bc114013ab7efc110849fd8b7d097a001ab Mon Sep 17 00:00:00 2001 From: hal9 Date: Mon, 29 Apr 2002 03:08:43 +0000 Subject: [PATCH] -Added new Q/A on new actions file set up (pointer to u-m) -Fixed a few broken links and converted old actions as a result of recent changes. --- doc/source/faq.sgml | 153 ++++++++++++++++++++++++++------------------ 1 file changed, 92 insertions(+), 61 deletions(-) diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index 97e9eddc..9b03b068 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -22,7 +22,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: faq.sgml,v 1.50 2002/04/26 05:25:23 hal9 Exp $ + $Id: faq.sgml,v 1.51 2002/04/26 17:24:31 swa Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -60,7 +60,7 @@ Privoxy Frequently Asked Questions -$Id: faq.sgml,v 1.50 2002/04/26 05:25:23 hal9 Exp $ +$Id: faq.sgml,v 1.51 2002/04/26 17:24:31 swa Exp $ @@ -482,7 +482,7 @@ All the ads are there. What's wrong? actions files are where various actions that Privoxy might take, are configured. Typically, you would define a set of default actions that apply - to all URLs, then add exceptions to these defaults. + to all URLs, then add exceptions to these defaults where needed. @@ -494,6 +494,8 @@ All the ads are there. What's wrong? site, we would define this in our actions file. + @@ -509,7 +511,7 @@ All the ads are there. What's wrong? some of these actions. These are all explained in the - user-manual. + user-manual. Please refer to that. @@ -523,7 +525,7 @@ way to do this? The easiest way to do this, is to access Privoxy with your web browser at http://p.p/, and then select - "Edit the actions list" + "View & change the current configuration" from the selection list. You can also do this by editing the appropriate file with a text editor. @@ -531,13 +533,36 @@ way to do this? Please see the user-manual for a + url="../user-manual/actions-file.html">user-manual for a detailed explanation of these and other configuration files, and their various options and syntax. + + +There are several different <quote>actions</quote> files. What are +the differences? + + As of Privoxy v2.9.15, three actions files + are being included, to be used for + different purposes. These are + default.action, standard.action, + and user.action. Please see + the User Manual + for an explanation of each. + + + + Earlier versions included three different versions + default.action files. The new scheme allows for + greater flexibility of local configuration, and for browser based + configuration. + + + + of a checkerboard - pattern, a transparent 1x1 GIF image (aka blank), or a custom - URL of your choice. Note that to fit this category, the URL must match both - the +image and +block actions. + Privoxy is stopping. You have the choice of a + checkerboard pattern, a transparent 1x1 GIF image (aka blank), + or a custom URL of your choice. Note that to fit this category, the URL must + match both the +handle-as-image + and + +block actions. - - If you want to see nothing, then change the +image-blocker + If you want to see nothing, then change the + +set-image-blocker action to +image-blocker{blank}. This can be done from the - Edit Actions List selection at View & change the current configuration selection at http://p.p/. Or by hand editing the appropriate actions file. This will only effect what is defined as images though. Also, some URLs that generate the bright red Blocked - banner, can be moved to the +image-blocker section for the + banner, can be moved to the +set-image-blocker section for the same reason, but there are some limits and risks to this (see below). @@ -831,23 +859,27 @@ problem. Blocked. Why and how do I get rid of this? These are URLs that match something in one of - Privoxy's block actions (+block). It is meant - to be a warning so that you know something has been blocked and an easy way - for you to see why. These are handled differently than what has been defined - explicitly as images (e.g. ad banners). Depending on the - URL itself, it is sometimes hard for Privoxy to - really know whether there is indeed an ad image there or not. And there are - limitations as to what Privoxy can do to - fool the browser. + Privoxy's block actions + (+block). + It is meant to be a warning so that you know something has been blocked and + an easy way for you to see why. These are handled differently than what has + been defined explicitly as images (e.g. ads that are GIF image + files). Depending on the URL itself, it is sometimes hard for + Privoxy to really know whether there is indeed an + ad image there or not. And there are limitations as to what + Privoxy can do to fool the + browser. For instance, if the ad is in a frame, then it is embedded in the separate HTML page used for the frame. In this case, you cannot just substitute an - aribitray image (like we would for a blank image), for an HTML + aribitrary image (like we would for a blank image), for an HTML page. The browser is expecting an HTML page, and that is what it must have - for frames. So this situation can be a little trickier to deal with, and - Privoxy will use the Blocked page. + for frames. Such situations can be a little trickier to deal with, and + Privoxy may show the Blocked page, + despite your best efforts. @@ -873,20 +905,26 @@ problem. Another way to deal with this is find why and where Privoxy is blocking the frame, and - diable this. Then let the +image-blocker action + diable this. Then let the +set-image-blocker action handle the ad that is embedded in the frame's HTML page. -I cannot see all of the <quote>Blocked</quote> page banner. All I -see is a bright red square. +I cannot see all of the <quote>Blocked</quote> page banner. Help. + + There is not enough available space to fit the entire Blocked page. Try right + clicking on the visible portion, and select Show Frame, + or equivalent. This will usually allow you to see the entire Privoxy + Blocked page, and from there you can see just what is being + blocked, and why. + - There is not enough space to fit the entire page. Try right clicking on the - visible, red portion, and select Show Frame, or equivalent. - This will usually allow you to see the entire Privoxy Blocked - page, and from there you can see just what is being blocked, and why. + As of Privoxy 2.9.14, the Blocked banner page is re-sizeable, and tries + to adjust to the allotted space. There may be occassions where there + just isn't enough room to display much of anything useful though. + @@ -914,7 +952,7 @@ on Win2K/NT? proxies like Squid? This can be done. See the user manual, + url="../user-manual/config.html#FORWARDING">user manual, which describes how to do this. @@ -952,21 +990,17 @@ has to add extra time to browsing. I noticed considerable delays in page requests compared to the old Junkbuster. What's wrong? -Using the default filtering configuration, I noticed considerable delays in -page requests compared to the old Junkbuster. Loading pages with large contents -seemed to take forever, then suddenly delivering all the content at once. - - -The whole content must be loaded in order to filter, and nothing is is -sent to the browser during this time. The loading time does not really -change in real numbers, but the feeling is different, because most -browsers are able to start rendering incomplete content, giving the -user a feeling of "it works". +The entire page content must be loaded into memory in order for the filtering +mechanism to work, and nothing is sent to the browser during this time. The +loading time does not really change in real numbers, but the feeling is +different, because most browsers are able to start rendering incomplete +content, giving the user a feeling of "it works". -To modify the content of a page (i.e. make frames resizeable again, etc.) and -not just replace ads, Privoxy needs to download the -entire page first, do its content magic and then send the page to the browser. + To modify the content of a page (i.e. make frames resizeable again, etc.) and + not just replace ads, Privoxy needs to download + the entire page first, do its content magic and then send the page to the + browser. @@ -1320,15 +1354,16 @@ What can I do? by disabling Privoxy filtering and blocking. Go to http://p.p/ and click on Toggle Privoxy On or Off, then disable it. Now try that - page again. It's probably a good idea to flush the browser cache as well. + page again. It's probably a good idea to flush the browser cache as well + with Shift+Reload to flush caches. If still a problem, go to Show which actions apply to a URL and why from http://p.p/ and paste the full URL of the page in question into the prompt. See which actions are - being applied to the URL. Now, armed with this information, go to Edit - the actions list. Here you should see various sections that have + being applied to the URL. Now, armed with this information, go to + View & change the current configuration. Here you should see various sections that have various Privoxy features disabled for specific sites. Most disabled actions will have a - (minus sign) in front of them. Some aliases are used just to disable other actions, @@ -1338,7 +1373,7 @@ What can I do? is causing the problem. Rember to flush your browser's caches when making such changes! As a last resort, try fragile which disables most actions. Now re-try the page. There might be some trial and - error involved. This is discussed in a little more detail in the user-manual appendix. @@ -1350,13 +1385,6 @@ What can I do? - -What time is it? - - Time for you to go! - - -