INSTALL

MaximaPHP Installation instructions
-----------------------------------


Version: 0.1.2		April 2, 2007
--------------		--------------


Prerequisites:
--------------

In order to use MaximaPHP you need the following programs to be installed
properly in your server.

- Web server capable to run PHP version 4 or above.
  See http://www.php.net/

- PERL script interpreter.
  See http://www.perl.org/

- Maxima computer algebra system.
  See http://maxima.sourceforge.net/

- Gnuplot graph plotting program.
  See http://www.gnuplot.info/

- Optionally TtM to convert TeX to MathML.
  See http://hutchinson.belmont.ma.us/tth/mml/


MaximaPHP installation
----------------------

- Extract MaximaPHP package into a directory under your web root directory.
  For example into 'maximaphp' directory.

- Move PERL scripts '_maxima_with_timeout_.pl' and '_ttm_with_timeout_.pl'
  to directory inaccessible from internet.
  For example into '/bin' directory.

- Edit 'mpconf.php' to fit your server configuration.
  
- Done. You can access your MaximaPHP from your website.
  For example 'http://YOUR_WEB_ROOT/maximaphp/'


MaximaPHP configuration
-----------------------

- Timeout for Maxima in seconds
$maximaTimeout = 9;

- Timeout for TtM in seconds
$ttmTimeout = 9;

- Path to Maxima wrapper with timeout control, should not be accessible from internet.
$maximaWithTimeout = 'YOUR_PATH/bin/_maxima_with_timeout_.pl';

- Path to Maxima program
$maxima = "YOUR_PATH/bin/maxima";

- Path to TtM wrapper with timeout control, should not be accessible from internet
$ttmWithTimeout = 'YOUR_PATH/bin/_ttm_with_timeout_.pl';

- Path to TtM program
$ttm = "YOUR_PATH/bin/ttm";

- Directory of Gnuplot program
$gnuplotDir = 'YOUR_PATH/bin';

- Temporary directory for Maxima to communicate with Gnuplot, should be writable by PHP and Maxima
$maximaTempDir = 'YOUR_PATH/temp';

- Cache directory for Gnuplot to save PNGs output, should be writable by Gnuplot and accessible from internet
$gnuplotPNGDir = 'YOUR_WEB_ROOT/png';

- URL path to cache directory for Gnuplot to save PNGs output
$gnuplotPNGUrl = 'http://YOUR_WEB_URL/png';

- Base URL path to directory of your MaximaPHP
$baseUrl = 'http://YOUR_WEB_URL';


Language configuration
----------------------

Replace the default 'mptext.php' and 'mpxhtml.php' with the appropriate file 
under 'lang' directory.
For example for Indonesian, replace default 'mptext.php' with 'lang/mptext-id.php' 
and 'mpxhtml.php' with 'lang/mpxhtml-id.php'.


URL rewriting configuration
---------------------------

If your web server support URL rewriting such as Apache, you may want to use 
URL rewriting capabilities to make the dinamic URL appears as static one. 
Replace the default '.htaccess' and 'mprewriteurl.php' with the appropriate 
file under 'rewriteurl' directory.
For example to use rewriting capability, replace default '.htaccess' with 
'rewriteurl/.htaccess-yes' and 'mprewriteurl.php' with 'rewriteurl/mprewriteurl-yes.php'.


---------------------------------------
if you have any questions please email
bowo prasetyo praNzOjp at gSmaPil dAMot com
(take NO SPAM for email address)


Documentation generated on Mon, 23 Apr 2007 13:00:27 +0900 by phpDocumentor 1.3.1