README File for bw-blog (2003-04-29 -- wew)
--

BW-Blog is a simple blogging script for your web site.

You can find the latest version of BW-Blog at http://cgi.bw.org/

COPYRIGHT AND LICENSE

Copyright (c) 2003 William E. Weinman.

This program is free software; You may modify and distribute it under the
same terms as perl itself.

**IMPORTANT SECURITY NOTE**

This program requires that the web server have permission to create and
write files in a directory. Most web servers do not have a facility for
safely running CGI programs with a normal user's permissions. That means
that the permissions for the data directory may have to be set to allow
anyone to create and write files in it. If that is the case for your
server (and it is very commonly so for shared web servers), please put
the data directory OUTSIDE of the web document tree and name it
something other than "data".

If your system allows the web server to run as a normal user, it is
still a good idea to put your data outside of the web document tree, but
you will be able to use a more restrictive setting for the directory
permissions in step 2 below.

**END IMPORTANT NOTE**

INSTALLATION

1. Decide on a location for the script (bw-blog.cgi), the bwInclude.pm
library file, the html and images files, and the data directory. Make
sure directories exist on the server for all of these files.

2. Set the permissions for the data directory. On a Unix-ish system that
usually means chmod 777 (if your web server allows CGI to run as a
normal user you may be able to use 700 or 770 instead). The point is to
make sure that the web server is able to read, write, and create files 
in this directory.

3. Edit the bw-blog.cgi script. Set the $html_dir and $data_dir variables
to point to the directories you decided on in step 1.

**IMPORTANT** When editing/saving the .cgi file, make sure the line-
endings are correct for your system! Usually the unix-ish (LF) line-
endings work, even on a Windows system.

4. Edit the HTML files to taste.

5. Edit the users file in the data directory. This file controls the
username and password for adding, editing, and deleting blog entries.
Choose a username and replace "admin" with your username. Choose a 
password and replace "password" with your password. 

**IMPORTANT** If you leave the username and password as "admin" and
"password" you will leave your blogs wide open to all kinds of mischeif.
Don't do that.

6. Upload everything to the server. Be sure all the files end up in the
locations you selected in step 1.

7. Rename bw-blog.cgi if necessary for your system.

8. Set the file permissions on bw-blog.cgi to executable (755 for Unix-
ish systems).

9. Test by using your web browser with the appropriate URL for the
location on your server wher you installed the program. For example on my
server it may be http://cgi.bw.org/bw-blog/bw-blog.cgi

10. Edit or delete the default blog entries, and create your own new
entries by using the administrators pages.
                       http://your-server/your-path/bw-blog.cgi?cmd=login

--
END OF README