#set $full_package_name = "%s.%s.%s" % ($namespace_package, $namespace_package2, $package)
${project} Installation
=======================

 * When you're reading this you have probably already run
   ``easy_install ${project}``. Find out how to install setuptools
   (and EasyInstall) here:
   http://peak.telecommunity.com/DevCenter/EasyInstall

#if str($zope2product) == 'True'
 * Get `pythonproducts`_ and install it via::

       python setup.py install --home /path/to/instance

   into your Zope instance.

#end if
 * Create a file called ``${project}-configure.zcml`` in the
   ``/path/to/instance/etc/package-includes`` directory.  The file
   should only contain this::

       <include package="${full_package_name}" />

#if str($zope2product) == 'True'
.. _pythonproducts: http://plone.org/products/pythonproducts
#end if

Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance
recipe to manage your project, you can do this:

 * Add ``${project}`` to the list of eggs to install, e.g.:

    [buildout]
    ...
    eggs =
        ...
        ${project}

  * Tell the plone.recipe.zope2instance recipe to install a ZCML slug:

    [instance]
    recipe = plone.recipe.zope2instance
    ...
    zcml =
        ${full_package_name}

  * Re-run buildout, e.g. with:

    $ ./bin/buildout

You can skip the ZCML slug if you are going to explicitly include the package
from another package's configure.zcml file.
