Django 1.9.x installation workshop
==================================

Development environment
-----------------------

- python + virtualenv
- django
- postgresql
- jupyter
- git 
- nginx
- uwsgi
- foundation
- node + npm 
    - gulp
    - bower

.. image:: _static/images/development-environment.png

Create virtualenv
-----------------

Set up project with virtualenvwrapper.

Install `virtualenvwrapper`_ on linux/mac.  

Install `virtualenvwrapper-win`_ on windows (not tested). 

.. _virtualenvwrapper: https://virtualenvwrapper.readthedocs.io/en/latest/ 
.. _virtualenvwrapper-win: https://github.com/davidmarble/virtualenvwrapper-win/

Run::

    mkvirtualenv --python=/usr/local/bin/python3 pcs-django

Ro access your virtualenv, run::

    workon pcs-django

Add the path to your project in the ".project" file.
now you can run commands like::

    cdvirtualenv
    cdproject
    cdsitepackages 


Install **django** in virtualenv with pip::

    pip install django
    
Some optional apps which are quite useful are:

- jupyter (ipython successor with notebook support)
- django-extensions

To install run::

    pip install jupyter
    pip install django-extensions


.. _django-setup:

Set up a django project
-----------------------

Run::

    django-admin startproject someproj
    cd someproj
    ./manage.py migrate
    ./manage.py createsuperuser
    ./manage.py runserver

This will create a new project named "someproj" in the directory you are now located.

It is advisable to use the following in your projects

- `git`_
- `requirements`_

.. _git: https://git-scm.com/
.. _requirements: https://pip.readthedocs.io/en/1.1/requirements.html

Static files setup
******************

To serve "static" files add the following to the "settings.py" config file::

    STATIC_ROOT = os.path.join(BASE_DIR, 'static')

**Optional:**  
You can also add a 'media' folder to hold your uploaded images and files::

    MEDIA_URL = '/media/'
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')


Collect the static files needed to run the app::

    ./manage.py collectstatic

Restart the server::

    ./manage.py runserver


In a browser, visit::

    http://localhost:8000/admin

and login with the username and password you created with the *createsuperuser*
command at project creation above. See :ref:`django-setup`.