Installation

To install Diazo, you should install the diazo Python distribution.

Note: The Diazo package is only required to get the Diazo compiler and development tools. If you deploy your Diazo theme into a web server, you do not need the diazo distribution on that server.

You can install the diazo distribution using easy_install, pip or zc.buildout. For example, using easy_install (ideally in a virtualenv):

$ easy_install -U diazo

If using zc.buildout, you can use the following buildout.cfg as a starting point. This will ensure that the console scripts are installed, which is important if you need to execute the Diazo compiler manually:

[buildout]
parts =
    diazo

[diazo]
recipe = zc.recipe.egg
eggs = diazo

Note that lxml is a dependency of diazo, so you may need to install the libxml2 and libxslt development packages in order for it to build. On Debian/Ubuntu you can run:

$ sudo apt-get install build-essential python2.6-dev libxslt1-dev

On some operating systems, notably Mac OS X, CentOS and other RedHat-based Linux distributions, installing a “good” lxml egg can be problematic, due to a mismatch in the operating system versions of the libxml2 and libxslt libraries that lxml uses. To get around that, you can compile a static lxml egg using the following buildout recipe:

[buildout]
# lxml should be first in the parts list
parts =
    lxml
    diazo

[lxml]
recipe = z3c.recipe.staticlxml
egg = lxml

[diazo]
recipe = zc.recipe.egg
eggs = diazo

Once installed, you should find diazocompiler and diazorun in your bin directory.

If you want to use the WSGI middleware filter, you should use the [wsgi] extra when installing the Diazo egg. See Quickstart for an example.