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:
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:
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:
In order to run coverage tests, which includes upgrade tests use:
You can view the coverage results in the htmlcov directory via:
Working with CSS
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.