You will need

  • A unix-like operating system like Debian (testing).
    Note: mwlib/mwlib.rl is not tested very well on Windows, but if this doesn't worry you, there is a Windows Setup Guide.
    We also recommend that windows users have a look on the mailing list: what works and does not under windows.
  • reportlab (installs automatically)
  • setuptools
  • subversion
  • mwlib
  • pygments
  • fribidi
  • imagemagick
  • gs
  • ocaml
  • gcc
  • some tex stuff. e.g texvc

Note: You must have mwlib already installed!
If it is not already installed, have a look at the mwlib page and the mwlib install guide!

Before you start, you should have read the Readme and the information about the PDF writer extension!

Installation (on Debian)

Install some libs, imagemagick, subversion and setuptools:

  # apt-get install gs cjk-latex tetex-extra python-pyfribidi libfribidi0 libfribidi-dev python-pygments imagemagick subversion python-setuptools

You need make, gcc and ocaml to build texvc:

  # apt-get install make binutils gcc ocaml  

Then get texvc, build and install it:

  $ svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/phase3/math texvc.svn
  # cd texvc.svn && make && cp texvc /usr/local/bin/ && cd ..

Finally (easy) install mwlib.rl :

   # easy_install mwlib.rl

This will install reportlab too.

Now you are (hopefully) done. Just have a look to the new output writer :

  $ mw-render --list-writers

The response should include something like "rl PDF documents (using ReportLab)".
Test it with:

  $ mw-render -c :en -w rl -o sun.pdf Sun

After the installation of mwlib.rl

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.
Assuming you are unable to find the answer you need in the documentation or mailing list archives please make sure that you provide a meaningful description of your problem. This should include, for example, the version number of the involved software components and any other information you think will help resolve things.