add policy and theme products
[zope-bootstrap.git] / src / koehsel.policy / docs / INSTALL.txt
1 koehsel.policy Installation
2 ---------------------------
3
4 To install koehsel.policy 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.policy``. 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.policy-configure.zcml`` in the
20   ``/path/to/instance/etc/package-includes`` directory.  The file
21   should only contain this::
22
23     <include package="koehsel.policy" />
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.policy`` to the list of eggs to install, e.g.:
32
33     [buildout]
34     ...
35     eggs =
36         ...
37         koehsel.policy
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.policy
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.