sugarplum for debian
--------------------

                Some Important Tips

Protect legitimate spiders from the poison!
 - copy or append ./examples/robots.txt to
   the root directory of your site (/var/www or wherever you've moved
   it).  edit it to deny your sugarplum directory if you choose a new
   location.
 - good spiders (i.e. google) will respect your wishes, so be kind!

Pick a more effective (and less obvious) name than "sugarplum"
 - for apache read the suggestion in /etc/sugarplum/apache.conf
 - for others, read up on however they're doing rewrites.
 - don't forget to restart your webserver after you make the change

To enable sugarplum under Apache2:
 - it should "just work" (when activated by `sudo a2enconf sugarplum`),
   as long as you use a "conf.d" style configuration.
 - it might be necessary to enable mod_rewrite: `sudo a2enmod rewrite`
 - if i've messed up, there's also info in ./installation-notes-general.txt

To enable sugarplum under WN web server:
 - see ./installation-notes-wn.txt

Don't forget to link to it on your site
 - this works by placing (or even hiding) a link somewhere on your
   site that points to the disallowed directory.  more information
   can be found in ./installation-notes-general, section 6
 - go to http://yoursite/sugarplum/foo and check it out

To enable/customize "teergrube" baiting:
 - see ./installation-notes-general, section 4

To enable logging:
 - uncomment/change the field "loglevel" to 1 in /etc/sugarplum/config
 - as root, 
 # touch /var/log/sugarplum.log
 # chmod 660 /var/log/sugarplum.log
 # chgrp www-data /var/log/sugarplum.log
 - if you change the logfile location, update the log rotation file
   too (/etc/logrotate.d/sugarplum), and realize that if you purge
   this package it won't know about the new logfile location.

 -- sean finney <seanius@debian.org>  Tue, 26 Apr 2005 19:55:23 -0400
