4 >Privoxy's Template Files</TITLE
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
10 TITLE="Privoxy 3.0.5 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.5 User Manual</TH
51 HREF="filter-file.html"
81 >10. Privoxy's Template Files</H1
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. You can
145 edit the templates with a normal text editor, should you want to customize them.
150 >Not recommended for the casual user</I
153 just like in configuration files, lines starting with <TT
157 ignored when the templates are filled in.</P
159 > The place-holders are of the form <TT
163 find a list of available symbols, which vary from template to template,
164 in the comments at the start of each file. Note that these comments are not
165 always accurate, and that it's probably best to look at the existing HTML
166 code to find out which symbols are supported and what they are filled in with.</P
168 > A special application of this substitution mechanism is to make whole
169 blocks of HTML code disappear when a specific symbol is set. We use this
170 for many purposes, one of them being to include the beta warning in all
171 our user interface (CGI) pages when <SPAN
175 is in an alpha or beta development stage:</P
185 ><!-- @if-unstable-start -->
187 ... beta warning HTML code goes here ...
189 <!-- if-unstable-end@ --></PRE
195 > If the "unstable" symbol is set, everything in between and including
198 >@if-unstable-start</TT
201 >if-unstable-end@</TT
203 will disappear, leaving nothing but an empty comment:</P
213 ><!-- --></PRE
219 > There's also an if-then-else construct and an <TT
223 mechanism, but you'll sure find out if you are inclined to edit the
226 > All templates refer to a style located at
228 HREF="http://config.privoxy.org/send-stylesheet"
232 >http://config.privoxy.org/send-stylesheet</TT
235 This is, of course, locally served by <SPAN
239 and the source for it can be found and edited in the
250 SUMMARY="Footer navigation table"
261 HREF="filter-file.html"
299 >Contacting the Developers, Bug Reporting and Feature