7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
10 TITLE="Privoxy 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
40 >Privoxy User Manual</TH
48 HREF="filter-file.html"
81 > built-in pages, i.e. error pages such as the
83 HREF="http://show-the-404-error.page"
87 >"404 - No Such Domain"</SPAN
91 HREF="http://ads.bannerserver.example.com/nasty-ads/sponsor.html"
99 and all pages of its <A
100 HREF="http://config.privoxy.org/"
104 >, are generated from <I
111 > must be running for the above links to work as
114 > These templates are stored in a subdirectory of the <A
115 HREF="config.html#CONFDIR"
121 >. On unixish platforms,
124 HREF="file:///etc/privoxy/templates/"
128 >/etc/privoxy/templates/</TT
132 > The templates are basically normal HTML files, but with place-holders (called symbols
133 or exports), which <SPAN
136 > fills at run time. You can
137 edit the templates with a normal text editor, should you want to customize them.
140 >Not recommended for the casual user</I
142 just like in configuration files, lines starting with <TT
146 ignored when the templates are filled in.</P
148 > The place-holders are of the form <TT
152 find a list of available symbols, which vary from template to template,
153 in the comments at the start of each file. Note that these comments are not
154 always accurate, and that it's probably best to look at the existing HTML
155 code to find out which symbols are supported and what they are filled in with.</P
157 > A special application of this substitution mechanism is to make whole
158 blocks of HTML code disappear when a specific symbol is set. We use this
159 for many purposes, one of them being to include the beta warning in all
160 our user interface (CGI) pages when <SPAN
164 in in an alpha or beta development stage:</P
174 ><!-- @if-unstable-start -->
176 ... beta warning HTML code goes here ...
178 <!-- if-unstable-end@ --></PRE
184 > If the "unstable" symbol is set, everything in between and including
187 >@if-unstable-start</TT
190 >if-unstable-end@</TT
192 will disappear, leaving nothing but an empty comment:</P
202 ><!-- --></PRE
208 > There's also an if-then-else construct and an <TT
212 mechanism, but you'll sure find out if you are inclined to edit the
215 > All templates refer to a style located at
217 HREF="http://config.privoxy.org/send-stylesheet"
221 >http://config.privoxy.org/send-stylesheet</TT
224 This is, of course, locally served by <SPAN
228 and the source for it can be found and edited in the
249 HREF="filter-file.html"
284 >Contacting the Developers, Bug Reporting and Feature