Bornhack

Django project to power Bornhack. Features include news, villages, webshop, and more.

Quickstart

Clone with --recursive to include submodules:

git clone --recursive https://github.com/bornhack/bornhack-website

Create a Python 3 virtual environment and activate it:

$ virtualenv venv
$ source venv/bin/activate

Install system dependencies (method depends on OS):

postgresql headers (for psycopg2):
- Debian: libpq-dev
- FreeBSD: databases/postgresql93-client
libjpeg (for pdf generation)
- Debian: libjpeg-dev
- FreeBSD: graphics/jpeg-turbo
wkhtmltopdf (also for pdf generation):
- Debian: wkhtmltopdf
- FreeBSD: converters/wkhtmltopdf
fonts
- Debian: ?
- FreeBSD: x11-fonts/webfonts

Install pip packages:

    (venv) $ pip install -r src/requirements.txt

Copy environment settings file and change settings as needed:

    (venv) $ cp src/bornhack/environment_settings.py.dist src/bornhack/environment_settings.py

Edit the configuration file, replacing all the {{ placeholder }} patterns (intended for Ansible).

Is this a new installation? Initialize the database:

    (venv) $ src/manage.py migrate

Is this for local development? Bootstrap the database with dummy data and users:

    (venv) $ src/manage.py bootstrap-devsite

Is this for local development? Start the Django devserver:

    (venv) $ src/manage.py runserver

Otherwise start uwsgi or similar to serve the application.

Enjoy!

Add a new camp in the admin interface and run

    (venv) $ src/manage.py createcamp {camp-slug}

or go through the manuel process below:

Add a new camp in the admin interface.
Add a sponsers page, {camp-slug}_sponsors.html, to sponsors/templates.
Add a frontpage, {camp-slug}_camp_detail.html, to camps/templates.
Add a call for speakers page, {camp-slug}_call_for_speakers.html, to program/templates.
Create static_src/img/{camp-slug}/logo and add two logos:
- {camp-slug}-logo-large.png
- {camp-slug}-logo-small.png