Installing and setting up ZTM
-----------------------------

These instructions describes the install procedure of ZTM 2.5 beta-1.

1. Install ZOPE.

   You can download Zope at http://www.zope.org. Installation instructions are
   available for Windows and Unix/Linux at the same location

   ZTM 2.5 requires Zope 2.7. It does not work with current development versions
   of Zope (2.8 and higher) due to the new extensionclass implementation in ZODB
   3.3.
   
2. Install CMF

   We believe any version from 1.2 and up should work, though it has only been
   tested with CMF 1.4.

3. Install PyXML

   PyXML is needed to be able to import topicmaps. We are working on changes
   that will allow ZTM to run without PyXML.
    
   ZTM import depends on the XMLProc validator and the expat parser that are
   part of PyXML. This is used to validate XTM files.

   We have historically had numerous problems with the PyXML packages from
   sourceforge.
    
   On Linux (using the Gentoo distribution) we have have used PyXML 0.8.2 in
   Gentoo without problems.

   Andreas Johnsen reported success with the binary PyXML 0.8.3 from
   pyxml.sf.net for Windows.

   PyXML (on windows) may be difficult to install if the installer picks up a
   different python package (from the windows registry) than the binary
   installation that comes with Zope.

   You should be able to open the PyXML installer (the executable) in a program
   like WinZip.

   The trick is to copy the _xmlplus subfolder in PyXML to the version of
   Python that Zope uses. It can usually be found in the 'bin' subfolder of your
   zope installation on Windows.

   If you're having problems, don't hesitate to send requests for assistance to
   ztm-devel@lists.sourceforge.net or drop by the #topicmaps channel on
   irc://irc.freenode.net.

4. Install BTreeFolder2

   You can find it at: http://hathaway.freezope.org/Software/BTreeFolder2

5. Install PlacelessTranslationService

   This component is not strictly needed, but it makes dealing with unicode much
   easier. If you recieve lots of unicode errors, then this is the module for
   you.

   PTS can be found on http://sf.net/projects/collective.

5. Download and copy the ZTM modules into $INSTANCE_HOME/Products or
   $SOFTWARE_HOME/lib/python/Products.

   Where you want to install it depends on what sort of setup you want.

   If you do not know, simply locate a Products folder in your Zope installation
   and place the folder there.

6. Start/Restart Zope

7. Create a new CMF portal.

   You may also use existing CMF portals, if you can risk loosing data in that
   portal.

8. In the new CMF site, create a "Topic Map Tool".

   This should give you a new component called portal_topicmaps at the root of
   the CMF Portal.

9. Visit the install tab of 'portal_topicmaps', and run the setup.

   Here you can select language (which currently just selects a few different
   titles for folders)

   The setup code imports a small topic map into the system folder it just
   created.

You should now have a basic Topic Map portal.

This is only the basic topic map engine though. If you need content management
and more advanced Topic Management features follow the installation routine of
ZTMDefault module. (This is recommended.)

You can find instructions in ZTMDefault/docs/INSTALL.txt