Simplicity: documentation

Installation instructions
Customising

Installation instructions for Simplicity

The easiest way to install Simplicity is to include it in a buildout. You can find out more on using buildout with Plone in this tutorial: Managing projects with zc.buildout.

In your buildout file, include the following lines:

Under the eggs = section in your buildout file (e.g. buildout.cfg), add plonetheme.simplicity, i.e.

[buildout]
eggs =
    plonetheme.simplicity

In the same file under [instance] (or [clientx] if using Zeo), add plonetheme.simplicity, i.e.

zcml =
   plonetheme.simplicity

and re-run buildout. This will download and install Simplicity for you. You can then install this into your Plone site using “Add-on Products” (or “Add / remove products” depending on which version of Plone 3 you are using) via your site’s “Site’s setup” link (usually in the top right hand corner of your site). You can also install via the ZMI using the portal_quickinstaller or via portal_setup.

You can also install Simplicity into your Python environment. The instructions below were dynamically generated during the creation of the Simplicity theme product so apologies if they’re not totally clear:
* When you’re reading this you have probably already run
“easy_install plonetheme.simplicity“. Find out how to install setuptools
(and EasyInstall) here:

http://peak.telecommunity.com/DevCenter/EasyInstall

* If you are using Zope 2.9 (not 2.10), get `pythonproducts`_ and install it
via::

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

into your Zope instance.

* Create a file called “plonetheme.simplicity-configure.zcml“ in the
“/path/to/instance/etc/package-includes“ directory. The file
should only contain this::

.. _pythonproducts: http://plone.org/products/pythonproducts

Customising

You can change the main banner image by creating a new image called banner.jpg at the root of your Plone site or within the portal_skins/custom directory your site in the Zope Management Interface (ZMI).

The banner file should be 750px width, 250px height.

If you wish to customise any of the CSS, you should edit the simplicity.css file in the plonetheme_simplicity_styles directory in your site’s portal_skins folder, via the ZMI. The easiest way to do this is to click on the file in the ZMI and then click the “Customise” button. This will create an editable version in the portal_skins/custom folder.

David Little