Rebuild for 3.0.17 stable
[privoxy.git] / doc / webserver / user-manual / templates.html
index 3446ee2..d8d9987 100644 (file)
@@ -1,16 +1,16 @@
-<!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.17 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
@@ -18,7 +18,12 @@ Requests"
 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"
@@ -38,7 +43,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.0.3 User Manual</TH
+>Privoxy 3.0.17 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -75,7 +80,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="TEMPLATES"
->10. Templates</A
+>10. Privoxy's Template Files</A
 ></H1
 ><P
 > All <SPAN
@@ -139,24 +144,36 @@ CLASS="FILENAME"
  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
@@ -170,7 +187,7 @@ CLASS="LITERAL"
 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"
@@ -191,12 +208,12 @@ CLASS="SCREEN"
 ></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
@@ -214,9 +231,9 @@ CLASS="SCREEN"
 ></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
@@ -225,9 +242,9 @@ CLASS="LITERAL"
  <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
@@ -284,7 +301,7 @@ ACCESSKEY="N"
 WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
->The Filter File</TD
+>Filter Files</TD
 ><TD
 WIDTH="34%"
 ALIGN="center"
@@ -301,4 +318,4 @@ Requests</TD
 ></DIV
 ></BODY
 ></HTML
->
\ No newline at end of file
+>