<link rel="NEXT" title="Miscellaneous" href="misc.html">
<link rel="STYLESHEET" type="text/css" href="../p_doc.css">
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
- <style type="text/css">
-body {
- background-color: #EEEEEE;
- color: #000000;
- }
- :link { color: #0000FF }
- :visited { color: #840084 }
- :active { color: #0000FF }
- a.c4 {font-style: italic}
- span.c3 {font-style: italic}
- table.c2 {background-color: #E0E0E0}
- hr.c1 {text-align: left}
- </style>
</head>
-<body class="SECT1">
+<body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
+"#840084" alink="#0000FF">
<div class="NAVHEADER">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
accesskey="N">Next</a></td>
</tr>
</table>
- <hr class="c1" width="100%">
+ <hr align="left" width="100%">
</div>
<div class="SECT1">
Configuration</a></h1>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN369" id="AEN369">3.1. What exactly is an
- <span class="QUOTE">"actions"</span> file?</a></h3>
+ <h3 class="SECT2"><a name="ACTIONSFILE" id="ACTIONSFILE">3.1. What
+ exactly is an <span class="QUOTE">"actions"</span> file?</a></h3>
<p><span class="APPLICATION">Privoxy</span> utilizes the concept of
<span class="QUOTE">" <a href=
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN392" id="AEN392">3.3. How are actions
- files configured? What is the easiest way to do this?</a></h3>
+ <h3 class="SECT2"><a name="ACTCONFIG" id="ACTCONFIG">3.3. How are
+ actions files configured? What is the easiest way to do this?</a></h3>
<p>Actions files are just text files in a special syntax and can be
edited with a text editor. But probably the easiest way is to access
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN401" id="AEN401">3.4. There are several
+ <h3 class="SECT2"><a name="AEN393" id="AEN393">3.4. There are several
different <span class="QUOTE">"actions"</span> files. What are the
differences?</a></h3>
<p>Based on your feedback and the continuing development, updates of
<tt class="FILENAME">default.action</tt> will be made available from
time to time on the <a href=
- "http://sourceforge.net/project/showfiles.php?group_id=11118" target=
+ "https://sourceforge.net/project/showfiles.php?group_id=11118" target=
"_top">files section</a> of our <a href=
- "http://sf.net/projects/ijbswa/" target="_top">project page</a>.</p>
+ "https://sourceforge.net/projects/ijbswa/" target="_top">project
+ page</a>.</p>
<p>If you wish to receive an email notification whenever we release
updates of <span class="APPLICATION">Privoxy</span> or the actions
file, <a href=
- "http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" target=
+ "https://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" target=
"_top">subscribe to our announce mailing list</a>,
ijbswa-announce@lists.sourceforge.net.</p>
</div>
configuration so complicated?</a></h3>
<p><span class="QUOTE">"Complicated"</span> is in the eye of the
- beholder. Those that are familiar with some of the underlying concepts,
- such as regular expression syntax, take to it like a fish takes to
- water. Also, software that tries hard to be <span class="QUOTE">"user
- friendly"</span>, often lacks sophistication and flexibility. There is
- always that trade-off there between power vs. easy-of-use. Furthermore,
- anyone is welcome to contribute ideas and implementations to enhance
- <span class="APPLICATION">Privoxy</span>.</p>
+ beholder.</p>
+
+ <p>Privoxy is currently mainly written by and for people who are
+ already familiar with the underlying concepts like regular expressions,
+ HTTP and HTML, or are willing to become familiar with them to be able
+ to get the most out of a powerful and flexible tool such as
+ Privoxy.</p>
+
+ <p>While everybody is expected to be able to get a Privoxy default
+ installation up and running, fine-tuning requires a certain amount of
+ background information and Privoxy's documentation mainly concentrates
+ on the Privoxy-specific parts while only providing references to the
+ rest.</p>
+
+ <p>If you or anyone you know has the skills, time and energy to reduce
+ the barrier of entry, please <a href="general.html#PARTICIPATE">get
+ involved</a>.</p>
</div>
<div class="SECT2">
cookie handling for them in the <tt class="FILENAME">user.action</tt>
file. An example for yahoo might look like:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
<p>These kinds of sites are often quite complex and heavy with <a href=
"http://en.wikipedia.org/wiki/Javascript" target="_top">Javascript</a>
and thus <span class="QUOTE">"fragile"</span>. So if <span class=
- "emphasis EMPHASIS c3">still</span> a problem, we have an <a href=
- "../user-manual/actions-file.html#ALIASES" target="_top">alias</a> just
- for such sticky situations:</p>
+ "emphasis"><i class="EMPHASIS">still</i></span> a problem, we have an
+ <a href="../user-manual/actions-file.html#ALIASES" target=
+ "_top">alias</a> just for such sticky situations:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
default action <span class="QUOTE">"profiles"</span> in the web based
actions file editor at <a href="http://config.privoxy.org/show-status"
target="_top">http://config.privoxy.org/show-status</a>. See the
- <a class="CITETITLE c4" href="../user-manual/actions-file.html" target=
- "_top">User Manual</a> for a list of actions, and how the default
- profiles are set.</p>
+ <a href="../user-manual/actions-file.html" target="_top"><i class=
+ "CITETITLE">User Manual</i></a> for a list of actions, and how the
+ default profiles are set.</p>
<p>Where the defaults are likely to break some sites, exceptions for
known popular <span class="QUOTE">"problem"</span> sites are included,
but in general, the more aggressive your default settings are, the more
exceptions you will have to make later. New users are best to start off
in <span class="QUOTE">"Cautious"</span> setting. This is safest and
- will have the fewest problems. See the <a class="CITETITLE c4" href=
- "../user-manual/index.html" target="_top">User Manual</a> for a more
- detailed discussion.</p>
+ will have the fewest problems. See the <a href=
+ "../user-manual/index.html" target="_top"><i class="CITETITLE">User
+ Manual</i></a> for a more detailed discussion.</p>
<p>It should be noted that the <span class="QUOTE">"Advanced"</span>
profile (formerly known as the <span class=
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN489" id="AEN489">3.11. What is the
- <tt class="FILENAME">default.filter</tt> file? What is a <span class=
- "QUOTE">"filter"</span>?</a></h3>
+ <h3 class="SECT2"><a name="FILTERFILE" id="FILTERFILE">3.11. What is
+ the <tt class="FILENAME">default.filter</tt> file? What is a
+ <span class="QUOTE">"filter"</span>?</a></h3>
<p>The <a href="../user-manual/filter-file.html" target=
"_top"><tt class="FILENAME">default.filter</tt></a> file is where
- <span class="emphasis EMPHASIS c3">filters</span> as supplied by the
- developers are defined. Filters are a special subset of actions that
- can be used to modify or remove web page content or headers on the fly.
- Content filters can be applied to <span class=
- "emphasis EMPHASIS c3">anything</span> in the page source, header
- filters can be applied to either server or client headers. Regular
- expressions are used to accomplish this.</p>
+ <span class="emphasis"><i class="EMPHASIS">filters</i></span> as
+ supplied by the developers are defined. Filters are a special subset of
+ actions that can be used to modify or remove web page content or
+ headers on the fly. Content filters can be applied to <span class=
+ "emphasis"><i class="EMPHASIS">anything</i></span> in the page source,
+ header filters can be applied to either server or client headers.
+ Regular expressions are used to accomplish this.</p>
<p>There are a number of pre-defined filters to deal with common
annoyances. The filters are only defined here, to invoke them, you need
MIME types, but if you know better than Privoxy what should or should
not be filtered you can filter any content you like.</p>
- <p>Filters should <span class="emphasis EMPHASIS c3">not</span> be
- confused with <a href="../user-manual/actions-file.html#BLOCK" target=
- "_top"><tt class="LITERAL">blocks</tt></a>, which is a completely
- different action, and is more typically used to block ads and unwanted
- sites.</p>
+ <p>Filters should <span class="emphasis"><i class=
+ "EMPHASIS">not</i></span> be confused with <a href=
+ "../user-manual/actions-file.html#BLOCK" target="_top"><tt class=
+ "LITERAL">blocks</tt></a>, which is a completely different action, and
+ is more typically used to block ads and unwanted sites.</p>
<p>If you are familiar with regular expressions, and HTML, you can look
at the provided <tt class="FILENAME">default.filter</tt> with a text
"_top">enable-edit-actions</a>).</p>
<p>If you intend to develop your own filters, you might want to have a
- look at <a href="http://www.fabiankeil.de/sourcecode/pft/" target=
+ look at <a href="https://www.fabiankeil.de/sourcecode/pft/" target=
"_top">Privoxy-Filter-Test</a>.</p>
</div>
<span class="APPLICATION">Privoxy</span> on port 8118, this line should
look like:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
<p>Alternately, you can have <span class="APPLICATION">Privoxy</span>
listen on all available interfaces:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN540" id="AEN540">3.13. Instead of ads,
+ <h3 class="SECT2"><a name="NOSEEUM" id="NOSEEUM">3.13. Instead of ads,
now I get a checkerboard pattern. I don't want to see
anything.</a></h3>
your choice. Note that this choice only has effect for images which are
blocked as images, i.e. whose URLs match both a <tt class=
"LITERAL"><a href="../user-manual/actions-file.html#HANDLE-AS-IMAGE"
- target="_top">handle-as-image</a></tt> <span class=
- "
emphasis EMPHASIS c3">and</span> <tt class="LITERAL"><a href=
+ target="_top">handle-as-image</a></tt> <span class="emphasis"><i class=
+ "
EMPHASIS">and</i></span> <tt class="LITERAL"><a href=
"../user-manual/actions-file.html#BLOCK" target="_top">block</a></tt>
action.</p>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN557" id="AEN557">3.14. Why would anybody
- want to see a checkerboard pattern?</a></h3>
+ <h3 class="SECT2"><a name="WHYSEEUM" id="WHYSEEUM">3.14. Why would
+ anybody want to see a checkerboard pattern?</a></h3>
<p>Remember that <a href="general.html#WHATSANAD">telling which image
is an ad and which isn't</a>, is an educated guess. While we hope that
navigation aid or otherwise innocent image was erroneously blocked. It
is recommended for new users so they can <span class=
"QUOTE">"see"</span> what is happening. Some people might also enjoy
- seeing how many banners they <span class=
- "emphasis EMPHASIS c3">don't</span> have to see.</p>
+ seeing how many banners they <span class="emphasis"><i class=
+ "EMPHASIS">don't</i></span> have to see.</p>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN563" id="AEN563">3.15. I see some images
- being replaced with text instead of the checkerboard image. Why and how
- do I get rid of this?</a></h3>
+ <h3 class="SECT2"><a name="BLOCKEDBYTEXT" id="BLOCKEDBYTEXT">3.15. I
+ see some images being replaced with text instead of the checkerboard
+ image. Why and how do I get rid of this?</a></h3>
<p>This happens when the banners are not embedded in the HTML code of
the page itself, but in separate HTML (sub)documents that are loaded
<p>Earlier 3.x versions could run as a system service using <b class=
"COMMAND">srvany.exe</b>. See the discussion at <a href=
- "http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118"
+ "https://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118"
target=
- "_top">http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118</a>,
+ "_top">https://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&group_id=11118</a>,
for details, and a sample configuration.</p>
</div>
<p>For a good discussion of some of the issues involved (including
privacy and security issues), see <a href=
- "http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118"
+ "https://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118"
target=
- "_top">http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118</a>.</p>
+ "_top">https://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118</a>.</p>
</div>
<div class="SECT2">
browsing habits for their own purposes, and maybe to your potential
detriment. Such sites are using you and storing their data on your
system. That is why the privacy conscious watch from whom those cookies
- come, and why they really <span class=
- "emphasis EMPHASIS c3">need</span> to be there.</p>
+ come, and why they really <span class="emphasis"><i class=
+ "EMPHASIS">need</i></span> to be there.</p>
<p>See the <a href="http://en.wikipedia.org/wiki/Browser_cookie"
target="_top">Wikipedia cookie definition</a> for more.</p>
unrestricted, both in and out, for <tt class=
"LITERAL">example.com</tt>:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
<p>Sure. There are a couple of things you can do for simple
white-listing. Here's one real easy one:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
<tt class="FILENAME">default.action</tt> file from scratch without the
many ad blocking rules, and corresponding exceptions. Or lastly, if you
are not concerned about the additional blocks that are done for privacy
- reasons, you can very easily over-ride <span class=
- "emphasis EMPHASIS c3">all</span> blocking with the following very
- simple rule in your <tt class="FILENAME">user.action</tt>:</p>
+ reasons, you can very easily over-ride <span class="emphasis"><i class=
+ "EMPHASIS">all</i></span> blocking with the following very simple rule
+ in your <tt class="FILENAME">user.action</tt>:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
<p>Or even a more comprehensive reversing of various ad related
actions:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
<div class="SECT2">
<h3 class="SECT2"><a name="TEMPLATES" id="TEMPLATES">3.29. How can I
- have custom template pages, like the <span class=
- "emphasis EMPHASIS c3">BLOCKED</span> page?</a></h3>
+ have custom template pages, like the <span class="emphasis"><i class=
+ "EMPHASIS">BLOCKED</i></span> page?</a></h3>
<p><span class="APPLICATION">Privoxy</span> <span class=
"QUOTE">"templates"</span> are specialized text files utilized by
<div class="SECT2">
<h3 class="SECT2"><a name="BLOCKALL" id="BLOCKALL">3.30. How can I
remove the <span class="QUOTE">"Go There Anyway"</span> link from the
- <span class="emphasis EMPHASIS c3">BLOCKED</span> page?</a></h3>
+ <span class="emphasis"><i class="EMPHASIS">BLOCKED</i></span>
+ page?</a></h3>
<p>There is more than one way to do it (although Perl is not
involved).</p>
that are available as compile-time options. You should <b class=
"COMMAND">configure</b> the sources as follows:</p>
- <table class="c2" border="0" width="100%">
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
</div>
<div class="NAVFOOTER">
- <hr class="c1" width="100%">
+ <hr align="left" width="100%">
<table summary="Footer navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
projects / privoxy.git / blobdiff