18.3. Adding SSI Commands to a Document
<!--#element attribute="value" -->
The command also includes one or more attribute/value pairs that provide the specific parameters to the function.
There are a few important things to note about SSI command syntax:
18.3.1. Example: Virtual Includes
In this example, let's take a page from within a web site that uses a standard navigational toolbar held together with a table. Instead of placing the table in the HTML source for every web page in the site, we can just insert it into each document as follows:
<HTML> <HEAD><TITLE>News</TITLE></HEAD> <BODY> <!--#include virtual="navtable.html" --> <H1>Today's Headlines</H1> ...page contents... </BODY> </HTML>
Documents that contain SSI commands should be saved with an identifying suffix, which indicates to the server that the file should be parsed before being sent to the browser. In most cases, the suffix is .shtml (the default), but this can be configured to be any suffix, so check with your server administrator first.
The command in the above example uses the include element, which inserts the text of another document into the parsed file. The include element uses the virtual parameter to specify the URL of the document to be inserted, in this case, navtable.html. The following shows the entire contents (simplified for sake of space) of navtable.html:
<TABLE> <TR><TD><IMG SRC="toolbar.gif"></TD></TR> ...complicated toolbar stuff... </TABLE>
Technically, this should be just a fragment of an HTML document in which the structural tags (<html>, <head>, and <body>) have been omitted. This is one way to ensure the final document doesn't end up with a double (and conflicting) set of structural tags. If you have a very good reason for leaving them in, be sure they match the parsed document exactly, and keep in mind that double <body> tags aren't received well by some browsers. Otherwise, play it safe and omit them.
The server puts the fragment in the spot indicated by the virtual include command. When the document is sent to the browser, the source looks like this:
<HTML> <HEAD><TITLE>News</TITLE></HEAD> <BODY> <TABLE> <TR><TD><IMG SRC="toolbar.gif"></TD></TR> ...complicated toolbar stuff... </TABLE> <H1>Today's Headlines</H1> ... page contents... </BODY> </HTML>
The include element is just one of the elements available through SSI. The full list of Apache 1.3 elements appears in Section 18.6, "SSI Commands" later in this chapter.
Copyright © 2002 O'Reilly & Associates. All rights reserved.