ABOUT
=====
This is the DAV Events django project.


REQUIREMENTS
============
- Python 2.7
- Django
- Several additional django related python packages

For production use you surly want a real web server that supports WSGI
(e.g. Apache httpd with mod_wsgi) and a real Database like PostgreSQL.


INSTALLATION
============

1. Python Environment
---------------------
   It is strongly recommended to create a separated python environment
   for your django project. But it is not exactly necessary.

   The creation of a separated python environment is very easy with the
   virtualenv tool (a python package).

   If you decide to not use virtualenv, proceed with step 2.

   - Create the python environment in a directory called ./env/python:

     ``virtualenv --prompt="(dav)" ./env/python``

   - If you use a posix compatible shell (like bash, the linux default shell),
     you have to enter the environment with the following command:

     ``source ./env/python/bin/activate``

   Your shell prompt should show the prefix '(dav)' now.

   Do not leave the environment (nor exit the shell) until the whole
   installation is done.
   After that you can call the command ``deactivate`` to leave.

   If you have left the environment and want to reenter it (e.g. to execute
   a python command) use the previous ``source ...`` command.

2. Install files
----------------

    * ``python setup.py develop``
    * ``django-dav-events-admin setup ./env/django``

   The django project directory ('./env/django' within the previous example)
   will be called project root for now on.

3. Create the database schema / Populate the database
-----------------------------------------------------
   Change into the *project root* (where the file ``manage.py`` lives)
   and run

   * ``python manage.py makemigrations``
   * ``python manage.py migrate``

4. Start test server
--------------------
   While you still are in the *project root* directory, run

   ``python manage.py runserver``

   Now you should be able to connect to the test server via

   http://localhost:8000


LICENCE
=======
Permission to use, copy, modify, and/or distribute this software
for any purpose with or without fee is hereby granted.