HomePageMaker v.1.1 written by Dave Palmer <dave@upstatepress.com>

Pardon this quick and dirty documentation. I'll work on this later. 
I just wanted to get this done. I will also be working on an HTML
online help file for user's when creating a new page. It will be
linked to the form where they enter in their information. 

There are some minor little things user's must be made aware of, which
are listed in detail in this document.

Okay :-)

First, I'll just say that HomePageMaker v.1.1 is freeware so therefor
I do not offer support with installation or modifications. I hope I
hit everything in this. If not, you can ask, and I usually answer 
everything that comes in my box. I just can't make garuntees.

Alright, lets move on.

MODIFICATIONS

File: homepage.pl

This is the actual script that does everything (well, everything homepagemaker
is supposed to do!)

Actually very little must be changed with this. Here are the variables you must
change:

$base_dir	This is your base directory. It is a PATH not a URL.

$base_url 	This is your URL to the userpages directory. I'll get
		into why you need this in a bit

$page_dir	This is the PATH to where userpages (the directory) is.
		you shouldn't really need to change this, unless you put
		the directory: userpages in a subdirectory

$indexpage	Don't change this, okay! As long as you have your $page_dir
		set correctly, you won't need to change this.

$data		This is the location of the data.txt file. Again, you shouldn't
		have to change this either.

$image_dir	This is the directory where you're going to store your background
		images.

$sendmail 	This is the path to your Unix system's sendmail program. If you're
		a windows user, well, I'm working on a ported for windows version
		of this okay!

$myemail	Well, this is just your e-mail address

Okay, that's it for homepage.pl file.

File: makepage.html

This is the form in which the user uses to create a new page, or to edit
an existing page.

The only thing that needs to be changed is the <form action="/cgi-bin/homepage.pl" 
method=POST> Just make sure that the action="/...." statement is the url to your
cgi-bin

File: data.txt

Do not change anything. Its just an emtpy text file, but homepagemaker will use
this file!

File: index.html

This is the index file where homepagemaker will create links to all of the new
pages your users create. You can change any of the wording or layout of this
page to suite your needs. Just make sure you DO NOT delete the: <!--begin-->
comment!


INSTALLATION

1. create the userpages directory where you specified in the $page_dir variable above
2. upload homepage.pl to your cgi-bin
3. upload the index.html file to userpages
4. upload makepage.html to userpages
5. upload data.txt to userpages
6. create the 'images' directory in userpages
7. upload your 3 images* to the images directory

PERMISSIONS

1. directory userpages --> chmod to: 777
2. file homepage.pl --> chmod to: 755
3. file data.txt --> chmod to: 777
4. file index.html --> chmod to: 777

*You don't have to use my background images. But make sure that the images you do use
are named: back1.gif, back2.gif, back3.gif. 


MISC

The "Name of Page" field on the makepage.html file is NOT the <title></title> of
the page. It is the name they are giving to the HTML file they are creating. If they
try to enter more than one word, HPM will simply replace the spaces with underscores.
The user MUST know this page name in order to edit their page at a later date. 

HPM will e-mail the user a notification of their new page, and if they edit their page
they will also receive a notification of that as well.

I think that should be it!