Chapter about installing Django and how to start Django project.

Author: asendecka

SUMMARY.md

@@ -5,5 +5,6 @@
 * [Introduction to Python](try_python/README.md)
 * [What is Django?](django_-_why_you_need_a_webframework/README.md)
 * [Django installation](django_installation/README.md)
+* [Starting Django project](starting_django_project/README.md)
 * [Next chapters](next_chapters/README.md)
 

django_installation/README.md

@@ -8,23 +8,54 @@ Before we will install Django, we will make you install something very handy and
 
 That's why we want you to create a Virtual environment (also called `virtualenv`). It will isolate things you do from your computer, so you will have everything important in one place. Neat, right?
 
-All you need to do is find a folder in which you want to create the `virtualenv`, for example your home directory. In Windows it could look like: `C:\Users\Ala\` (where Ala is the name of the user).
+All you need to do is find a folder in which you want to create the `virtualenv`, for example your home directory. In Windows it could look like: `C:\Users\Name\` (where `Name` is a name of the user).
 
 ### Windows
 
 To create `virtualenv` you need to open command line `cmd` and type there `C:\Python\python -m venv blog`. It will look like this:
 
-    C:\Users\Ala> C:\Python34\python -m venv blog
+    C:\Users\Name> C:\Python34\python -m venv blog
 
 where `C:\Python34\python` is folder in which you previously installed Python and `blog` is a name of your `virtualenv`. You can use any other name, but stick to lowercase and use no spaces. It is also good idea to keep the name short :).
 
-### Linux
+### Linux and OS X
 
-### OS X
+Creating `virtualenv` in both Linux and OS X is as simple as typing in console (remember, that we expect that you have python 3.4 installed):
 
+    ~$ python -m venv blog
 
+### Working with virtualenv
 
+The command above will create a folder `blog` that contains our virtual environment (basically bunch of folders and files). All we want to do now is starting it by:
 
+    C:\Users\Name> blog\Scripts\activate
 
+for Windows users, or:
+
+    ~$ source blog/bin/activate
+
+You will know that you have `virtualenv` started when you see that the prompt in your command line or console looks like:
+
+    (blog) C:\Users\Name>
+
+or:
+
+    (blog) ~$
+
+so the prefix `(blog)` appears!
+
+Ok, we have all important things in place. We can finally install Django!
+
+## Installing Django
+
+Now, when you have your `virtualenv` started, you can install Django using PIP. In console/command-line you type `pip install django==1.6.4`.
+
+    (blog) ~$ pip install django==1.6.4
+    Downloading/unpacking django==1.6.4
+    Installing collected packages: django
+    Successfully installed django
+    Cleaning up...
+
+That's it! Now you are finally ready to create a Django application.
 
 

install_python/README.md

@@ -10,7 +10,7 @@ Python was conceived in the late 1980s and it's main goal is to be readable by h
 
 *This subchapter is based on awesome tutorials by Geek Girls Carrots (http://django.carrots.pl/)*
 
-Django is written in Python. We need it to do anything in Django. Let's start with installing it!
+Django is written in Python. We need it to do anything in Django. Let's start with installing it! We want you to install Python 3.4, so if you have any earlier version, you will need to upgrade it.
 
 ### Windows
 

starting_django_project/README.md

@@ -0,0 +1,84 @@
+# Starting Django project
+
+*This chapter is based on awesome tutorials by Geek Girls Carrots (http://django.carrots.pl/) and django-marcador (http://django-marcador.keimlink.de/).*
+
+Let's build a simple blog!
+
+The first step to create it is starting a new Django project. Basically that means that we will run some script from Django that will create for us a skeleton of Django project: bunch of directories and files that we will later use.
+
+Names of some files and directories are very important for Django. You should not rename files that we are about to create. Moving them to different place is also not a good idea. Django needs a certain folder/files structure to be able to find important things.
+
+In console/command-line you should type:
+
+    (blog) ~$ django-admin.py startproject mysite
+
+`django-admin.py` is a script that will create folders and files for you. It should look like this:
+
+    mysite
+    │   manage.py
+    │
+    └───mysite
+            settings.py
+            urls.py
+            wsgi.py
+            __init__.py
+
+
+`manage.py` is a script that helps with administration of the page. Thanks to it we will be able to start a web server on our computer without installing anything else.
+
+File `settings.py` contains a configuration of your website.
+
+Remember when we talked about a postman checking where to deliver a letter? `urls.py` file contains a list of patterns used by `urlresolver`.
+
+Let's ignore for now other files - we will not change them, so we will skip expalining what they actually do. The only thing to remember is to not delete them by accident!
+
+## Changing settings
+
+Let's do some changes in `settings.py`.
+
+It would be nice to have a correct time on our website. You should find lines that contain `USE_TZ` and `TIME_ZONE` and change them to look like this:
+
+    USE_TZ = False
+    TIME_ZONE = 'Europe/Berlin'
+
+## Creating a database
+
+Most of web application have their own database. Database is a collection of data. This is a place in which you will store all information about users, all your blog post texts, etc..
+
+There is number of different database systems that store data for you. We will use one of the simpliest: `sqlite3`, which was installed with Django. But if you plan to do some serious websites in a future we recommends looking at `PostgreSQL`.
+
+To create a database for our blog we will type in console/command-line `python manage.py syncdb`. It should look like this:
+
+    (blog) ~/carrots$ python manage.py syncdb
+    Creating tables ...
+    Creating table auth_permission
+    Creating table auth_group_permissions
+    Creating table auth_group
+    Creating table auth_user_groups
+    Creating table auth_user_user_permissions
+    Creating table auth_user
+    Creating table django_content_type
+    Creating table django_session
+    Creating table django_site
+    Creating table django_admin_log
+
+    You just installed Django's auth system, which means you don't have any superusers defined.
+    Would you like to create one now? (yes/no): yes
+    Username (leave blank to use 'Name'):
+    Email address: admin@example.com
+    Password:
+    Password (again):
+    Superuser created successfully.
+    Installing custom SQL ...
+    Installing indexes ...
+    Installed 0 object(s) from 0 fixture(s)
+
+It will ask you if you want to create a superuser. Type `yes`, press Enter and type your username (lowercase, no spaces), email address and password when you will be asked to type it.
+
+And you are done. Time to start web server and see if our website is working!
+
+You need to be in a folder that contains `manage.py` file (in `mysite` directory). In console/command-line we will start the web server by typing `python manage.py runserver`:
+
+    (blog) ~/mysite python manage.py runserver
+
+