Denigma is the digital Engima destined to decipher life. This repository is planting its seed.

In order to set up Denigma locally just do the following (Ubuntu or at least a UNIX environment is recommended):

1. Git in:

   Go to the GIT bootcamp (sign up if you haven't already): https://github.com/

   In brief on UNIX:

   $ sudo su # Get full control about your machine. 
   $ apt-get install git # Get (g)it!

   Configure Git with your name and e-mail:

   $ git config --global user.name "FULL NAME"
   $ git config --global user.email email@address.com

2. Fork Denigma:

   $ git clone https://github.com/denigma/denigma

3. Get the Might to Create Virtual Environments:

   $ curl http://python-distribute.org/distribute_setup.py | python
   $ easy_install virtualenv
   $ cd denigma
   $ virtualenv env
   $ . env/bin/activate

When you do this env folder will be created with separate python interpreter and libraries. It eases future deployment and protects you from messing current python installation with extra libraries. Next steps you should under active enviroment (you will see (env) before your useraccount in console).

4. Prepare Environment:

   $ apt-get update
   $ apt-get install python-dev libmysqlclient-dev     # Latter is an optional database-backend
   $ apt-get install -y subversion
   $ pip install -r denigma/requirements/pre.txt       # Prerequisite
   $ pip install -r denigma/requirements/project.txt

5. Start Denigma:

   $ ./manage.py syncdb --all
   $ ./manage.py migrate --fake
   $ ./manage.py runserver

While installation you may see some warning (i.e. scipy not installed) and multiple Exception TypeError: "'NoneType' object is not callable" in ignored Do not pay attention to them. Not all acticles are present in developer's database so when running Denigma you may encounter some meta errors as well as 404 at some places, they are not bugs but only missing articles

6. Change Denigma:

   $ git commit -am "Brief description of the change."
   $ git push origin master

7. Keep Denigma Updated:

   $ git checkout master # Update to the latest version.
   $ git pull # Pull it from master.