-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
->Templates</TITLE
+>Privoxy's Template Files</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.3 User Manual"
+TITLE="Privoxy 3.0.8 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
-TITLE="The Filter File"
+TITLE="Filter Files"
HREF="filter-file.html"><LINK
REL="NEXT"
TITLE="Contacting the Developers, Bug Reporting and Feature
HREF="contact.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
-HREF="../p_doc.css"></HEAD
+HREF="../p_doc.css"><META
+HTTP-EQUIV="Content-Type"
+CONTENT="text/html;
+charset=ISO-8859-1">
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
+</head
><BODY
CLASS="SECT1"
BGCOLOR="#EEEEEE"
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.3 User Manual</TH
+>Privoxy 3.0.8 User Manual</TH
></TR
><TR
><TD
CLASS="SECT1"
><A
NAME="TEMPLATES"
->10. Templates</A
+>10. Privoxy's Template Files</A
></H1
><P
> All <SPAN
or exports), which <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> fills at run time. You can
- edit the templates with a normal text editor, should you want to customize them.
- (<SPAN
+> fills at run time. It
+ is possible to edit the templates with a normal text editor, should you want
+ to customize them. (<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
->Not recommended for the casual user</I
+>Not recommended for the casual
+ user</I
></SPAN
->). Note that
- just like in configuration files, lines starting with <VAR
+>). Should you create your own custom templates, you should use
+ the <TT
+CLASS="FILENAME"
+>config</TT
+> setting <A
+HREF="config.html#TEMPLDIR"
+>templdir</A
+>
+ to specify an alternate location, so your templates do not get overwritten
+ during upgrades.
+ </P
+><P
+> Note that just like in configuration files, lines starting
+ with <TT
CLASS="LITERAL"
->#</VAR
-> are
- ignored when the templates are filled in.</P
+>#</TT
+> are ignored when the templates are filled in.</P
><P
-> The place-holders are of the form <VAR
+> The place-holders are of the form <TT
CLASS="LITERAL"
->@name@</VAR
+>@name@</TT
>, and you will
find a list of available symbols, which vary from template to template,
in the comments at the start of each file. Note that these comments are not
CLASS="APPLICATION"
>Privoxy</SPAN
>
- in in an alpha or beta development stage:</P
+ is in an alpha or beta development stage:</P
><P
> <TABLE
BORDER="0"
></P
><P
> If the "unstable" symbol is set, everything in between and including
- <VAR
+ <TT
CLASS="LITERAL"
->@if-unstable-start</VAR
-> and <VAR
+>@if-unstable-start</TT
+> and <TT
CLASS="LITERAL"
->if-unstable-end@</VAR
+>if-unstable-end@</TT
>
will disappear, leaving nothing but an empty comment:</P
><P
></TABLE
></P
><P
-> There's also an if-then-else construct and an <VAR
+> There's also an if-then-else construct and an <TT
CLASS="LITERAL"
->#include</VAR
+>#include</TT
>
mechanism, but you'll sure find out if you are inclined to edit the
templates ;-)</P
<A
HREF="http://config.privoxy.org/send-stylesheet"
TARGET="_top"
-><VAR
+><TT
CLASS="LITERAL"
->http://config.privoxy.org/send-stylesheet</VAR
+>http://config.privoxy.org/send-stylesheet</TT
></A
>.
This is, of course, locally served by <SPAN
WIDTH="33%"
ALIGN="left"
VALIGN="top"
->The Filter File</TD
+>Filter Files</TD
><TD
WIDTH="34%"
ALIGN="center"