Apache-SetWWWTheme

 view release on metacpan or  search on metacpan

GETTING_STARTED  view on Meta::CPAN

	  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.  

4) Run 

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

in the SetWWWTheme directory.  If all goes well, nothing bad will happen.
If you -really- can't get it installed, just copy the SetWWWTheme.pm file
into a perl library directory
(/usr/lib/perl5/site_perl/5.005/Apache/SetWWWTheme.pm for example).  It
must be in an Apache directory, whatever the case.  If you can't get it
installed, email me and I'll help (chogan@uvastro.phys.uvic.ca)

6) Ok, we've got it in -- we just need to get it running.  Edit your
httpd.conf file and add in the following (edited to suit your site)

 <Location /somewhere>
	SetHandler perl-script
	PerlHandler Apache::SetWWWTheme
	PerlSetVar CONFIG_FILE /WWW/Configuration
 </Location>

You'll need to edit that to suit your particular tree.  "/somewhere"
should be a subtree in your web directory.  If you want the module to
affect the entire web tree, just put <Location />.  You can do as many of
these <Location [subtree]> directives as you want.  Apache will handle
them all.  You'll also need to change the CONFIG_FILE value from
"/WWW/Configuration" to point to the name of the configuration file for
that particular location.  It can be whatever (and wherever)  you want it
to be, but the path must be a path on the real filesystem (ie not
relative to the webserver document root). 

7) Copy the templates from the SetWWWTheme/templates directory to their

GETTING_STARTED  view on Meta::CPAN

	 to /WWW/apache/htdocs/Configuration

	-update your httpd.conf <Location> tag CONFIG_FILE so that it
	 says 

          PerlSetVar CONFIG_FILE /WWW/apache/htdocs/Configuration

	-copy SetWWWTheme/templates/LookAndFeelConfig to any subdirectory
	 in your webtree.  If you like, put it in the document root.

	-edit Configuration and LookAndFeelConfig until you're happy with
	 them.  Read the pod or the manpage to figure out what all the
	 directives do (if you can't figure it out by playing with it)

	-take a look at the SetWWWTheme/templates/example.html file to
	 see how you embed directives into HTML files.  You could even
	 copy it to a directory and test it out.  

	-fire up Apache and test it out!

Hopefully, this should get you rolling.  If you can't figure it out, drop

templates/Configuration  view on Meta::CPAN

# This is a sample configuration file.  It contains most valid
# configuration options, but everything is turned off by default.  So,
# if you install the module and use this file unmodified as your server 
# configuration, your HTML files will be virtually unchanged!
# If you want to change things, either edit this file or use a 
# LookAndFeelConfig file.  I find it's nice to gently ease a site into
# the module by using this sort of "transparent" configuration, and then
# slowly easing in the changes.

#################################################

# Note:  using hash marks is a bogus comment.  It is just for visual
# distinction -- the program will see a "commented" directive just as
# well as an uncommented one.  It will also ignore text whether or not
# it is "commented" with a hash mark.  The program searches for an

templates/Configuration  view on Meta::CPAN

@INFO=<A HREF="http://www.slashdot.org">slashdot</a>,
      <A HREF="http://www.sun.com"     >sun</a>;


# toggle to use the side search box.  1 means "use it", 0 means "don't".
# Naturally, if no sidebar is generated, there won't be a search box :) 

@SIDEBARSEARCHBOX=1;

# The template that the program uses to interface to the cgi search
# engine.  You'll -definitely- have to edit this, unless you happen to 
# have CNIDR's isearch installed, and you've got the same directory 
# structure as I do :)  

@SEARCHTEMPLATE=
 <B>Search Site</B><BR><HR>
 <DIV align="center">
 <form method="POST" action="/cgi-bin/isearch">
 <input name="SEARCH_TYPE" type=hidden  value="ADVANCED">
 <input name="HTTP_PATH" type=hidden value="/WWW"> 
 <input name="DATABASE" type=hidden value="webindex">