capitalise Django, tweak INSTALLED_APPS listing, other minor changes.

by: Harry

Author: hjwp

content/django.txt

@@ -1,15 +1,16 @@
 =================================================================================
-Creating a new django project on Python Anywhere
+Creating a new Django project on Python Anywhere
 =================================================================================
 
 So you want to create a web application but you don't really want to do all the 
 faffing around that is involved in setting up and configuring web servers?
 
 Well that is one of the reasons we created Python Anywhere. This tutorial will
-take you through the process of creating a working django site with an admin 
+take you through the process of creating a working Django site with an admin 
 interface and a front page that tells you the time.  
 
-To follow along with this tutorial you will need a `Python Anywhere <http://www.pythonanywhere.com/>`_
+To follow along with this tutorial you will need a 
+`Python Anywhere <http://www.pythonanywhere.com/>`_
 account. Go and sign up if you don't already have one then come back here. 
 
 .. contents:: Table of Contents 
@@ -19,13 +20,12 @@ account. Go and sign up if you don't already have one then come back here.
 
 
 
-
 The really quick start guide
 =================================================================================
 
 To start with, for those people who are already very confident with Django we will
 just start with a list of the steps and commands you need to run in order to get 
-a working django app on PythonAnywhere. Don't worry if you don't understand these
+a working Django app on PythonAnywhere. Don't worry if you don't understand these
 now. We will go through each one, step by step, further down. 
 
 So, the really quick start guide:
@@ -56,7 +56,7 @@ so that it matches the value you entered above.
     import os
     import sys
 
-    ## assuming your django settings file is at '/home/<my name>/<my project name>/settings.py'
+    ## assuming your Django settings file is at '/home/<my name>/<my project name>/settings.py'
     path = '/home/<my name>/'
     if path not in sys.path:
         sys.path.append(path)
@@ -66,7 +66,7 @@ so that it matches the value you entered above.
     import django.core.handlers.wsgi
     application = django.core.handlers.wsgi.WSGIHandler()
 
-You should now have a default django app which you can visit at <my name>.pythonanywhere.com
+You should now have a default Django app which you can visit at <my name>.pythonanywhere.com
 
 Edit settings.py
 ---------------------------------------------------------------------------------
@@ -79,15 +79,16 @@ database and installed apps sections to match the code below.
     DATABASES = {
         'default': {
             'ENGINE': 'django.db.backends.sqlite3',
-            'NAME': '/home/%s/my_test_project/db.sqlite',
+            'NAME': '/home/<my name>/my_test_project/db.sqlite', # absolute location is required
             'USER': '',
             'PASSWORD': '',
             'HOST': '',
             'PORT': ''
         }
     }
 
-    INSTALLED_APPS += (
+    INSTALLED_APPS = (
+        #[...]
         'django.contrib.admin',
         'my_test_project.my_app',
     )
@@ -96,7 +97,7 @@ database and installed apps sections to match the code below.
 Create empty database and edit urls.py
 ---------------------------------------------------------------------------------
 
-Now it is back to your bash console to perform the initial database creation
+Now it's back to your bash console to perform the initial database creation
 
 ::
 
@@ -209,10 +210,10 @@ and see the actual error message that your code is generating.
 
 The WSGI file here is how you tell Python Anywhere what application you actually
 want to run. Any WSGI web framework can be used but in this tutorial we will only
-be focusing on django. 
+be focusing on Django. 
 
 
-Starting a new django project
+Starting a new Django project
 ---------------------------------------------------------------------------------
 
 Django is already installed on Python Anywhere so you it is easy to get started. 
@@ -270,7 +271,7 @@ project name that you chose in the previous step.
     import os
     import sys
 
-    ## assuming your django settings file is at '/home/<my name>/<my project name>/settings.py'
+    ## assuming your Django settings file is at '/home/<my name>/<my project name>/settings.py'
     path = '/home/<my name>/'
     if path not in sys.path:
         sys.path.append(path)
@@ -281,14 +282,14 @@ project name that you chose in the previous step.
     application = django.core.handlers.wsgi.WSGIHandler()
 
 
-At this point you have a very basic default django app running. You should visit
+At this point you have a very basic default Django app running. You should visit
 it to make sure that this is the case. Every Python Anywhere user has a default 
 place to visit their web app. It is <my username>.pythonanywhere.com. This 
-tutorial is in fact being delivered to you by a django app run by the user 
+tutorial is in fact being delivered to you by a Django app run by the user 
 "tutorial". If your username was harry you would access your app at 
 http://harry.pythonanywhere.com. You can find a link to your own address at the 
 Web tab in the dashboard. Try going their now and checking that you can see the 
-default welcome message from django then come back here to continue. 
+default welcome message from Django then come back here to continue. 
 
 
 Configuring the database and enabling the admin interface
@@ -298,8 +299,8 @@ Django needs a database connection to do pretty much anything. Python Anywhere
 provides support for MySQL databases but for now we will just use sqlite3. A file
 based database that does not require setting up a database account and password.
 
-The file that contains all the settings information for django is called, 
-naturally enough, settings.py. By default it lives in your django project 
+The file that contains all the settings information for Django is called, 
+naturally enough, settings.py. By default it lives in your Django project 
 directory. You will need to open this file up and change the DATABASE and 
 INSTALLED_APPS sections of it so that it looks like the code below. Do not change 
 any other bits of it at this time. 
@@ -322,7 +323,7 @@ any other bits of it at this time.
         '<my project name>.<my app name>',
     )
 
-Now that you have told django what database to use you have to run a management 
+Now that you have told Django what database to use you have to run a management 
 command in order for it to create the initial tables and the first admin user. 
 In order to do this you go back to a bash shell and enter the following commands
 
@@ -333,15 +334,15 @@ In order to do this you go back to a bash shell and enter the following commands
 
 You will be asked a series of questions. You should enter a username, email 
 address, and password for the first admin user. You will need this information 
-to log in to django's admin interface so make sure that you remember the details 
+to log in to Django's admin interface so make sure that you remember the details 
 somehow.
 
 
 Defining your urls
 ---------------------------------------------------------------------------------
 
 The next step is defining the urls for your application. This means you are
-starting to tell django what to do when a user visits a certain location in your 
+starting to tell Django what to do when a user visits a certain location in your 
 web site. The file to edit is called urls.py and it should be in the same
 directory as your settings.py file. Open it up and make it look like the file
 below. Remember, as always, that each time you see a phrase inside angle 
@@ -373,7 +374,7 @@ chosen.
 
 In this file you are defining two url patterns. The first one matches a blank 
 string which is what happens when a user visits the <your username>.pythonanywhere.com. 
-The second one matches "admin/" which is djangos default admin interface. This
+The second one matches "admin/" which is Djangos default admin interface. This
 should now be working. If you like you can take a look at it now, logging in with
 the username and password that you provided earlier. When you are done come back 
 here to continue. You may need to press the "Reload web app" button on your on 
@@ -422,7 +423,7 @@ we complete our final task. Which is writing a view.
 Writing the first view
 ---------------------------------------------------------------------------------
 
-Views are django functions which take a request and return a response. We are
+Views are Django functions which take a request and return a response. We are
 going to write a very simple view called home which uses the "home.html" template
 and uses the datetime module to tell us what the time is whenever the page is
 refreshed. The file we need to edit is called views.py and it will be inside 
@@ -446,7 +447,7 @@ web server. Go and do that now.
 If you have followed along with this tutorial you should now have a working,
 dynamic page at <your username>.pythonanywhere.com. You can continue to 
 experiment with this by changing the view and the template as well as read 
-through the full django documentation https://docs.djangoproject.com to see what 
+through the full Django documentation https://docs.djangoproject.com to see what 
 else is possible.