setuphandler cleanup
[zope-bootstrap.git] / src / koehsel.theme / docs / INSTALL.txt
1 koehsel.theme Installation
2 --------------------------
3
4 To install koehsel.theme into the global Python environment (or a workingenv),
5 using a traditional Zope 2 instance, you can do this:
6
7 * When you're reading this you have probably already run 
8   ``easy_install koehsel.theme``. Find out how to install setuptools
9   (and EasyInstall) here:
10   http://peak.telecommunity.com/DevCenter/EasyInstall
11
12 * If you are using Zope 2.9 (not 2.10), get `pythonproducts`_ and install it 
13   via::
14
15     python setup.py install --home /path/to/instance
16
17 into your Zope instance.
18
19 * Create a file called ``koehsel.theme-configure.zcml`` in the
20   ``/path/to/instance/etc/package-includes`` directory.  The file
21   should only contain this::
22
23     <include package="koehsel.theme" />
24
25 .. _pythonproducts: http://plone.org/products/pythonproducts
26
27
28 Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance
29 recipe to manage your project, you can do this:
30
31 * Add ``koehsel.theme`` to the list of eggs to install, e.g.:
32
33     [buildout]
34     ...
35     eggs =
36         ...
37         koehsel.theme
38        
39 * Tell the plone.recipe.zope2instance recipe to install a ZCML slug:
40
41     [instance]
42     recipe = plone.recipe.zope2instance
43     ...
44     zcml =
45         koehsel.theme
46       
47 * Re-run buildout, e.g. with:
48
49     $ ./bin/buildout
50         
51 You can skip the ZCML slug if you are going to explicitly include the package
52 from another package's configure.zcml file.