If your current operating system is Windows it is recommend to either get a Linux-like environment (e.g. extend the console with Cywing) or better get Wubi (Windows Ubuntu Installer) as a dual boot system. The latter one is very straightforward.
In order to set up a local development version of Denigma on Windows do the following steps:
Install your Developer version of Denigma
First we get GIT, the cat [http://msysgit.github.com/]. For instance from here [http://denigma.de/url/3q]. The installation will ask to choose:
a) use Git Bash only
b) run Git from windows command prompt
c) run Git and included Unix tools from windows command prompt
Select c).
Then open the command prompt, navigate to a folder where the Project shall live and run the following command:
git clone https://github.com/hevok/denigma
Preparing Denigma Programming Environment
Install Python at first if you haven not yet [http://www.python.org/]. We are going with latest version of Python 2 (i.e. 2.7.3), as Python 3 is not yet well established. Many libraries are still in stage 2. So with Python 3 you would have a much smaller application ecosystem.
If you are on a 64bit machine install the following executable [http://www.python.org/ftp/python/2.7.3/python-2.7.3.amd64.msi] under preferentially C:\Python27\
.
ii) Set Environment Variables:
Next step is to set the environment variables. For this follow: Start
> Control Panel
> Double click on System Icon
System Properties. There under system variables edit PATH
and include in the front the following string: C:\Python27\;C:\Python27\Scripts\
.
iii) Install PyCharm:
Then install a Interactive Development Environment for Python and Django [http://www.denigma.de/tutorials/77/view/].
Configuring Virtual Environment:
Download the latest easy Installer for Windows that fits the installed Python version (e.g. the exe at the bottom of [http://pypi.python.org/pypi/setuptools]) and install it.
If you are on a 64bit machine consider to download ez_setup.py
, copy it to C:\Python27
, navigate into this folder in the DOS prompt and install it by running python ez_setup.py
[http://peak.telecommunity.com/dist/ez_setup.py].
Open a new DOS prompt and run easy_install pip
as well as pip install virtualenv
.
Finally, navigate to the Denigma Project folder and create a virtual environment:
virtualenv env --system-site packages
OR
python virtualenv.py env --system-site packages # only if virtualenv installation failed
C:\dev\denigma\env\Scripts\activate
Starting Denigma:
Now its time to prepare Denigma for running. First install some prerequisites:
Then install all the other required libraries:
pip install -r denigma/requirements/project.txt
python manage.py syncdb --all
python manage.py migrate --fake
python manage.py runserver
Open localhost:8000
in the browser and it is accomplished.
Modify Denigma:
i) modify locally
git add modified_file
git commit -m "Describe the change here"
ii) upload you modification to the online Denigma
git push
Keep Denigma updated
Regularly pull any Changes in Denigma source code:
git pull
If you are on Mac OX this is fine as it is UNIX-based system also the instructions will be majorly for Linux. o
Linux is the most preferred system in which Denigma and the interaction with it can run. Denigma itself is currently in an Ubuntu environment implemented.
In order to set up Denigma locally just do the following (Ubuntu or at least a UNIX environment is recommended):
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
Fork Denigma:
$ git clone https://github.com/hevok/denigma
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
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
Start Denigma:
$ ./manage.py syncdb --all $ ./manage.py migrate --fake $ ./manage.py runserver
Change Denigma:
$ git commit -am "Brief description of the change." $ git push origin master
Keep Denigma Updated:
$ git checkout master # Update to the latest version. $ git pull # Pull it from master.