<!DOCTYPE caudium>
<!--
 *
 * Document generated automatically on Tue May 24 14:01:53 2005
 * Do not edit by hand!
 *
-->
<documentation>
<module name="XSLT Templates">
<inherits link="module"/>
<inherits link="caudiumlib"/>
<description>
  Allows for automatic execution of XSLT templates for using various 
  templates. You specify a template in your XML file by adding a 
  <strong>&lt;!DOCTYPE [basename]&gt;</strong> where <strong>[basename]</strong> is a base file 
  file name for the template. The module will then add the extension for the 
  requested file. This allows you to fetch the same file with different 
  templates by changing the extension. 
  <strong>Example:</strong> accessing file.html with &lt;!DOCTYPE template&gt; 
  will try to find a template named template_html.xsl and apply it to the 
  file file.xml. 
  <p>You can also override the template by adding <strong>__xsl=template.xsl</strong> to 
  the query string. This can be useful if the file you want to make a 
  template for printing w/o using a different extension.</p> 
  <p>Another special feature is post-processing RXML-parsing. 
  To post-process a document, use <strong>&lt;xsl:output&gt;</strong> with the 
  media-type attribute set to <strong>rxml:real/type</strong>, ie <strong>rxml:text/html</strong> 
  for an HTML document.</p> 

</description>

<version>
$Id: XSLTtemplate.pike,v 1.14.2.4 2005/01/03 17:01:19 kiwi Exp $
</version>

<type>MODULE_FIRST</type>
<defvars>
 <defvar name="stylesheet" short="Default XSLT stylesheet" type="TYPE_FILE"> The default style sheet to use when no other stylesheet is found. This should be a full path in the real filesystem. 
</defvar>
 <defvar name="xsldir" short="Template directory" type="TYPE_DIR"> If non-empty, this path in the real filesystem will be prepended to all stylesheet names as specified in the DOCTYPE attribute. 
</defvar>
 <defvar name="indexfile" short="Index file name" type="TYPE_STRING"> The name of the file to use as the XML source file for directory accesses. For example a request made to <i>/docs/</i> would result in the file <i>/docs/index.xml</i> to be used with the default setting. If this variable is the empty string, directory requests will be ignored. 
</defvar>
 <defvar name="indexext" short="Index file extension" type="TYPE_STRING"> When a directory request (i.e <i>/docs/</i> without an explicit file name) is received, the wanted extension (which is used to locate the correct stylesheet) is unknown. This variable sets the extension to be used in those cases. <b>Important:</b> Do not prepend the extension with a dot! 
</defvar>
 <defvar name="xmlext" short="XML source file extension" type="TYPE_STRING"> The extension of the requested file is stripped and replaced with this string to find the XML source file. I.e if the default value <i>.xml</i> is used and the requested file is test.html, the module would use the file test.xml as the XML source file. 
</defvar>
 <defvar name="xslext" short="XSLT stylesheet extension" type="TYPE_STRING"> The extension appended to the value specified in the &lt;!DOCTYPE> attribute. This variable is not for the default template or templates specified using the <i>&amp;__xsl=template</i> syntax. 
</defvar>
 <defvar name="showxml" short="Show raw XML files" type="TYPE_FLAG"> If this flag is set to Yes, requests for files ending will .xml will result in the file being sent as back as text/xml without trying to find and apply a stylesheet. 
</defvar>
</defvars>
</module>

</documentation>
