Personal tools
You are here: Home Documentation Tutorials DIYPloneStyle: Creating a Custom Style for Plone Getting Started - The Automated Way
Support

Get Help

Join our chat rooms or support forums if you have more specific questions.

Plone Training
Learn how to design, build, and deploy a website in Plone through one of the numerous Plone training sessions around the world.
Find Plone training…
 
Document Actions

Getting Started - The Automated Way

Using the built-in generator script for quick skeleton creation.

David Convent

This tutorial will teach you how DIYPloneStyle can be used as a base for creating a custom style product for Plone 2.1 or Plone 2.5 that adds to a portal a new skin selection and makes use of the new stylesheet and javascript registries.
Page 4 of 10.

You learned from the first part of this chapter how to manually setup DIYPloneStyle for making it a ready to go skin skeleton product.

There is a much faster way to get a clean product that can become a new style for Plone, by making use of the included generator script.

In the DIYPloneStyle product folder on the filesystem, there is a bin/ directory where you will find a python script called generator.py. This script can be used for applying all the manual modifications that are listed in the previous part of this chapter.

Download and Expand DIYPloneStyle

  • Place the expanded DIYPloneStyle product folder in the Products/ directory of your Zope instance.
  • Uninstall DIYPloneStyle if you already installed it (in Plone, as manager, go to Site Setup > Add/Remove Products).

Run the script

On Unix/Linux/OSX

From a bash shell (from the Terminal), use a command which should look like this one:

   /path_to_zope_instance_home_folder/Products/DIYPloneStyle/bin/generator.py --productname MyOwnPloneSkin

On Windows

  • Choose run from the Windows Start menu and type cmd. Press OK
  • Run the script with a command which should look like this one:
       python c:\instance_home_folder\Products\DIYPloneStyle\bin\generator.py --productname MyOwnPloneSkin
    

On Unix like systems, you can call the script from any directory.
On Windows you can't: your current working directory must be outside the product.

I've heard about permission problems on Windows when using the script from a subversion checkout of DIYPloneStyle.
If you need to work with the latest svn trunk version of the product under Windows, take the time to remove all its .svn folders before running the script.

Start Building

You now have a fresh Plone skin product in the Products/ directory of your Zope instance.
All you have to do when you want it to be installable in Plone is to restart the Zope server.

 

Note
If you want to learn more about the possible script arguments, you can either see the script output when called without args (or with the --help option) or read its fairly easy to understand code.
 
by David Convent last modified November 14, 2005 - 02:03 All content is copyright Plone Foundation and the individual contributors.

For any issues with the web site functionality, please file a ticket.

Please consult the policy on plone.org content if you want your content published on this site.

Servers and hosting by