1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
10 TITLE="Privoxy 3.0.3 User Manual"
11 HREF="index.html"><LINK
13 TITLE="The Filter File"
14 HREF="filter-file.html"><LINK
16 TITLE="Contacting the Developers, Bug Reporting and Feature
18 HREF="contact.html"><LINK
21 HREF="../p_doc.css"></HEAD
32 SUMMARY="Header navigation table"
41 >Privoxy 3.0.3 User Manual</TH
49 HREF="filter-file.html"
84 > built-in pages, i.e. error pages such as the
86 HREF="http://show-the-404-error.page"
90 >"404 - No Such Domain"</SPAN
94 HREF="http://ads.bannerserver.example.com/nasty-ads/sponsor.html"
102 and all pages of its <A
103 HREF="http://config.privoxy.org/"
107 >, are generated from <SPAN
117 > must be running for the above links to work as
120 > These templates are stored in a subdirectory of the <A
121 HREF="config.html#CONFDIR"
127 >. On Unixish platforms,
130 HREF="file:///etc/privoxy/templates/"
134 >/etc/privoxy/templates/</TT
138 > The templates are basically normal HTML files, but with place-holders (called symbols
139 or exports), which <SPAN
142 > fills at run time. You can
143 edit the templates with a normal text editor, should you want to customize them.
148 >Not recommended for the casual user</I
151 just like in configuration files, lines starting with <VAR
155 ignored when the templates are filled in.</P
157 > The place-holders are of the form <VAR
161 find a list of available symbols, which vary from template to template,
162 in the comments at the start of each file. Note that these comments are not
163 always accurate, and that it's probably best to look at the existing HTML
164 code to find out which symbols are supported and what they are filled in with.</P
166 > A special application of this substitution mechanism is to make whole
167 blocks of HTML code disappear when a specific symbol is set. We use this
168 for many purposes, one of them being to include the beta warning in all
169 our user interface (CGI) pages when <SPAN
173 in in an alpha or beta development stage:</P
183 ><!-- @if-unstable-start -->
185 ... beta warning HTML code goes here ...
187 <!-- if-unstable-end@ --></PRE
193 > If the "unstable" symbol is set, everything in between and including
196 >@if-unstable-start</VAR
199 >if-unstable-end@</VAR
201 will disappear, leaving nothing but an empty comment:</P
211 ><!-- --></PRE
217 > There's also an if-then-else construct and an <VAR
221 mechanism, but you'll sure find out if you are inclined to edit the
224 > All templates refer to a style located at
226 HREF="http://config.privoxy.org/send-stylesheet"
230 >http://config.privoxy.org/send-stylesheet</VAR
233 This is, of course, locally served by <SPAN
237 and the source for it can be found and edited in the
248 SUMMARY="Footer navigation table"
259 HREF="filter-file.html"
297 >Contacting the Developers, Bug Reporting and Feature