INSTALL.txt

Meta:

  Valid for:  Docma 0.2.2
  Author:     Christian Zagrodnick
  Email:      [email protected]
  CVS:        $Id: INSTALL.txt,v 1.7.2.1 2003/03/27 11:17:18 zagy Exp $

DocmaServer is a Python application developed by Infrae for the processing and generation of Silva XML. Note that DocmaServer is not a Zope product; it is an independent application that can be access remotely by Silva using XML-RPC.

Installing Docma

Docma depends on several other software products.

Active State's Python (>=2.2)

Active State's Python distribution contains besides Python itself expat for XML processing and the PythonCOM library.

It can be found here:

http://activestate.com/Products/ActivePython/

or just download the file here:

http://downloads.activestate.com/ActivePython/windows/2.2/ActivePython-2.2.2-224-win32-ix86.msi

This installs itself to C:\Python22.

Twisted

Twisted is a framework, written in Python, for writing networked applications.

Download it here

http://twistedmatrix.com/

or directly here

http://twistedmatrix.com/products/get-current.epy?type=win32-py2.2.exe

After installing Python install Twisted. On setup twisted shows you available Python installations. Select Python Version 2.2 in C:\Python22.

PyXML

PyXML offers better XML processing facilities as Python itself.

Download it here

http://pyxml.sourceforge.net/

or grab PyXML 0.8.2 from here

http://switch.dl.sourceforge.net/sourceforge/pyxml/PyXML-0.8.2.win32-py2.2.exe

Microsoft Word 2000

This version of Docma depends on Word 2000 beeing installed on the same machine.

Unpack the Docma archive to a folder of you choice. Edit config.py to suit your needs, the comments in there explain the configuration options. Start the server with the server.py file, which should be associated to the just installed Python 2.2.

Assuming you have a recent version of Silva installed and running, go to the Zope Management Interface (ZMI) and add a ``Silva Docma Service'' into your ``Silva Root''. Selecting ``Add and Configure'' leads you directly to the configuration screen. The configuration screen will always state whether there is a connection to a Docma server or not. If Silva is connected to a Docma server the import and export pages have additional options for using it.