HTML::Mason::Admin is a Perl module that offers the Mason administrator's manual.
This manual is written for the sysadmin/webmaster in charge of installing, configuring, or tuning a Mason system. The bulk of the documentation assumes that you are using mod_perl.
SITE CONFIGURATION METHODS
Mason includes a module specifically designed to integrate Mason and mod_perl (1 and 2), HTML::Mason::ApacheHandler. By telling mod_perl to hand content requests to this module, you can use Mason to generate web pages. There are two ways to configure Mason under mod_perl.
Mason provides reasonable default behavior under mod_perl, so using Mason can be as simple as adding two directives to your Apache configuration file. Throughout this document, we will assume that your Apache configuration file is called httpd.conf. By adding more configuration parameters to this file you can implement more complex behaviors.
If the basic method does not provide enough flexibility for you, you can wrap Mason in a custom mod_perl handler. The wrapper code you write can create its own Mason objects, or it can take advantage of httpd.conf configuration parameters and let Mason create the objects it needs by itself.
We recommend that you start with the basic method and work your way forward as the need for flexibility arises.
Mason is very flexible, and you can replace parts of it by creating your own classes. This documentation assumes that you are simply using the classes provided in the Mason distribution. Subclassing is covered in the Subclassing document. The two topics are orthogonal, as you can mix the configuration techniques discussed here with your own custom subclasses.