First you have to clone this repository and all its submodules:

git clone git@github.com:EuroPython/djep.git
cd djep

Next create a virtualenv and install all the requirments into it. In this example we are using virtualenvwrapper to manage the virtualenv:

mkvirtualenv djep

This repository provides requirements and configurations for various environments. Each environment (dev, staging and production) has its own requirements.txt.

For local development, install the requirements specified in requirements/dev.txt:

pip install -r requirements/dev.txt

Now that this is complete, you can optionally change some settings. To get an overview of what settings are available, take a look at the pyconde.settings module.

We are using django-configurations to manage all settings and try to expose all relevant settings as environment variables. By default you will probably want to set following variables:

export DJANGO_CONFIGURATION=Dev

If you want to use a different database system than PostgreSQL and a different database than "djep", set the DJANGO_DATABASE_URL environment variable. You can find some examples in the dj-database-url test module.

Another environment variable you absolutely have to set is DJANGO_SECRET_KEY:

export DJANGO_SECRET_KEY=...

Not that this value should be constant for your local installation.

Everything should be in place now to initialize the database. If you want to use SQLite be warned that there are some issues with the migration steps done for some of django-cms' plugins. Therefor you will most likely have to run this:

python manage.py syncdb --noinput --all
python manage.py migrate --fake

If you want to use PostgreSQL (which is also used in production for this site), alter the DATABASES section of your pyconde/settings.py accordingly and then run following command:

python manage.py syncdb --noinput --migrate

After this is done, you should already have a working site, but it is still empty. To change that we have to create an admin user in order to gain access to the admin panel:

python manage.py createsuperuser

This will prompt a couple of questions you have to fill out. After this is complete, start the development-server on port 8000 with:

python manage.py runserver

As a final step you have to create a frontpage in the via http://localhost:8000/admin/cms/page/add/.

Right now this project doesn't come with compiled css files but relies on Grunt and Compass to generate them. Once you have Compass installed, run following command to install all the other requirements:

npm install
cd pyconde/skins/ep14/static/assets && ../../../../../node_modules/bower/bin/bower install

During development you will probably need a dummy mail server and other services that are usually run system-wide in production. To help you keep all these services under control the project provides a sample Procfile which you can use with foreman:

foreman start

live: fab -c live.ini upgrade staging: fab -c staging.ini upgrade

Add a CMS page with the ID accounts and attach the Accounts Menu. Make sure to not display the page in the menu!

Parts of this project are based on work by the Symposion/Pinax team. Apps originating in Symposion are:

• conference
• sponsorship

This repository also contains various icons created by Paul Robert Lloyd. Every site using this component must either indicate this in the footer or in the imprint.