The Panix Help System -- Setting up Mason

Using Mason on Panix

These instructions outline how to set up the HTML::Mason templating system to generate dynamic web pages for your site on our shared webservers. Substitute your user name for yourusername, and, where appropriate, your domain name for yourdomainname, throughout.

Log into your Panix shell account.
Change directories into your web space:

• Personal & Cheap-web customers:

cd public_html

• Standard, Advanced, and Developer Web customers:

cd corp-web/yourdomainname
If you do not already have one, create a pcgi-bin directory:
mkdir pcgi-bin
chmod 701 pcgi-bin/
Create a Mason handler: edit pcgi-bin/mason-handler.cgi (substitute your user name for yourusername)
#!/usr/local/bin/perl5.6.1
$ENV{ PATH_INFO } =~ s{/~\w+}{};
use HTML::Mason::CGIHandler;

• Personal Web & Cheap-web customers:

my $h = new HTML::Mason::CGIHandler(comp_root=>'/htdocs/userdirs/yourusername');

• Standard, Advanced, and Developer Web customers:

my $h = new HTML::Mason::CGIHandler(comp_root=>'/htdocs/corp-dirs/yourusername/yourdomainname');

$h->handle_request;
Adjust permissions on your new handler:
chmod 500 pcgi-bin/mason-handler.cgi
Tell apache about the new handler: append to or create a .htaccess file (substitute your user name for yourusername) these 2 lines.
AddHandler html-mason mhtml

• Personal Web & Cheap-web customers:

Action html-mason http://www.panix.com/~yourusername/pcgi-bin/mason-handler.cgi

• Standard, Advanced, and Developer Web customers:

Action html-mason http://yourdomainname/pcgi-bin/mason-handler.cgi
Create .mhtml files, such as http://www.panix.com/~ejetest/mason-test.mhtml, with autohandlers and include files to your taste. Minimum permissions on the new files are 400 (owner-readable). You might prefer 600 (which is also owner-writeable) for convenience while actively working with your files.
> cat mason-test.mhtml
<dl>
<%perl>
foreach my $key (sort keys %ENV) {
</%perl>
<dt><% $key %></dt><dd><% $ENV{$key} %></dd>
<%perl>
}
</%perl>
</dl>

> cat autohandler
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" />
<title><% $m->request_comp->attr('title') %></title>
</head>
<body>
<% $m->call_next() %>
</body>
</html>
Get help online. http://www.masonhq.com/