1. Installation of mwlib
    1. Requirements
    2. Optional parts
    3. Install mwlib with easy_install
    4. Install the latest mwlib from the tarball
    5. Install the latest mwlib from the Mercurial repository
    6. After the install of mwlib

Installation of mwlib

Requirements

mwlib is available as an egg file, installable with easy_install mwlib. There is a Mercurial repository at http://code.pediapress.com/hg/mwlib/.

mwlib is thoroughly tested on Debian testing and should work on any UNIX-like operating system. Using mwlib on Windows is not tested very well and may lead to problems (see for example the flup FAQ, flup is used in mw-serve). If you are not fearful , there is a Windows Setup Guide. May you have a look on the mailing list: what works and does not under windows.

Optional parts

In order to have rendering of math formulas, you need to have the following packages installed:

For rendering of timelines, you need to install ploticus.

If you want to install mwlib from the source tarball or from the Mercurial repository, you need re2c >= 0.13, gcc and make.

If you want to build the documentation you need docutils.

Install mwlib with easy_install

Make sure, you have the needed environment. On Debian systems: 

# apt-get install g++ perl python python-dev python-setuptools python-imaging

Simply download and install mwlib with easy_install: 

# easy_install mwlib && rehash

Now you're ready to use mw-lib. See some Examples or, if there are any kind of trouble, please see the bottom of this page.

Install the latest mwlib from the tarball

Make sure, you have the needed environment, especially re2c (Note: the version of re2c included in Debian etch is too old).

On Debian systems: 

# apt-get install make g++ perl python python-dev python-setuptools python-imaging re2c

Get the mwlib tarball and unpack it: 

$ wget http://code.pediapress.com/hg/mwlib/archive/tip.tar.gz && tar xzf tip.tar.gz

Change to the created a directory mwlib-<somehexdigits>, build and install: 

$ python setup.py build install

Install the latest mwlib from the Mercurial repository

Make sure, you have the needed environment, especially re2c.
Note: the version of re2c included in Debian testing (lenny) or Ubuntu 8.04 is too old.
Please get the Source Code of re2c from sourcforge.net and build it from the sources.

On Debian systems: 

# apt-get install make g++ perl python python-dev python-setuptools python-imaging re2c

Install Mercurial. On Debian: 

# apt-get install mercurial

Check out the code: 

$ hg clone http://code.pediapress.com/hg/mwlib mwlib.hg

Build mwlib: 

$ cd mwlib.hg && make

And finally install mwlib: 

# python setup.py build install

OR, if you plan to change the source code and want to use your changes: 

python setup.py build develop

After the install of mwlib

Please start playing around with Examples or visit the Troubleshooting.
Please report (new) errors in the mailing list. Before precipitate mailing, please keep this in your mind.
Also provide a meaningful description of your problem, including e.g. the version number of the involved software components and additional information to solve your problem.