From: hal9 Date: Fri, 24 May 2002 23:19:23 +0000 (+0000) Subject: Include new image (Proxy setup). More fun with guibutton. X-Git-Tag: v_3_0_branchpoint~4 X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=commitdiff_plain;h=ec3786121a8db0be59e217dd794d61be9d9dc134 Include new image (Proxy setup). More fun with guibutton. Minor corrections/clarifications here and there. --- diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 5a6e0630..60ab2810 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -30,7 +30,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 1.121 2002/05/23 23:20:17 oes Exp $ + $Id: user-manual.sgml,v 1.122 2002/05/24 13:24:08 oes Exp $ Copyright (C) 2001, 2002 Privoxy Developers See LICENSE. @@ -56,7 +56,7 @@ -$Id: user-manual.sgml,v 1.121 2002/05/23 23:20:17 oes Exp $ +$Id: user-manual.sgml,v 1.122 2002/05/24 13:24:08 oes Exp $ - You can find the latest version of the user manual at User Manual at http://www.privoxy.org/user-manual/. Please see the Contact section on how to contact the developers. @@ -187,7 +187,7 @@ How to install the binary packages depends on your operating system: -Red Hat, SuSE RPMs and Conectiva +Red Hat, SuSE and Conectiva RPMs RPMs can be installed with rpm -Uvh privoxy-&p-version;-1.rpm, @@ -205,7 +205,7 @@ automatically start Privoxy in the boot process. If you have problems with failed dependencies, try rebuilding the SRC RPM: - rpm --rebuild privoxy-&p-version;-1.src.rpm;. This + rpm --rebuild privoxy-&p-version;-1.src.rpm. This will use your locally installed libraries and RPM version. @@ -540,7 +540,7 @@ automatically start Privoxy in the boot process. 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. + information provided below, though this is highly recommended. First a bit of a warning ... blocking ads is much like blocking SPAM: the @@ -580,7 +580,7 @@ automatically start Privoxy in the boot process. respective actions. If not, then nothing special happens. Futhermore, web pages may contain embedded, secondary URLs that your web browser will use to load additional components of the page, as it parses the - original page's HTML content. An ad image for instance, is just a URL + original page's HTML content. An ad image for instance, is just an 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. @@ -613,12 +613,13 @@ automatically start Privoxy in the boot process. tells Privoxy to treat this URL as an image. Privoxy's default configuration already does this for all common image types (e.g. GIF), but there are many situations where this - is not as easy to determine. So we'll force it in these cases. This is particularly - important for ad blocking, since only if we know that it's an image, we can replace - it by an image instead of the BLOCKED page, which would only result in a - broken image icon. There are some limitations to this though. For - instance, you can't just brute-force an image substituion for an entire HTML page - in most situations. + is not so easy to determine. So we'll force it in these cases. This is particularly + important for ad blocking, since only if we know that it's an image of + some kind, can we replace it with an image of our chosing, instead of the + Privoxy BLOCKED page (which would only result in + a broken image icon). There are some limitations to this + though. For instance, you can't just brute-force an image substituion for + an entire HTML page in most situations. @@ -708,7 +709,7 @@ automatically start Privoxy in the boot process. - Screenshot of Files in Use + [ Screenshot of Actions Files in Use ] @@ -780,15 +781,60 @@ automatically start Privoxy in the boot process. 127.0.0.1 (or localhost) for the proxy address, and port 8118 (earlier versions used port 8000). This is the one configuration step that must be done! + + + +
Proxy Configuration (Mozilla) + + + + + + [ Screenshot of Mozilla Proxy Configuration ] + + +
+ With Netscape (and - Mozilla), this can be set under Edit - -> Preferences -> Advanced -> Proxies -> HTTP Proxy. - For Internet Explorer: Tools -> - Internet Properties -> Connections -> LAN Setting. Then, - check Use Proxy and fill in the appropriate info (Address: - 127.0.0.1, Port: 8118). Include if HTTPS proxy support too. + Mozilla), this can be set under: + + + + + + Edit + |_ + Preferences + |_ + Advanced + |_ + Proxies + |_ + HTTP Proxy + + + + For Internet Explorer: + + + + + + Tools + |_ + Internet Properties + |_ + Connections + |_ + LAN Settings + + + + Then, check Use Proxy and fill in the appropriate info + (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL), if you want HTTPS + proxy support too. @@ -809,9 +855,9 @@ automatically start Privoxy in the boot process. RedHat and Conectiva -We use a script. Note that RedHat does not start Privoxy upon booting per -default. It will use the file /etc/privoxy/config as its -main configuration file. + We use a script. Note that RedHat does not start Privoxy upon booting per + default. It will use the file /etc/privoxy/config as + its main configuration file. @@ -1102,7 +1148,7 @@ must find a better place for this paragraph - Privoxy Menu +     Privoxy Menu @@ -5267,7 +5313,7 @@ shop = mercy-for-cookies -filter{popups} -kill-popups The first regular section is probably the most important. It has only one pattern, /, but this pattern - matches all URLs.. Therefore, the + matches all URLs. Therefore, the set of actions used in this default section will be applied to all requests as a start. It can be partly or wholly overridden by later matches further down this file, or in user.action, @@ -5278,7 +5324,7 @@ shop = mercy-for-cookies -filter{popups} -kill-popups Again, at the start of matching, all actions are disabled, so there is no real need to disable any actions here, but we will do that nonetheless, - to have a complete listing for your reference. (Remember: A + + to have a complete listing for your reference. (Remember: a + preceding the action name enables the action, a - disables!). Also note how this long line has been made more readable by splitting it into multiple lines with line continuation. @@ -5591,7 +5637,7 @@ www.ugu.com/sui/ugu/adv So far we are painting with a broad brush by setting general policies, which would be a reasonable starting point for many people. Now, - you'd maybe want to be more specific and have customized rules that + you might want to be more specific and have customized rules that are more suitable to your personal habits and preferences. These would be for narrowly defined situations like your ISP or your bank, and should be placed in user.action, which is parsed after all other @@ -6076,7 +6122,7 @@ s* industry[ -]leading \ and all pages of its web-based user interface, are generated from templates. (Privoxy must be running for the above links to work as - intended) + intended.) @@ -6992,7 +7038,7 @@ In file: user.action [ View ] [ Edit ] One last example. Let's try http://www.rhapsodyk.net/adsl/HOWTO/. - This one is giving us problems. We are getting a blank page. Hmmm... + This one is giving us problems. We are getting a blank page. Hmmm ... @@ -7142,6 +7188,9 @@ In file: user.action [ View ] [ Edit ] style.