In addition to Git and Python, you need to have Ruby, Erlang and some stuff installed. Via MacPorts install:

pcre pkgconfig rb19-haml erlang

Follow the typical buildout steps:

python2.6 bootstrap.py -dc development.cfg
bin/buildout -c development.cfg

Start supervisor and stop instance:

bin/supervisord
bin/supervisorctl stop instance

To create a Plone site in the database call:

bin/instance create_site

To overwrite an existing site and set the admin password, you can use:

bin/instance create_site --force --rootpassword=admin --language=no

Finally start the instance again:

bin/supervisorctl start instance

Access the site via one of:

https://localhost:8080/
http://localhost:8081/Plone/

Log in via admin/admin. In order to use some features like the streams, you need to create a user inside the Plone site via the Manage users link.

You can run tests for all packages at once using:

bin/test

In order to run coverage tests, which includes upgrade tests use:

bin/coverage
bin/report-html

You can view the coverage results in the htmlcov directory via:

open htmlcov/index.html

We are using SASS to generate our CSS files. On Mac OS use macports to install it:

sudo port install rb19-haml

The Ruby 1.8 version available via rb-haml is too outdated for our purposes.

To update all CSS files from their SCSS source files, call:

sass --update src/intranett.theme/intranett/theme/skins/intranett_theme_styles:src/intranett.theme/intranett/theme/skins/intranett_theme_styles

To update the translation files, do:

sh src/intranett.policy/intranett/policy/rebuild.sh
sh src/intranett.policy/intranett/policy/sync.sh

Add a new upgrade handler at the bottom of the upgrades.steps module. Use the next integer available in the @upgrade_to(42) decorator. The upgrade handler is called with the portal_setup tool as the context.

You also need to add a test to upgrades.tests. You can write a before_42 and after_42 method. They will be called with a real site being migrated to the point before and after your upgrade step is run.

There's no other places involved - neither ZCML nor metadata.xml files.

If you need to work on email related tasks, you can use the bin/debugsmtp script. It starts a simple mail server which dumps all received mails to the console. The text is quoted, so replace =3D by = and remove = on the line endings.

To use it go to http://localhost:8080/Plone/@@mail-controlpanel and change the mail server to be localhost on port 8025.