Commit 83a8954d authored by pcs's avatar pcs
Browse files

Provide information on enabling SSI files. Document how to enable 

SSI using a handler name, and relegate the magic mime types to back-compat.
status.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@77935 13f79535-47bb-0310-9956-ffa450edef68
parent fbd0af98

docs/manual/mod/mod_include.html

+28 −5
Original line number Diff line number Diff line
@@ -10,15 +10,38 @@ 


This module is contained in the <code>mod_include.c</code> file, and

is compiled in by default. It provides for server-parsed html

documents, known as SPML documents.  Any document with mime type

<code>text/x-server-parsed-html</code> or

<code>text/x-server-parsed-html3</code> will be parsed by this module,

with the resulting output given the mime type <code>text/html</code>.

Several directives beyond the original NCSA SPML definition have been

documents. Several directives beyond the original NCSA definition have been

included in Apache 1.2 - these are flagged below with the phrase

"Apache 1.2 and above".  Of particular significance are the new flow 

control directives documented at the bottom.



<H2>Enabling Server-Side Includes</H2>



Any document with handler of "server-parsed" will be parsed by this

module, if the <CODE>Includes</CODE> option is set. If documents

containing server-side include directives are given the extension

.shtml, the following directives will make Apache parse them and

assign the resulting document the mime type of <CODE>text/html</CODE>:



<PRE>

AddType text/html .shtml

AddHandler server-parsed .shtml

</PRE>



The following directive must be given for the directories containing

the shtml files (typically in a <CODE>&lt;Directory&gt;</CODE> section,

but this directive is also valid .htaccess files if <CODE>AllowOverride

Options</CODE> is set):



<PRE>

Options +Includes

</PRE>



For backwards compatibility, documents with mime type

<code>text/x-server-parsed-html</code> or

<code>text/x-server-parsed-html3</code> will also be parsed

(and the resulting output given the mime type <code>text/html</code>).



<h2>Basic Elements</h2>



The document is parsed as an HTML document, with special commands embedded