Chapter 2. Installation

The yaktrack package currently comes as a .tar (or .tar.gz) file containing all of the Python scripts you will need to operate yaktrack (an .rpm package is forthcoming in the distant future). To install yaktrack, simply untar it into a directory and set your path to point to the "src" subdirectory of the package. Yaktrack is still very much under development, so expect this primitive installation procedure to change dramatically in the future.

Also note that under the "src" directory are two directories (xml and Ft) representing software from other XML projects, in particular the Python XML SIG and FourThought LLC. These are both open-source products and can be downloaded separately-- the only reason they are included in this distribution is because the state of XML under Python is in constant flux and I wanted to ensure that everything continued working for some time. In the future, as these two packages become more stable and merge (I have heard that 4DOM, for example, the FourThought LLC implementation of the Document Object Model, will become the default DOM implementation for the PyXML package), they will be removed from this distribution and yaktrack will explicitly require them to work.

If you are installing this package to your website, be sure and put it in an executable directory which has write access enabled; yaktrack will need to create many files and directories as it operates. I certainly do not recommend giving root access to these tools! Also, be aware that the yaktrack tools will search for a repository starting in the directory from which they were invoked and moving "up" the tree, so be cognizant of where you will be executing the tools from.