~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

              _                            XXXX
             | |           o              X o  XXXX 
             | |  ,_    _      _         X    _|_  XXX
             |/  /  |  |/  |  |/        X   |  |    X
             |__/   |_/|__/|_/|__/  o  XXX  |_/|_/ X
             |\                           XXXX    X
             |/                               XXXX

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

dependencies:
* python 2.7
* fabric
* virtualenv
* django-taggit 0.9.3 (will be distributed within our software)
* see requirements.txt
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

development quick guide:

* initialize venv (install pil & pysqlite3 by hand) and database
  default username: admin
  default password: admin

  $ fab make_venv
  $ fab install_req
  $ fab syncdb

* without fab

  $ virtualenv env
  $ pip install -U -r requirements.txt
  $ python manage.py syncdb
  $ python manage.py migrate freieit


* runs the development server (http://localhost:8000)

  $ fab runserver

* without fab

  $ source env/bin/activate
  $ python manage.py runserver


* delete local database file and all locally uploaded media

  $ fab clean