[logo curtesy of]
Start Navigation
About AxKit
Live Sites
Daily Churn
Getting AxKit
Mailing List
End Navigation
Prev Top Next

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.

Prev Top Next

Printer Friendly