A Simple Setup Example

Setting up AxKit is simple. I don't believe in tools like this being hard to use or even hard to setup. Provided you can use an editor and modify a few Apache configuration files, setup should be a breeze.

Unfortunately AxKit requires mod_perl, so there is an extra component to install first. Installation of mod_perl can be complex, depending upon your setup. To that end I will just provide a link: The mod_perl Guide - Installation.

Now onto AxKit itself. First, installing the required perl modules is very simple. Download AxKit (see link below), extract the archive and change to the directory created. Then simply type:

% perl Makefile.PL
% make
% make test
% make install

If you don't have apxs in your path, mod_perl versions below 1.24 will produce a warning at the first step. This warning can be ignored.

Next up, editing Apache's configuration files. First you need to enable AxKit so that Apache understands AxKit's configuration directives, so add the following line to your httpd.conf file:

PerlModule AxKit

Finally, you can add in the core of AxKit - handler itself. This can be added to any .htaccess file, or to your httpd.conf file:

SetHandler perl-script
PerlHandler AxKit

AxAddStyleMap text/xsl Apache::AxKit::Language::Sablot

The last line there associates the type "text/xsl" with the stylesheet module specified.

Now you're ready to start serving up XML files. Check out the example files in the AxKit distribution, these should get you started.

Top

Printer Friendly

Raw XML