DIY Plone Style (3.0)
- DIY Plone Style download link: http://plone.org/products/diyplonestyle/releases
- Homepage of DIY Plone Style: http://plone.org/products/diyplonestyle/
- DIY Plone Style repository: https://svn.plone.org/svn/collective/DIYPloneStyle
- Description source: https://svn.plone.org/svn/collective/DIYPloneStyle/trunk/README.txt
DIYPloneStyle is a skeleton product to start from when writing a new installable theme (visual design) for Plone 3.0.
Installation
On the file system: Symlink directories contained in the DIYPloneStyle/example folder in the Products directory of your Zope instance. Restart the server.
In the Plone Web Interface: as portal manager, go to 'Portal > Site Setup > Add-on Products'. Select one of the provided examples and click the *Install* button.
Uninstall -- Can be done from the same page.
Selecting a skin
Depending on the values given in the skins tool profile (see profiles/default/skins.xml), the provided theme will be selected (or not) as default one while installing the product.
Default skin can be set manually from 'Portal > Site Setup > Themes' in the Plone Web Interface (as portal manager).
Note -- a full refresh of the page and/or images (not from browser cache) may be needed after selecting a skin.
Creating a new theme
A theme for Plone is a selectable skin with associated stylesheets. This product is an example theme that is meant to be used for getting started
while developing a new one.
It is very easy to generate a clean copy of this product (with customized names for product, folders, files, modules, etc) by using the generator
script located in the bin/ directory.
To get script usage instructions, type in a terminal::
$ cd $INSTANCE_HOME/Products/DIYPloneStyle
$ ./bin/generator.py --help
Usage
Full documentation for DIYPloneStyle, with many pointers to other resources on how the "Skins Tool" and the "Resource Registries" work is
located at http://plone.org/documentation/tutorial/creating-custom-style.
This product is also the code example of Alexander Limi's step by step tutorial on how to create a look for Plone completely different than the
original one, which can be found at http://plone.org/documentation/tutorial/creating-plone-themes.