Jinja
Installation
Navigation
Contents
Jinja requires at least Python 2.3 to work correctly.
Installing a released version
As a Python egg (via easy_install)
You can install the most recent Jinja version using easy_install:
sudo easy_install Jinja
This will install a Jinja egg in your Python installation's site-packages directory.
From the tarball release
- Download the most recent tarball from the download page
- Unpack the tarball
- 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 Jinja into your Python installation's site-packages directory.
Installing the development version
If you want to play around with the code
- Install mercurial
- svn co http://dev.pocoo.org/hg/jinja-main jinja
- cd jinja
- ln -s jinja /usr/lib/python2.X/site-packages
As an alternative to steps 4 you can also do python setup.py develop which will install the package via setuptools in development mode. This also has the advantage that the c extensions are compiled.
If you just want the latest features and use them
sudo easy_install Jinja==dev
This will install a Jinja egg containing the latest Subversion trunk code in your Python installation's site-packages directory. Every time the command is run, the sources are updated from Subversion.
Windows Installation Information
On windows computers without Visual Studio 2003 Jinja is unable to compile the C extensions. This is usually not a problem because there is a fallback for native Python implementations of those C libraries. However under certain conditions the installation may fail with an error message. In that case try to disable the extensions by passing the following parameters to setup.py:
python setup.py install --without-speedups --without-extended-debugger
Documentation
The egg builds include a documentation which is available in the docs folder of the egg. If you're running linux you will find the documentation here:
file:///usr/lib/python2.X/site-packages/Jinja-Y.Z-py2.X.egg/docs/index.html
where X, Y and Z must be replaced by the python / jinja version number.