
INSTALLATION FOR LINUX AND UNIX-LIKE SYSTEMS

Please note that the tools required for all forms of GELLMU are
cross-platform tools.  They are available without cost for all
major platforms including Intel/Win32, Mac OS X (at least via the
underlying variant of Unix), all variants of Unix, and GNU/Linux.

The scripts in "bin/linux" should be adaptable to any of the
above platforms except Intel/Win32.  The scripts should be adaptable
for Intel/Win32 if the platform is equipped with Cygwin (which is
available without cost at http://www.cygwin.com/).

1.  First make sure that your platform has pre-requisites.

  a. GNU Emacs
        Web page:    http://www.gnu.org/software/emacs/emacs.html
        Source:      http://ftp.gnu.org/pub/gnu/emacs/
        Win32 Build: http://www.gnu.org/software/emacs/windows/ntemacs.html

  b. Perl
        Web:         http://www.perl.org/

  c. OpenSP
        Web:         http://openjade.sourceforge.net/

  d. TeX
        TeX Users Group: http://www.tug.org/
        CTAN:            http://www.ctan.org/

2.  Download the gellmu tarball.

3.  Create an empty directory (for example "/usr/local/gellmu")
    and unpack the tarball there.  The root directory in the tarball
    is called "gellmu".

4.  Make sure that command names used by the scripts "lmkg" and
    "mmkg" in "bin/linux" are available in your command path or else
    edit the scripts, as provided therein, to use full pathnames that
    are correct for your platform.

5.  Define the variable GELLMU_StyleDir in your environment.
    It should be the full pathname of the directory where you
    keep your version of the CSS stylesheet "css/mxh.css" and
    also the necessary XSL stylesheets provided by the W3C Math
    Group, http://www.w3.org/Math/XSL/.  Please note that MathML
    rendering will fail if the XHML + MathML output links to
    "mathml.xsl" UNLESS these files are found on your local
    platform for local platform viewing or on the web server
    where your XHTML + MathML version is served.  The default
    value of GELLMU_StyleDir, if not found in your environment,
    is "../webstyle".  This will work "out of the box" only for
    local platform viewing of files in the "doc" and "examples"
    directories of the distribution tree.

