.. -*- mode: rst -*-

============
Installation
============

Pygments requires at least Python 2.3 to work correctly. Just to clarify:
there *wont't* ever be support for Python versions below 2.3.


Install the Release Version
===========================

1.  download the recent tarball from the `download page`_
2.  unpack the tarball
3.  ``sudo python setup.py install``

Note that the last command will automatically download and install
`setuptools`_ if you don't already have it installed. This requires a working
internet connection.

This will install Pygments into your Python installation's site-packages directory.


Install via easy_install
========================

You can also install the most recent Pygments version using `easy_install`_::

    sudo easy_install Pygments

This will install a Pygments egg in your Python installation's site-packages
directory.


Installing the development Version
==================================

1.  Install `subversion`_
2.  ``svn co http://trac.pocoo.org/repos/pygments/trunk pygments``
3.  ``ln -s `pwd`/pygments/pygments /usr/lib/python2.X/site-packages``
4.  ``ln -s `pwd`/pygments/pygmentize /usr/local/bin``


.. _download page: http://pygments.pocoo.org/download/
.. _setuptools: http://peak.telecommunity.com/DevCenter/setuptools
.. _easy_install: http://peak.telecommunity.com/DevCenter/EasyInstall
.. _subversion: http://subversion.tigris.org/