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.16 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
21 HREF="../p_doc.css"><META
22 HTTP-EQUIV="Content-Type"
25 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
37 SUMMARY="Header navigation table"
46 >Privoxy 3.0.16 User Manual</TH
54 HREF="filter-file.html"
83 >10. Privoxy's Template Files</A
89 > built-in pages, i.e. error pages such as the
91 HREF="http://show-the-404-error.page"
95 >"404 - No Such Domain"</SPAN
99 HREF="http://ads.bannerserver.example.com/nasty-ads/sponsor.html"
107 and all pages of its <A
108 HREF="http://config.privoxy.org/"
112 >, are generated from <SPAN
122 > must be running for the above links to work as
125 > These templates are stored in a subdirectory of the <A
126 HREF="config.html#CONFDIR"
132 >. On Unixish platforms,
135 HREF="file:///etc/privoxy/templates/"
139 >/etc/privoxy/templates/</TT
143 > The templates are basically normal HTML files, but with place-holders (called symbols
144 or exports), which <SPAN
147 > fills at run time. It
148 is possible to edit the templates with a normal text editor, should you want
149 to customize them. (<SPAN
153 >Not recommended for the casual
156 >). Should you create your own custom templates, you should use
161 HREF="config.html#TEMPLDIR"
164 to specify an alternate location, so your templates do not get overwritten
168 > Note that just like in configuration files, lines starting
172 > are ignored when the templates are filled in.</P
174 > The place-holders are of the form <TT
178 find a list of available symbols, which vary from template to template,
179 in the comments at the start of each file. Note that these comments are not
180 always accurate, and that it's probably best to look at the existing HTML
181 code to find out which symbols are supported and what they are filled in with.</P
183 > A special application of this substitution mechanism is to make whole
184 blocks of HTML code disappear when a specific symbol is set. We use this
185 for many purposes, one of them being to include the beta warning in all
186 our user interface (CGI) pages when <SPAN
190 is in an alpha or beta development stage:</P
200 ><!-- @if-unstable-start -->
202 ... beta warning HTML code goes here ...
204 <!-- if-unstable-end@ --></PRE
210 > If the "unstable" symbol is set, everything in between and including
213 >@if-unstable-start</TT
216 >if-unstable-end@</TT
218 will disappear, leaving nothing but an empty comment:</P
228 ><!-- --></PRE
234 > There's also an if-then-else construct and an <TT
238 mechanism, but you'll sure find out if you are inclined to edit the
241 > All templates refer to a style located at
243 HREF="http://config.privoxy.org/send-stylesheet"
247 >http://config.privoxy.org/send-stylesheet</TT
250 This is, of course, locally served by <SPAN
254 and the source for it can be found and edited in the
265 SUMMARY="Footer navigation table"
276 HREF="filter-file.html"
314 >Contacting the Developers, Bug Reporting and Feature