Home Page Project Page Download CVS repository

Installing Xgridfit

To install Xgridfit on Linux, Mac OS X or Cygwin requires GNU Make (you may have to install this before proceeding). Once you have downloaded Xgridfit, copy it to a convenient location, open a terminal window and unpack the archive:

    tar xvf xgridfit-2.1.tar.gz

Now change to the xgridfit directory and install. You may first have to become root. Perhaps sudo will work (as below); but you may have to use su, entering the root password. If you can't do either of these things (or aren't allowed to), you'll have to get a system administrator to help you.

    cd xgridfit
    sudo make install

If you are installing on a Mac, type

    sudo make install-mac

If you want to install the documentation as well, instead type

    sudo make install-all

or

    sudo make install-all-mac

Xgridfit depends upon an XSLT processor. The Mac and most, perhaps all, Linux systems come with xsltproc, part of the XSLT library for Gnome (in Cygwin, you must install libxslt). But other free XSLT processors are available: Saxon version 6, Saxon version 9, versions of Xalan written in Java and C++, and 4xslt, written in Python. Xgridfit will work well with all of these processors, and some have advantages over others: Saxon 9, for example, is very fast when compiling large files, but xsltproc is faster when compiling small ones. To switch from one XSLT processor to another, run xgfconfig with the --processors or -p option and one or more of the following arguments:

• libxslt
• lxml
• saxon-6
• saxon-9
• xalan-j
• xalan-c
• xsltproc
• 4xslt

If you choose one of the Java-based processors, you must supply the complete pathname of its jar file after a hash mark. You can supply the name of more than one processor; Xgridfit will use the first by preference, the second as a backup, and so on. For example:

    $ xgfconfig -p saxon9#/usr/local/share/saxon/saxon9.jar lxml

If you run xgfconfig as root, your settings are saved in the file config.xml in the xgridfit directory (probably /usr/local/share/xml/xgridfit). These are global, applying to all users. If you run the program as a user, your settings are saved in ~/.xgridfit/config.xml; these local settings override the global ones. You can quickly restore the global settings by deleting ~/.xgridfit/config.xml.

You can also use xgfconfig to choose a validator. For details, see Using the schema: validation.