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
Comment on This Data Unit