readme

Here are some short instructions for use of mod-xslt. The stylesheet is specified using the Proce

README

IMPORTANT: The Makefile included in the Package currently assumes that Apache is installed at /usr/local/apache which
is as far as I know the default. If yours is not you will need to change a few things at the top of the Makefile.
This is on the list of todos. (Configure will sooner or later take care of it)


Here are some short instructions for use of mod-xslt.

The stylesheet is specified using the Processing Instruction

<?xml-stylesheet type="text/xsl" href="URL-OF-YOUR-STYLESHEET"?>

or now new

<?xslt-stylesheet agent="THE-USER-AGENT-STRING-OF-THE-BROWSER" href="URL-OF-YOUR-STYLESHEET"?>

This now enables you to use different Stylesheets for different browsers. (For example Netscape & IE) (or Web & WAP for that matter)

There are 2 other PI's that are processed:

<?xslt-base mode="file://|http://"?>
which tells mod-xslt how to get the stylesheet. Using a file url or
an http-request which permits you to generate your stylesheet using a script.
Per default this is set to mode="file://"

<?xslt-param name="NAME" select="VALUE"?>
Passes a Parameter to the processor. This overrides any parameters passed in the url.
This will generally be used by scripts to pass parameters to the stylesheet which
are not passed in the url or which it wants to override.

Parameters are generally only passed from the QUERY-STRING. So POST parameters are
ignored. It would be easy however to write a script reading the post parameters, reading a file,
and spitting that out so that you can retrieve these params as well.

There are a few Parameters that are passed along as well:

xslt-version = '1.0a'
xslt-author = '[e-mail]'
xslt-useragent = The User-Agent String passed by the Browser
xslt-document = The URL or File of the XML (depends on xslt-base)
xslt-hostname = The hostname of the server
xslt-uri = The uri that was called. (If xslt-base is http:// this is the same as document)
xslt-filename = The filename of the request (The filename Apache sais this is)
xslt-port = The port the request came in on

Last but not least:
If there are any Questions, don't hesitate to drop me a line. I'm happy to hear from you.

Philipp Dunkel
[e-mail]