Intergrate other applications

MKDoc does not have a form to email handler built in but often web sites need forms that send email, this how to explains how to intergrate soupermail, the same method can be used for any other web application.

Soupermail is a a very flexible form handler written in Perl and it is available from the Soupermail Sourceforge site.

Set up a new cgi-bin

You will need to set up a directory where the script can be run, for example, /var/www/your-mkdoc/site/cgi-bin/.

Install Soupermail

Put the script in the new cgi-bin directory, check the path to perl and the other variables and make it execuatable.

Soupermail does have one depandancy that is generally not installed on most distributions, MIME:Lite, this can be installed from CPAN.

Apache config

The key with the apache configuration is to have a ScriptAlias for soupermail before the MKDoc aliases, for example:

  ScripAlias /.soupermail   /var/www/your-mkdoc/site/cgi-bin/soupermail.pl
  Alias      /              /var/www/mkdoc-1-6/cgi/mkdoc.cgi/