The Panix Help System -- Setting up Mason

Panix - Public Access
Networks Corporation

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:
• Single-user & Cheap-web customers:
```
cd public_html
```
• Corporate 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;

• Single-user & Cheap-web customers:

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

• Corporate 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
```
• Single-user & Cheap-web customers:
Action html-mason http://www.panix.com/~yourusername/pcgi-bin/mason-handler.cgi
• Corporate 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>

If you need additional help with this software, you can find it online on its primary web site, http://www.masonhq.com/

webmaster@panix.com | Last modified: March 7, 2011

[ Panix Home ] [ Help System Index ] [ Top of This Page ]