view release on metacpan or  search on metacpan

GETTING_STARTED  view on Meta::CPAN

Welcome to Apache::SetWWWTheme!  This file is a brief intro into getting
this module up and running on your system.  There are a few requirements:

1) a unixish operating system.  I developed on Solaris 2.6, and have
tested it on Linux.  I don't foresee and sort of problems running it on
any other unix.  VMS and/or Windows might be tricky though -- I'm quite
clueless about other operating systems. If you can get it going on these
platforms, please tell me!

2) The Apache webserver

3) The mod_perl Apache module.

4) Finally, and MOST IMPORTANTLY -- you must have HTML::WWWTheme
installed.  This module is also written by Chad Hogan (that's me) and
it's designed to do most of the backend work for this module, and to
provide a lower-level tool that CGI programmers can use when writing
programs for a website with Apache::SetWWWTheme installed. 

HTML::WWWTheme is available from the same place you got
Apache::SetWWWTheme.  It can be found at CPAN.  Also, if you really get
stuck, contact me directly (chogan@uvastro.phys.uvic.ca) and I'll set you
up.  

*********************************************

INSTALLATION:
------------

Installation is very simple.  First, install and compile Perl 5 and
Apache with mod_perl.  I'll leave that part up to you.  Once you've got
this going to your satisfaction, you'll be on your way.

1) Install HTML::WWWTheme.  

	-download and automatically install this module from CPAN
	 using the usual:
	
	  perl -MCPAN -e shell;	

	once you're in the shell, type 'h' and you'll get some help.

   or...
	
	-download the source code for HTML::WWWTheme

	-gunzip/untar the package somewhere

	-go into the WWWTheme directory and run:

	  perl Makefile.PL;
	  make;
	  make test;
	  make install;

	Hopefully all will go well, and it will install without a hitch.
	Naturally, you'll need to run "make install" as a privileged
	user with permissions to write to your site_perl directory.  

2) gunzip and untar this package.  Obviously, you've gotten this far or
you wouldn't be reading this.  :^)

3) Check out Makefile.PL.  If you understand it, and you know what you're
doing, you might want to edit it.  If you don't, that's ok.  Perl will
probably take care of the details for you.