pjs/webtools/doctor
myk%mozilla.org c41db82b06 bug 412437: don't allow null characters in file paths and don't allow regurgitation of uploaded content in Doctor; r=justdave; npotb 2008-02-11 19:54:31 +00:00
..
Doctor
templates
.cvsignore
.htaccess
Doctor.pm
README
doctor.cgi
doctor.css
doctor.js
install.pl
robots.txt
sample.conf

README

To use Doctor, first configure it by copying sample.conf to doctor.conf
and editing doctor.conf according to the instructions in it.

Then make sure you have the Template, AppConfig, File::Temp, Text::Diff,
Email::Valid, and MIME::Entity modules (and their dependencies), which you
can get via CPAN:

perl -MCPAN -e"install Template, AppConfig, File::Temp, Text::Diff, Email::Valid, MIME::Entity"

If you want to use the WYSIWYG editing capabilities of doctor, download
the htmlarea package (latest release or 3.0rc1) from the following site:

http://www.dynarch.com/projects/htmlarea/

Expand the package, then rename the directory it creates to "htmlarea"
and move it into the root directory of your web site.  Finally, create
a symlink called "htmlarea" inside the doctor directory that points to
the "htmlarea" directory.

Then configure your web server to serve Doctor files correctly.  See the
.htaccess file for an explanation of the configuration options, but note that
you should add the options to the global Apache configuration file if you have
access to it since the global file is much more performant than .htaccess.

Finally, put the doctor/ directory into your web server's cgi-bin/ directory
(or another location where you can run CGI scripts) and browse to doctor.cgi.

You may want to edit the templates in the templates/ subdirectory to refer
to your own website instead of the mozilla.org website.