|
|
Server Side Includes - HoloSSI
Server-side includes (SSI) are supported for standard and demo HoloWWW service.
SSI commands will generally have the following format:
<!--#command tag1="value1" tag2="value2" -->
When using server-side includes, you must name your document with a file
extension of ".shtml" or ".ssi". The HoloWWW server will
then parse the file for SSI commands and execute them before sending the
document.
SSI Commands
Note:
- The config and exec commands are not currently supported.
- The counter, eof, m4, and random commands
are HoloNet-specific HoloSSI extended commands.
- counter
Use this command to display a counter and/or increment a counter.
Counters are administrated from the HoloWWW administration pages. Counters
can also be displayed as stylized GIF images.
See also: HoloWWW Access Counters
Definition
<!--#counter counter="countername" options="diDI" -->
This command allows you to display as HTML and/or increment the
counter countername. The counter must have been created with HoloWWW
administration page. The default is to display and increment the counter.
| Option | Description |
|---|
| d | Do not display the counter. |
| D | Display the counter. (DEFAULT) |
| i | Do not increment the counter. |
| I | Increment the counter. (DEFAULT) |
[Back to Top]
- echo
Display various server variables in your file.
Definition
<!--#echo var="variable" -->
In addition to the normal CGI variables the following variables are also available:
| Variable | Description |
|---|
| DATE_LOCAL | The current Pacific Time Zone time. |
| DATE_GMT | The current GMT time. |
| DOCUMENT_NAME | The current file name. |
| DOCUMENT_URI | The current path to document from the server root. For example: "/tables/rates.shtml" |
| LAST_MODIFIED | Last modification date of the current document in GMT time. |
Example HTML
Last modified: "<!--#echo var="LAST_MODIFIED" -->".
Example Parsed HTML
Last modified: "Tuesday, 25-Jul-2000 10:27:50 PDT".
[Back to Top]
- eof
Consider this command as the end of file.
Definition
<!--#eof -->
Ignore the rest of the file, do not process or send the rest of the file.
Example HTML
Before
<!--#eof -->
After
Example ParsedHTML
Before
[Back to Top]
- flastmod
Display the last modification date of a file.
Definition
<!--#flastmod virtual="file" -->
Display the last modification date of the file specified by the path
relative to the server root. For example, to display the last modification
of your home page you would set file to "Welcome.html".
<!--#flastmod file="file" -->
Display the last modification date of the file specified by the path
relative to the current document.
Note: You cannot specify "/../" in
path names.
[Back to Top]
- fsize
Display the size of a file in bytes.
Definition
<!--#fsize virtual="file" -->
Display the size of the file specified by the path relative to the
server root. For example, to display the size of your home page you
would set file to "Welcome.html".
<!--#fsize file="file" -->
Display the size of the file specified by the path relative to the
current document.
Note: You cannot specify "/../" in path names.
[Back to Top]
- include
HoloSSI allows you to include a document within a document. For example,
if you had a rate table that you used in several documents, you
could save it in a single document and include in it in other
documents by reference.
Definition
<!--#include virtual="file" -->
Include the file specified by the path relative to the server root.
For example, to include your home page you would set file to "Welcome.html".
<!--#include file="file" -->
Include the file specified by the path relative to the current document.
Note: You cannot specify "/../" in path names.
The files you include can also be HoloSSI files to be parsed. You may not
nest HoloSSI files more than four levels deep.
[Back to Top]
- m4
Invokes the macro language m4
on the remainder of the file.
Definition
<!--#m4 -->
Causes the remainder of the page to be parsed by
m4 before further HoloSSI parsing
continues.
[Back to Top]
- random
Allows you to include HTML at random in your document. Possible
uses include:
- Displaying a random ad with assoicated link.
- Selecting a random color or background.
- Displaying a random joke or puzzle.
- Displaying a hot link.
Definintion
<!--#random odds1="text1" oddsN="textN" -->
Each item of text has oddsX chances out of the total odds of being displayed.
Example HTML
The following HTML code, displays one of three GIFs with anchors. The first
and second GIF have a 25% chance each of being displayed. The last GIF
has a 50% chance of being displayed. Reload this page a few times to
see the change.
<!--#random
1="<A HREF=\"/holonet\"><IMG SRC=\"ssi-ad-1.gif\"
ALT=\"[HoloNet]\" WIDTH=468 HEIGHT=60></A>"
1="<A HREF=\"/holonet/holowww"><IMG SRC=\"ssi-ad-2.gif\"
ALT=\"[HoloWWW]\" WIDTH=468 HEIGHT=60></A>"
2="<A HREF=\"/wwwdemo\"><IMG SRC=\"ssi-ad-3.gif\"
ALT=\"[WWW Demo]\" WIDTH=468 HEIGHT=60></A>"
-->
Example Parsed HTML
[an error occurred while processing this directive]
Note: To specify a double-quote (") or
backslash (\) inside of double-quotes, precede the double-quote or backslash
with a backslash (\).
[Back to Top]
|
