1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >Privoxy's Template Files</TITLE
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
10 TITLE="Privoxy 3.0.8 User Manual"
11 HREF="index.html"><LINK
14 HREF="filter-file.html"><LINK
16 TITLE="Contacting the Developers, Bug Reporting and Feature
18 HREF="contact.html"><LINK
22 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
34 SUMMARY="Header navigation table"
43 >Privoxy 3.0.8 User Manual</TH
51 HREF="filter-file.html"
80 >10. Privoxy's Template Files</A
86 > built-in pages, i.e. error pages such as the
88 HREF="http://show-the-404-error.page"
92 >"404 - No Such Domain"</SPAN
96 HREF="http://ads.bannerserver.example.com/nasty-ads/sponsor.html"
104 and all pages of its <A
105 HREF="http://config.privoxy.org/"
109 >, are generated from <SPAN
119 > must be running for the above links to work as
122 > These templates are stored in a subdirectory of the <A
123 HREF="config.html#CONFDIR"
129 >. On Unixish platforms,
132 HREF="file:///etc/privoxy/templates/"
136 >/etc/privoxy/templates/</TT
140 > The templates are basically normal HTML files, but with place-holders (called symbols
141 or exports), which <SPAN
144 > fills at run time. It
145 is possible to edit the templates with a normal text editor, should you want
146 to customize them. (<SPAN
150 >Not recommended for the casual
153 >). Should you create your own custom templates, you should use
158 HREF="config.html#TEMPLDIR"
161 to specify an alternate location, so your templates do not get overwritten
165 > Note that just like in configuration files, lines starting
169 > are ignored when the templates are filled in.</P
171 > The place-holders are of the form <TT
175 find a list of available symbols, which vary from template to template,
176 in the comments at the start of each file. Note that these comments are not
177 always accurate, and that it's probably best to look at the existing HTML
178 code to find out which symbols are supported and what they are filled in with.</P
180 > A special application of this substitution mechanism is to make whole
181 blocks of HTML code disappear when a specific symbol is set. We use this
182 for many purposes, one of them being to include the beta warning in all
183 our user interface (CGI) pages when <SPAN
187 is in an alpha or beta development stage:</P
197 ><!-- @if-unstable-start -->
199 ... beta warning HTML code goes here ...
201 <!-- if-unstable-end@ --></PRE
207 > If the "unstable" symbol is set, everything in between and including
210 >@if-unstable-start</TT
213 >if-unstable-end@</TT
215 will disappear, leaving nothing but an empty comment:</P
225 ><!-- --></PRE
231 > There's also an if-then-else construct and an <TT
235 mechanism, but you'll sure find out if you are inclined to edit the
238 > All templates refer to a style located at
240 HREF="http://config.privoxy.org/send-stylesheet"
244 >http://config.privoxy.org/send-stylesheet</TT
247 This is, of course, locally served by <SPAN
251 and the source for it can be found and edited in the
262 SUMMARY="Footer navigation table"
273 HREF="filter-file.html"
311 >Contacting the Developers, Bug Reporting and Feature