paula.testing: WIP
[paula.git] / paula.plonepas / docs / INSTALL.txt
blobe56fe6050c08800579e1894adbc5ec57a0c9693d
1 paula.plonepas Installation
2 ==========================
4 To install paula.plonepas into the global Python environment (or a workingenv),
5 using a traditional Zope 2 instance, you can do this:
7  * When you're reading this you have probably already run 
8    ``easy_install paula.plonepas``. Find out how to install setuptools
9    (and EasyInstall) here:
10    http://peak.telecommunity.com/DevCenter/EasyInstall
12  * Create a file called ``paula.plonepas-configure.zcml`` in the
13    ``/path/to/instance/etc/package-includes`` directory.  The file
14    should only contain this::
16        <include package="paula.plonepas" />
19 Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance
20 recipe to manage your project, you can do this:
22  * Add ``paula.plonepas`` to the list of eggs to install, e.g.:
24     [buildout]
25     ...
26     eggs =
27         ...
28         paula.plonepas
29         
30   * Tell the plone.recipe.zope2instance recipe to install a ZCML slug:
31   
32     [instance]
33     recipe = plone.recipe.zope2instance
34     ...
35     zcml =
36         paula.plonepas
37         
38   * Re-run buildout, e.g. with:
39   
40     $ ./bin/buildout
41         
42 You can skip the ZCML slug if you are going to explicitly include the package
43 from another package's configure.zcml file.