Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Mirror of HTML-Mason on urth.org

tree: fe60fc8eb4

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 benchmarks
Octocat-spinner-32 bin
Octocat-spinner-32 eg
Octocat-spinner-32 htdocs
Octocat-spinner-32 inc
Octocat-spinner-32 lib
Octocat-spinner-32 samples
Octocat-spinner-32 t
Octocat-spinner-32 .gitignore
Octocat-spinner-32 Build.PL
Octocat-spinner-32 CREDITS
Octocat-spinner-32 Changes
Octocat-spinner-32 LICENSE
Octocat-spinner-32 MANIFEST.SKIP
Octocat-spinner-32 README
Octocat-spinner-32 UPGRADE
README
Copyright (c) 1998-2005 by Jonathan Swartz. All rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

Welcome to Mason, a Perl-based web site development and delivery
system.  Mason allows web pages and sites to be constructed from
shared, reusable building blocks called components. Components contain
a mix of Perl and HTML, and can call each other and pass values back
and forth like subroutines. Components increase modularity and
eliminate repetitive work: common design elements (headers, footers,
menus, logos) can be extracted into their own components where they
need be changed only once to affect the whole site.

Other Mason features include powerful filtering and templating
facilities, and a HTML/data caching model.  See
http://www.masonhq.com/ for more information.

MASON 1 VERSUS MASON 2

Version 1 of Mason -- this distribution -- has been around since 1998, is in wide use, and is
very stable. However it has not changed much in years and is no longer actively developed.

Version 2 of Mason was released in February of 2011.  It is being very actively developed
and has a much more modern architecture. If you are just starting out, we recommend you
give Mason 2 a try. It is available at

    https://metacpan.org/release/Mason

For a summary of differences between Mason 1 and 2 see

    http://www.openswartz.com/2011/02/21/announcing-mason-2/

PREREQUISITES

Mason requires Perl 5.6.0 or greater, and the following CPAN modules:

* Params::Validate

* Exception::Class

* Class::Container

* File::Spec

* Scalar::Util

The following CPAN modules are optional for certain features, but not required:

* Apache::Request

* Cache::Cache

* CGI.pm

INSTALLATION

To install Mason, run the standard sequence:

	perl Build.PL
	./Build
	./Build install

By default, Mason will prompt you for information about where Apache
is installed so that it can help you configure Mason to run under
mod_perl.  If you would like to skip this, invoke the Makefile.PL like
this:

        perl Build.PL --noprompts

After Mason is installed, you will need to activate it by adding some
directives to your Apache configuration files.

The included pod docs have been pre-converted to HTML for you and
placed in the htdocs/ directory. The Mason overview (a good place to
start) is in Mason.html.

WARNINGS!

* Don't use Mason with an older mod_perl DSO (dynamic shared object).

Using Mason with a mod_perl DSO may cause your Apache server to crash
silently at startup, or fail intermittently. The fix for this problem
is to install Apache/mod_perl with mod_perl compiled statically into
the Apache binary.  Packages of Apache with a static mod_perl are
available around the net.

Testing with recent mod_perls showed improvements, but because this
bug can be so intermittent and difficult to spot, mod_perl DSO with
Mason is still strictly unsupported.

This should not be a problem with Apache2.

* Don't use Mason with PerlFreshRestart.

The mod_perl PerlFreshRestart directive attempts to reload modules on
restart in a very simplistic way. Mason cannot be reloaded this way.
The Apache::Reload module from CPAN does a much better job, and
appears to work with Mason.  However, the safest thing to do is to
actually stop and start the server.

GETTING HELP

The official Mason web site is at http://www.masonhq.com/. It's a
wiki, so most pages can be edited by any registered user.

The official documentation is at http://www.masonhq.com/docs/manual/.

The FAQ is at http://www.masonhq.com/?FAQ.

Several mailing lists exist for Mason users and developers. Full
information can be found at
http://www.masonhq.com/?MailingLists.

There is a book about Mason, _Embedding Perl in HTML with Mason_, by
Dave Rolsky and Ken Williams.  This book is published by O'Reilly and
Associates.  The book's home page is http://www.masonbook.com/.

CODE EXAMPLES

The samples/ directory contains a few basic components.

The Mason site contains a variety of user-contributed code and
how-tos; see http://www.masonhq.com/?ContributedCode, for example.

Links to various articles containing code examples are listed at
http://www.masonhq.com/?Articles.

REPORTING BUGS

Send bug reports to the user's mailing list for quickest response.  But
first check the mailing list archives and the official bugs list on
the Mason site to see if the problem has already been reported.

For all bug reports indicate your architecture, Apache/Perl/module
versions, etc. For installation problems send your handler.pl and
httpd.conf. For component problems try to isolate the bug in a single
small component or set of components, and send those.

If you are experiencing test failures, please run the tests like this:

        ./Build test verbose=1

and send the output along with the bug report.  Otherwise we'll just
ask you to do this before we can do anything.

LICENSE

Mason was originally developed for the Internet technology group at
CMP Media, a publisher of technology magazines. CMP
graciously supported our efforts to release Mason as open source
software to the Perl community.  However, CMP has NO direct
involvement with the open source release and bears NO responsibility
for its support or maintenance.

Mason is provided "as is" and without any express or implied
warranties, including, without limitation, the implied warranties of
merchantibility and fitness for a particular purpose.

Mason is released under the same terms as Perl itself.  For more
information see the "README" or "Artistic" files provided with the
Perl distribution.

AUTHORS

Jonathan Swartz
swartz <AT> pobox.com

Dave Rolsky
autarch <AT> urth.org

Ken Williams
ken <AT> mathforum.org

John Williams
williams <AT> tni.com
Something went wrong with that request. Please try again.