This file should (hopefully) walk you through a basic installation and
implementation of the lucid calendar. Obviously, looking through the
code some will be the most useful thing to you, but this should get
you started without too much hassle.

1) Put the source distribution into a directory on your site. Unpack
it using something like

   gunzip -c lucid_calendar-{ver}.tar.gz | tar xvf -

This will create a directory called "calendar" under the current
directory where the files reside.

2) cd into "calendar".

3) I'm assuming you have a MySQL database ready to go that you can
make tables on. We'll pretend it's called "your_db". Run the command

   mysql [options] your_db < lucid_calendar.mysql

where [options] is any options you need to include (such as a
password). This will create the necessary tables in your_db.

4) cd to the "api" folder. Open "cal.api" in your favorite text editor
and edit the first four variables as you need to for your
system. These variables just indicate the database name, user name,
password, and server.

Incidentally, since this file contains information about your
database, I HIGHLY recommend protecting it in some way (htpasswd, for
example) so that it's not world readable.

5) Fire up a web browser and navigate to /calendar/admin/ where you'll
find the administrator stuff. Click on "Add a new posting
administrator."

Remember that stuff I said about protecting the "api" directory? You
might want to do that here too.

6) Fill in the necessary information and submit it. Then go back to
the admin home page. Click on "Post an event."

7) Fill in the information needed to post an event for sometime in
the current month. Submit it.

8) Finally, naviate to /calendar/cal.php3. You should see a calendar,
and the event you just posted should be visible there. If all this
works for you, then you've probably installed the thing successfully.

-Chris Lea <chrislea@luciddesigns.com>
