The former intranett.no software stack
Python JavaScript Shell
Pull request Compare This branch is 3 commits ahead of intranett:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cfgs
etc
munin
nginx-sites/errors
src
templates
tools
var
.gitignore
CHANGES.txt
Makefile
README.rst
alltests.py
bootstrap.py
development.cfg
production.cfg

README.rst

Documentation

Prerequisites

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

pcre pkgconfig rb19-haml erlang

Install

Follow the typical buildout steps:

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

Site creation

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.

Tests

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

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

I18N

To update the translation files, do:

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

Upgrades

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.

Email

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.