|
|
|
|
==============
|
|
|
|
|
Installation
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
Install the extension with one of the following commands::
|
|
|
|
|
|
|
|
|
|
$ easy_install sigal
|
|
|
|
|
|
|
|
|
|
or alternatively if you have pip installed::
|
|
|
|
|
|
|
|
|
|
$ pip install sigal
|
|
|
|
|
|
|
|
|
|
Dependencies
|
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
- Click
|
|
|
|
|
- Jinja2
|
|
|
|
|
- Pilkit
|
|
|
|
|
- Python Imaging Library (PIL / Pillow, see below)
|
|
|
|
|
- Python Markdown
|
|
|
|
|
|
|
|
|
|
PIL or Pillow ?
|
|
|
|
|
~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
PIL_ is almost dead, the last release was in 2009. If possible you should
|
|
|
|
|
prefer to use Pillow_, a fork of PIL which is actively developped, with
|
|
|
|
|
packaging improvements, Python 3 compatibility, etc.
|
|
|
|
|
|
|
|
|
|
You can install Pillow with ``pip install Pillow``, preferably in a
|
|
|
|
|
virtualenv_. To have JPG and PNG support, you must first install the
|
|
|
|
|
developpement packages of libjpeg, freetype2 and zlib.
|
|
|
|
|
|
|
|
|
|
- For Debian/Ubuntu, this is possible with::
|
|
|
|
|
|
|
|
|
|
apt-get build-dep python-dev python-imaging
|
|
|
|
|
|
|
|
|
|
Debian/Sid users can use the experimental ``python-imaging`` package that is
|
|
|
|
|
built from Pillow source.
|
|
|
|
|
|
|
|
|
|
- For Archlinux, there is a package_ for sigal in the AUR which already uses
|
|
|
|
|
Pillow.
|
|
|
|
|
|
|
|
|
|
.. _PIL: http://www.pythonware.com/products/pil/
|
|
|
|
|
.. _Pillow: https://github.com/python-imaging/Pillow
|
|
|
|
|
.. _package: https://aur.archlinux.org/packages/sigal/
|
|
|
|
|
.. _virtualenv: http://www.virtualenv.org/
|
