***************************************************************************
* Installation Instructions                                               *
*                                                                         *
***************************************************************************
* Please note: This Version has only been tested with MoinMoin 1.6.       *
*              Newer MoinMoin version probably won't work.                *
*              For MoinMoin 1.5 you can use the older version 0.5.        *
***************************************************************************


Automatic Install
-----------------

The following should work for Windows and Linux, provided that you installed
MoinMoin from the original sources and not with the package manager of your 
linux distribution.

   - Extract the downloaded archive file

   - Open your linux shell or windows command prompt

   - Change to the directory where the extracted files from 
     the archive are. (It's the directory with the file "setup.py")

   - Install MoinMoin2ODT by typing:

         python setup.py install

     If Windows can't find "python" you have to include the path to python. 
     For example if you installed python in C:\Python25 you have to type:

         C:\Python25\python setup.py install

   - Restart your webserver afterwards. 

   - You should see a new item in the MoinMoin action drop down box: 
     "Render as OpenDocument"


Manual Install for MoinMoin DesktopEdition
------------------------------------------

   - Extract the downloaded archive file

   - Copy 
        MoinMoin/action/RenderAsOpenDocument.py
     to
        <Directory of your MoinMoinDesktopEdition>/wiki/data/plugin/action

   - Copy
        MoinMoin/formatter/application_odt_pseudoformatter.py
     to
        <Directory of your MoinMoinDesktopEdition>/wiki/data/plugin/formatter

   - Restart your MoinMoin DesktopEdition

   - You should see a new item in the MoinMoin action drop down box: 
     "Render as OpenDocument"


Manual Linux Install
--------------------

You may have to do this manual install if you installed MoinMoin with the 
package manager of your linux distribution. At least I could test this with 
the moinmoin packages from Debian.

Some distributions like debian change the location of python
site-packages for MoinMoin.
To find the location in your distro you can do a 
$ locate formatter/text_xml.py

Here (Debian 4.0) I get:
/usr/share/python-support/python-moinmoin/MoinMoin/formatter/text_xml.py
/var/lib/python-support/python2.4/MoinMoin/formatter/text_xml.py

First we copy the needed files to the found /usr/.../MoinMoin directory:
$ cp MoinMoin/action/RenderAsOpenDocument.py /usr/share/python-support/python-moinmoin/MoinMoin/action
$ cp MoinMoin/formatter/application_odt_pseudoformatter.py /usr/share/python-support/python-moinmoin/MoinMoin/formatter

In debian the /var/.../MoinMoin directory contains links to the real python files,
so we have to create links there:
$ cd /var/lib/python-support/python2.4/MoinMoin/action
$ ln -s /usr/share/python-support/python-moinmoin/MoinMoin/action/RenderAsOpenDocument.py
$ cd /var/lib/python-support/python2.4/MoinMoin/formatter/
$ ln -s /usr/share/python-support/python-moinmoin/MoinMoin/formatter/application_odt_pseudoformatter.py

Restart your webserver afterwards.

