This repo holds the source code for webcampzg.org.

• build essentials (gcc and friends)
• git
• python3 + python3-dev
• fabric
• virtualenv
• virtualenvwrapper
• postgresql 9.6+
• libjpeg, libtiff (for Pillow)

On Debian or Ubuntu:

Install packages:

sudo apt install build-essential git python3 python3-dev fabric virtualenv virtualenvwrapper postgresql libjpeg-dev libtiff5-dev sassc

git@github.com:WebCampZg/conference-web.git
cd conference-web

Presuming you have a working postgresql database set up, and that your SSL key is in .ssh/authorized_keys on production server.

If you don't have a database user (replace <user> with your username):

sudo -u postgres createuser --superuser --password <user>

The refresh_db fabric command will drop the local database webcamp if it exists and import the production data:

fab refresh_db

See fabfile.py for details.

Create a new virtual env for the project:

mkvirtualenv --python=`which python3` conference-web

If you already have a virtualenv then just activate it:

workon conference-web

Install dependencies into the virutal env:

pip install -r requirements/dev.txt

Create a local settings file project/settings/local.py with the following minimal configuration:

from .base import *
import dj_database_url

DATABASES = {'default': dj_database_url.config(
    default='postgres://<user>:<pass>@localhost:5432/webcamp'
)}

Add a random SECRET_KEY to the configuration file. Here's a oneliner:

python -c "import random,string;print('\nSECRET_KEY=\"{}\"\n'.format(''.join([random.SystemRandom().choice(string.ascii_letters) for i in range(63)])))" >> project/settings/local.py

You can now run the Django server:

./manage.py runserver

If you wish, copy the media files (e.g. user images and uploads) from the server:

make sync-media

CSS is built from source SCSS files in ui/styles using sassc, and stored in ui/dist/styles. The generated CSS should be committed to the repo.

Download Zurb Foundation and IBM Plex which are used for building css. This only needs to be done once, they will be stored in the sources dir.

make sources

Now you can compile the styles:

make css

To watch for changes and automatically rebuild css:

make css-watch

To deploy the changes, first commit, merge and push your changes to master branch, then run:

fab deploy

Requires your SSH key on the server.