xref: /lighttpd1.4/doc/outdated/ssi.txt (revision 25f5085a)
1====================
2Server-Side Includes
3====================
4
5---------------
6Module: mod_ssi
7---------------
8
9:Author: Jan Kneschke
10:Date: $Date: 2004/08/29 09:44:53 $
11:Revision: $Revision: 1.2 $
12
13:abstract:
14  The module for server-side includes provides a compatibility
15  layer for NCSA/Apache SSI.
16
17.. meta::
18  :keywords: lighttpd, ssi, Server-Side Includes
19
20.. contents:: Table of Contents
21
22Description
23===========
24
25Configuration
26-------------
27
28::
29
30  server.modules = ( ..., "mod_ssi", ... )
31  ssi.extension = ( ".shtml" )
32
33Supported Options
34-----------------
35
36- ``<!--#echo var="..." -->``
37- ``<!--#include (file="..."\|virtual="...") -->``
38- ``<!--#flastmod (file="..."\|virtual="...") -->``
39- ``<!--#fsize (file="..."\|virtual="...") -->``
40- ``<!--#config timefmt="..." sizefmt="(bytes|abbrev)" -->``
41- ``<!--#printenv -->``
42- ``<!--#set var="..." value="..." -->``
43- ``<!--#if expr="..." -->``
44- ``<!--#elif expr="..." -->``
45- ``<!--#else -->``
46- ``<!--#endif -->``
47
48Expression Handling
49-------------------
50
51Every ''expr'' is interpreted:
52
53- logical: AND, OR, !
54- compare: =, <, <=, >, =>, !=
55- precedence: (, )
56- quoted strings: 'string with a dollar: $FOO'
57- variable substitution: $REMOTE_ADDR
58- unquoted strings: string
59
60Flow Control
61------------
62
63if, elif, else and endif can only be used to insert content under special
64conditions.
65
66Unsupported Features
67--------------------
68
69The original SSI module from NCSA and Apache provided some more options
70which are not supported by this module for various reasons:
71
72- exec
73- nested virtual
74- config.errmsg
75- echo.encoding
76
77