Djangogirls Tutorial

Table of Contents
1. Introduction
2. How the Internet works?
3. Introduction to command line
4. Python installation
5. Introduction to Python
6. What is Django?
7. Django installation
8. Code editor
9. Starting Django project
10. Django models
11. Django ORM (Querysets)
12. Django admin
13. Deploy!
14. Django urls
15. Django views - time to create!
16. Introduction to HTML
17. Dynamic data in templates
18. Django templates
19. CSS - make it pretty
20. Template extending
21. Extend your application
22. Django Forms
23. Domain
24. What's next?
Django Girls Tutorial

GITTER
JOIN CHAT
This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a
copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/
Introduction
Have you ever felt that the world is more and more about technology and you are somehow left behind? Have you ever
wondered how to create a website but have never had enough motivation to start? Have you ever thought that the
software world is too complicated for you to even try doing something on your own?
Well, we have good news for you! Programming is not as hard as it seems and we want to show you how fun it can be.
The tutorial will not magically turn you into a programmer. If you want to be good at it, you need months or even years of
learning and practice. But we want to show you that programming or creating websites is not as complicated as it seems.
We will try to explain different bits and pieces as well as we can, so you will not feel intimidated by technology.
We hope that we'll be able to make you love technology as much as we do!
What will you learn during the tutorial?

Once you've finished the tutorial, you will have a simple, working web application: your own blog. We will show you how
to put it online, so others will see your work!
It will (more or less) look like this:
If you work with the tutorial on your own and don't have a coach that will help you in case of any problem, we have
a chat for you:
GITTER
JOIN CHAT . We asked our coaches and previous attendees to be there from time to
time and help others with the tutorial! Don't be afraid to ask your question there!
OK, let's start at the beginning...
About and contributing

This tutorial is maintained by DjangoGirls. If you find any mistakes or want to update the tutorial please follow the
contributing guidelines.
How the Internet works

This chapter is inspired by a talk "How the Internet works" by Jessica McKellar (http://web.mit.edu/jesstess/www/).
We bet you use the Internet every day. But do you actually know what happens when you type an address like
http://djangogirls.org into your browser and press 'Enter'?
The first thing you need to understand is that a website is just a bunch of files saved on a hard disk. Just like your movies,
music or pictures. However, there is one part that is unique for websites: they include computer code called HTML.
If you're not familiar with programming, it can be hard to grasp HTML at first, but your web browsers (like Chrome, Safari,
Firefox, etc.) love it. Web browsers are designed to understand this code, follow its instructions and present all these files
that your website is made of exactly the way you want them to be presented.
As with every file, we need to store HTML files somewhere on a hard disk. For the Internet, we use special, powerful
computers called servers. They don't have a screen, mouse or a keyboard, because their main purpose is to store data
and serve it. That's why they're called servers -- because they serve you data.
OK, but you want to know how the Internet looks like, right?
We drew you a picture! It looks like this:
Looks like a mess, right? In fact it is a network of connected machines (the above mentioned servers). Hundreds of
thousands of machines! Many, many kilometers of cables around the world! You can visit a Submarine Cable Map
website (http://submarinecablemap.com/) to see how complicated the net is. Here is a screenshot from the website:
It is fascinating, isn't it? But obviously, it is not possible to have a wire between every machine connected to the Internet.
So, to reach a machine (for example the one where http://djangogirls.org is saved) we need to pass a request through
many, many different machines.
It looks like this:
Imagine that when you type http://djangogirls.org, you send a letter that says: "Dear Django Girls, I want to see the
djangogirls.org website. Send it to me, please!"
Your letter goes to the post office closest to you. Then it goes to another that is a bit nearer to your addressee, then to
another and another till it is delivered at its destination. The only unique thing is that if you send letters (data packets)
frequently to the same place, each letter might go through totally different post offices (routers), depending on how they
are distributed in each office.
Yes, it is as simple as that. You send messages and you expect some response. Of course, instead of paper and pen you
use bytes of data, but the idea is the same!
Instead of addresses with a street name, city, zip code and country name, we use IP addresses. Your computer first asks
the DNS (Domain Name System) to translate djangogirls.org into an IP address. It works a little bit like old-fashioned
phonebooks where you could look for the name of the person you want to contact and find their phone number and
address.
When you send a letter, it needs to have certain features to be delivered correctly: an address, stamp etc. You also use a
language that the receiver understands, right? The same is with data packets you send in order to see a website: you use
a protocol called HTTP (Hypertext Transfer Protocol).
So, basically, when you have a website you need to have a server (machine) where it lives. The server is waiting for any
incoming requests (letters that ask the server to send your website) and it sends back your website (in another letter).
Since this is a Django tutorial, you will ask what Django does. When you send a response, you don't always want to send
the same thing to everybody. It is so much better if your letters are personalized, especially for the person that has just
written to you, right? Django helps you with creating these personalized, interesting letters :).
Enough talk, time to create!
Introduction to the command-line interface

Huh, it's exciting, right?! You'll write your first line of code in just a few minutes :)
Let us introduce you to your first new friend: the command line!
The following steps will show you how to use the black window all hackers use. It might look a bit scary at first but really
it's just a prompt waiting for commands from you.
What is the command line?

The window, which is usually called the command line or command-line interface, is a text-based application for
viewing, handling and manipulating files on your computer (much like e.g. Windows Explorer or Finder on Mac, but
without the graphical interface). Other names for the command line are: cmd, CLI, prompt, console or terminal.
Open the command-line interface

To start some experiments we need to open our command-line interface first.
Windows
Go to Start menu All Programs Accessories Command Prompt.
Mac OS X
Applications Utilities Terminal.
Linux
It's probably under Applications Accessories Terminal, but that may depend on your version system. If it's not there,
just Google it :)
Prompt
You now should see a white or black window that is waiting for your commands.
If you're on Mac or Linux, you probably see
, just like this:
On Windows, it's a
>
sign, like this:
>
Each command will be prepended by this sign and one space, but you don't have to type it. Your computer will do it for
you :)
Just a small note: in your case there maybe something like
C:\Users\ola>
or
Olas-MacBook-Air:~ ola$
prompt sign and that's 100% correct. In this tutorial we will just simplify it to the bare minimum.
Your first command (YAY!)
before the
Let's start with something simple. Type this command:
$ whoami
or
> whoami
And then hit Enter. This is our result:
$ whoami
olasitarska
As you can see, the computer just presented you your username. Neat, huh?:)
Try to type each command, do not copy paste. You'll remember more this way!
Basics
Each operating system has a slightly different set of commands for the command line, so make sure to follow instructions
for your operating system. Let's try this, shall we?
Current directory
It'd be nice to know where are we now, right? Let's see. Type this command and hit enter:
$ pwd
/Users/olasitarska
If you're on Windows:
> cd
C:\Users\olasitarska
You'll probably see something similiar on your machine. Once you open the command line you usually start at your user's
home directory.
Note: 'pwd' stands for 'print working directory'.
List files and directories

So what's in it? It'd be cool to find out. Let's see:
$ ls
Applications
Desktop
Downloads
Music
...
Windows:
> dir
Directory of C:\Users\olasitarska
05/08/2014 07:28 PM <DIR>
Applications
05/08/2014 07:28 PM <DIR>
Desktop
05/08/2014 07:28 PM <DIR>
Downloads
05/08/2014 07:28 PM <DIR>
Music
...
Change current directory

Maybe we can now go to our Desktop directory?
$ cd Desktop
Windows:
> cd Desktop
Check if it's really changed:
$ pwd
/Users/olasitarska/Desktop
Windows:
> cd
C:\Users\olasitarska\Desktop
Here it is!
PRO tip: if you type
cd D
and then hit
tab
on your keyboard, the command line will automatically autofill the rest of
the name so you can navigate faster. If there is more than one folder starting with "D", hit the
tab
button twice to get
a list of options.
Create directory
How about creating a Django Girls directory on your desktop? You can do it this way:
$ mkdir djangogirls
Windows:
> mkdir djangogirls
This little command will create a folder with the name

looking on your Desktop or by running a
ls
djangogirls
on your desktop. You can check if it's there just by
/ dir command! Try it :)
PRO tip: If you don't want to type the same commands over and over, try pressing the
your keyboard to cycle through recently used commands.
up arrow
and
down arrow
on
Exercise!
Small challenge for you: in your newly created
djangogirls
directory create a directory called
test
. Use
cd
and
mkdir
commands.
Solution:
$ cd djangogirls
$ mkdir test
$ ls
test
Windows:
> cd djangogirls
> mkdir test
> dir
05/08/2014 07:28 PM <DIR>
test
Congrats! :)
Clean up
We don't want to leave a mess, so let's remove everything we did until that point.
First, we need to get back to Desktop:
$ cd ..
Windows:
> cd ..
Making
cd
to
..
will change your current directory to the parent directory (which means the directory that contains your
current directory).
Check where you are:
$ pwd
/Users/olasitarska/Desktop
Windows:
> cd
C:\Users\olasitarska\Desktop
Now time to delete the
djangogirls
Attention: Deleting files using
directory.
del
very careful with this command.
rmdir
or
rm
is irrecoverable, meaning deleted files will be gone forever! So, be
$ rm -r djangogirls
Windows:
> rmdir /S djangogirls

djangogirls, Are you sure <Y/N>? Y
Done! To be sure it's actually deleted, let's check it:
$ ls
Windows:
> dir
Exit
That's it for now! You can safely close the command line now. Let's do it the hacker way, all right?:)
$ exit
Windows:
> exit
Cool, huh?:)
Summary
Here is a summary of some useful commands:
Command
(Windows)
Command (Mac OS /
Linux)
Description
Example
exit
exit
close the window
exit
cd
cd
change directory
cd test
dir
ls
list directories/files
dir
copy
cp
copy file
copy c:\test\test.txt
c:\windows\test.txt
move
mv
move file
move c:\test\test.txt
c:\windows\test.txt
mkdir
mkdir
create a new
directory
mkdir testdirectory
del
rm
delete a
directory/file
del c:\test\test.txt
These are just a very few of the commands you can run in your command line but you're not going to use anything more
than that today.
If you're curious, ss64.com contains a complete reference of commands for all operating systems.
Ready?
Let's dive into Python!
Lets start with Python

We're finally here!
But first, let us tell you what Python is. Python is a very popular programming language that can be used for creating
websites, games, scientific software, graphics and much, much more.
Python originated in the late 1980s and its main goal is to be readable by human beings (not only machines!), which is
why it looks much simpler than other programming languages. This makes it easy to learn, but don't worry, Python is also
really powerful!
Python installation
This subchapter is based on tutorial by Geek Girls Carrots (http://django.carrots.pl/)
Django is written in Python. We need Python 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
You can download Python for Windows from the website https://www.python.org/downloads/release/python-342/. After
downloading the *.msi file, you should run it (double-click on it) and follow the instructions there. It is important to
remember the path (the directory) where you installed Python. It will be needed later!
Linux
It is very likely that you already have Python installed out of the box. To check if you have it installed (and which version it
is), open a console and type the following command:
$ python3 --version
Python 3.4.2
If you don't have Python installed or if you want a different version, you can install it as follows:
Ubuntu
Type this command into your console:
sudo apt-get install python3.4
Fedora
Use this command in your console:
sudo yum install python3.4
OS X
You need to go to the website https://www.python.org/downloads/release/python-342/ and download the Python installer:
download the Mac OS X 64-bit/32-bit installer DMG file,
double click to open it,
double click Python.mpkg to run the installer.

Verify the installation was successful by opening the Terminal application and running the
python3
command:
$ python3 --version
Python 3.4.2
If you have any doubts or if something went wrong and you have no idea what to do next - please ask your coach!
Sometimes things are not going smoothly and it's better to ask for help from someone with more experience.
Introduction to Python
Part of this chapter is based on tutorials by Geek Girls Carrots (http://django.carrots.pl/).
Let's write some code!
Python prompt
To start playing with Python, we need to open up a command line on your computer. You should have already knew how
to do that -- you have learned it in the Intro to Command Line chapter.
Once you're ready, follow the instructions below.
We want to open up a Python console, so type in
python3
and hit Enter.
$ python3
Python 3.4.2 (...)
Type "copyright", "credits" or "license" for more information.
>>>
Your first Python command!

After running the Python command, the prompt changed to
>>>
commands in the Python language. You don't have to type in

If you want to exit the Python console at any point, just type
for Mac/Linux. Then you won't see
>>>
. For us this means that for now we may only use
>>>
exit()
- Python will do that for you.
or use the shortcut
Ctrl + Z
for Windows and
Ctrl + D
any longer.
But now, we don't want to exit the Python console. We want to learn more about it. Let's start with something really simple.
For example, try typing some math, like
2+3
and hit Enter.
>>> 2 + 3
5
Nice! See how the answer popped out? Python knows math! You could try other commands like:
4*5
5-1
40 / 2
Have fun with this for a little while and then get back here :).
As you can see, Python is a great calculator. If you're wondering what else you can do...
Strings
How about your name? Type your first name in quotes like this:
>>> "Ola"
'Ola'
You've now created your first string! It's a set of characters that can be processed by a computer. The string must always
begin and end with the same character. This may be single ( ' ) or double ( " ) quotes - they tell Python that what's inside
of them is a string.
Strings can be strung together. Try this:
>>> "Hi there " + "Ola"

'Hi there Ola'
You can also multiply strings with a number:
>>> "Ola" * 3
'OlaOlaOla'
If you need to put an apostrophe inside your string, you have two ways to do it.
Using double quotes:
>>> "Runnin' down the hill"

"Runnin' down the hill"
or escaping apostrophe with a backslash ( \ ):
>>> 'Runnin\' down the hill'

"Runnin' down the hill"
Nice, huh? To see your name in uppercase letters, simply type:
>>> "Ola".upper()
'OLA'
You just used the
upper
function on your string! A function (like
upper()
) is a set of instructions that Python has to
perform on a given object ( "Ola" ) once you call it.

If you want to know the number of letters contained in your name, there is a function for that too!
>>> len("Ola")
3
Wonder why sometimes you call functions with a
at the end of a string (like
"Ola".upper()
) and sometimes you first call a
function and place the string in parentheses? Well, in some cases, functions belong to objects, like
upper()
, which can
only be performed on strings. In this case, we call the function a method. Other times, functions don't belong to anything
specific and can be used on different types of objects, just like
len
len()
. That's why we're giving
"Ola"
function.
Summary
OK, enough of strings. So far you've learned about:
the prompt - typing commands (code) into the Python prompt results in answers in Python
numbers and strings - in Python numbers are used for math and strings for text objects
operators - like + and *, combine values to produce a new one
functions - like upper() and len(), perform actions on objects.
as a parameter to the
These are the basics of every programming language you learn. Ready for something harder? We bet you are!
Errors
Let's try something new. Can we get the length of a number the same way we could find out the length of our name? Type
in
len(304023)
and hit Enter:
>>> len(304023)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: object of type 'int' has no len()
We got our first error! It says that objects of type "int" (integers, whole numbers) have no length. So what can we do now?
Maybe we can write our number as a string? Strings have a length, right?
>>> len(str(304023))
6
It worked! We used the
str
function inside of the
len
The
str
function converts things into strings
The
int
function converts things into integers
function.
str()
converts everything to strings.
Important: we can convert numbers into text, but we can't necessarily convert text into numbers - what would
int('hello')
be anyway?
Variables
An important concept in programming is variables. A variable is nothing more than a name for something so you can use
it later. Programmers use these variables to store data, make their code more readable and so they don't have to keep
remembering what things are.
Let's say we want to create a new variable called
name
>>> name = "Ola"
You see? It's easy! It's simply: name equals Ola.

As you've noticed, your program didn't return anything like it did before. So how do we know that the variable actually
exists? Simply enter
name
and hit Enter:
>>> name
'Ola'
Yippee! Your first variable :)! You can always change what it refers to:
>>> name = "Sonja"

>>> name
'Sonja'
You can use it in functions too:
>>> len(name)
5
Awesome, right? Of course, variables can be anything, so numbers too! Try this:
>>> a = 4
>>> b = 6
>>> a * b
24
But what if we used the wrong name? Can you guess what would happen? Let's try!
>>> name = "Maria"

>>> names
NameError: name 'names' is not defined
An error! As you can see, Python has different types of errors and this one is called a NameError. Python will give you
this error if you try to use a variable that hasn't been defined yet. If you encounter this error later, check your code to see if
you've mistyped any names.
Play with this for a while and see what you can do!
The print function

Try this:
>>> name = 'Maria'

>>> name
'Maria'
>>> print(name)
Maria
When you just type
name
, the Python interpreter responds with the string representation of the variable 'name', which is
the letters M-a-r-i-a, surrounded by single quotes, ''. When you say
print(name)
, Python will "print" the contents of the
variable to the screen, without the quotes, which is neater.

As we'll see later,
print()
is also useful when we want to print things from inside functions, or when we want to print things
on multiple lines.
Lists
Beside strings and integers, Python has all sorts of different types of objects. Now we're going to introduce one called list.
Lists are exactly what you think they are: they are objects which are lists of other objects :)
Go ahead and create a list:
>>> []
[]
Yes, this list is empty. Not very useful, right? Let's create a list of lottery numbers. We don't want to repeat ourselves all the
time, so we will put it in a variable, too:
>>> lottery = [3, 42, 12, 19, 30, 59]
All right, we have a list! What can we do with it? Let's see how many lottery numbers there are in a list. Do you have any
idea which function you should use for that? You know this already!
>>> len(lottery)
6
Yes!
len()
can give you a number of objects in a list. Handy, right? Maybe we will sort it now:
>>> lottery.sort()
This doesn't return anything, it just changed the order in which the numbers appear in the list. Let's print it out again and
see what happened:
>>> print(lottery)
[3, 12, 19, 30, 42, 59]
As you can see, the numbers in your list are now sorted from the lowest to highest value. Congrats!
Maybe we want to reverse that order? Let's do that!
>>> lottery.reverse()
>>> print(lottery)
[59, 42, 30, 19, 12, 3]
Easy, right? If you want to add something to your list, you can do this by typing this command:
>>> lottery.append(199)
>>> print(lottery)
[59, 42, 30, 19, 12, 3, 199]
If you want to show only the first number, you can do this by using indexes. An index is the number that says where in a
list an item occurs. Computer people like to start counting at 0, so the first object in your list is at index 0, the next one is at
1, and so on. Try this:
>>> print(lottery[0])
59
>>> print(lottery[1])
42
As you can see, you can access different objects in your list by using the list's name and the object's index inside of
square brackets.
For extra fun, try some other indexes: 6, 7, 1000, -1, -6 or -1000. See if you can predict the result before trying the
command. Do the results make sense?
You can find a list of all available list methods in this chapter of the Python documentation:
https://docs.python.org/3/tutorial/datastructures.html
Dictionaries
A dictionary is similar to a list, but you access values by looking up a key instead of an index. A key can be any string or
number. The syntax to define an empty dictionary is:
>>> {}
{}
This shows that you just created an empty dictionary. Hurray!

Now, try writing the following command (try replacing your own information too):
>>> participant = {'name': 'Ola', 'country': 'Poland', 'favorite_numbers': [7, 42, 92]}
With this command, you just created a variable named

The key
country
and
name
points to the value
points to
'Poland'
favorite_numbers
(another
points to
'Ola'
(a
string
[7, 42, 92]
string
participant
with three key-value pairs:
object),
),
(a
list
with three numbers in it).
You can check the content of individual keys with this syntax:
>>> print(participant['name'])
Ola
See, it's similar to a list. But you don't need to remember the index - just the name.
What happens if we ask Python the value of a key that doesn't exist? Can you guess? Let's try it and see!
>>> participant['age']
KeyError: 'age'
Look, another error! This one is a KeyError. Python is helpful and tells you that the key
'age'
doesn't exist in this
dictionary.
When to use a dictionary or a list? Well, that's a good point to ponder on. Just have a solution in mind before looking at
the answer in the next line.
Do you just need an ordered sequence of items? Go for a list.
Do you need to associate values with keys, so you can look them up efficiently (by key) later on? Use a dictionary.
Dictionaries, like lists, are mutable, meaning that they can be changed after they are created. You can add new key/value
pairs to the dictionary after it is created, like:
>>> participant['favorite_language'] = 'Python'
Like lists, using
len()
method on the dictionaries, returns the number of key-value pairs in the dictionary. Go ahead and
type in the command:
>>> len(participant)
4
I hope it makes sense up to now. :) Ready for some more fun with dictionaries? Hop onto the next line for some amazing
things.
You can use the
the key
del
command to delete an item in the dictionary. Say, if you want to delete the entry corresponding to
'favorite_numbers' , just type
in the following command:
>>> del participant['favorite_numbers']

>>> participant
{'country': 'Poland', 'favorite_language': 'Python', 'name': 'Ola'}
As you can see from the output, the key-value pair corresponding to the 'favorite_numbers' key has been deleted.
As well as this, you can also change a value associated with an already created key in the dictionary. Type:
>>> participant['country'] = 'Germany'

>>> participant
{'country': 'Germany', 'favorite_language': 'Python', 'name': 'Ola'}
As you can see, the value of the key
'country'
has been altered from
'Poland'
to
'Germany' . :)
Exciting? Hurrah! You just
learnt another amazing thing.
Summary
Awesome! You know a lot about programming now. In this last part you learned about:
errors - you now know how to read and understand errors that show up if Python doesn't understand a command
you've given it
variables - names for objects that allow you to code more easily and to make your code more readable
lists - lists of objects stored in a particular order
dictionaries - objects stored as key-value pairs
Excited for the next part? :)
Compare things
A big part of programming includes comparing things. What's the easiest thing to compare? Numbers, of course. Let's see
how that works:
>>> 5
True
>>> 3
False
>>> 5
True
>>> 1
True
>2
<1
>2*2
== 1
We gave Python some numbers to compare. As you can see, Python can compare not only numbers, but it can also
compare method results. Nice, huh?
Do you wonder why we put two equal signs
==
next to each other to compare if numbers are equal? We use a single
for assigning values to variables. You always, always need to put two
other.
Give Python two more tasks:
==
if you want to check if things are equal to each
>>> 6 >= 12 / 2
True
>>> 3 <= 2
False
>
and
<
are easy, but what do
>=
and
<=
>
y means: x is greater than y
<
y means: x is smaller than y
<=
y means: x is smaller or equal to y
>=
y means: x is greater or equal to y
mean? Read them like this:
Awesome! Wanna do one more? Try this:
>>> 6 > 2 and 2 < 3

True
>>> 3 > 2 and 2 < 1
False
>>> 3 > 2 or 2 < 1
True
You can give Python as many numbers to compare as you want, and it will give you an answer! Pretty smart, right?
and - if you use the
or - if you use the
and
or
operator, both comparisons have to be True in order for the whole command to be True
operator, only one of the comparisons has to be True in order for the whole command to be
True
Have you heard of the expression "comparing apples to oranges"? Let's try the Python equivalent:
>>> 1 > 'django'

TypeError: unorderable types: int() > str()
Here you see that just like in the expression, Python is not able to compare a number ( int ) and a string ( str ). Instead, it
shows a TypeError and tells us the two types can't be compared together.
Boolean
Incidentally, you just learned about a new type of object in Python. It's called a Boolean -- and it probably is the easiest
type there is.
There are only two Boolean objects:
True
False
But for Python to understand this, you need to always write it as True (first letter uppercased, with the rest of the letter
lowercased). true, TRUE, tRUE won't work -- only True is correct. (The same applies to False as well, of course.)
Booleans can be variables, too! See here:
>>> a = True
>>> a
True
You can also do it this way:
>>> a = 2 > 5
>>> a
False
Practice and have fun with Booleans by trying to run the following commands:
True and True
False and True
True or 1 == 1
1 != 2
Congrats! You can now move on to an essential tool in programming:
If...elif...else
Lots of things in code should only be executed when given conditions are met. That's why Python has something called if
statements.
Try this:
>>> if 3 > 2:
...
So far nothing has happened, as evidenced by the dots
...
instead of incentives
>>>
which we saw so far. Python
expects us to give further instructions to it which are supposed to be executed if the condition
(or
True
3>2
turns out to be true
for that matter). Lets try to make Python print It works!:
>>> if 3 > 2:
... print('It works!')
File "<stdin>", line 2
print('It works')
^
IndentationError: expected an indented block
Well... something went wrong here! Python needs to know whether the instruction we have written is a continuation of
or a next instruction not covered by the condition. We need to indent our code to make it work:
>>> if 3 > 2:
...
print('It works!')
...
It works!
All you need is one space after
...
. To avoid chaos, most Python programmers use four spaces for each level of
indentation.
Everything that is indented after the
>>> if 3 > 2:
...
print('It works!')
...
print('Another command')
...
It works!
Another command
if
statement will be executed if the condition is met. See:
if
What if not?
In previous examples, code was executed only when the conditions were True. But Python also has
elif
and
else
statements:
>>> if 5 > 2:
...
print('5 is indeed greater than 2')
... else:
...
print('5 is not greater than 2')
...
5 is indeed greater than 2
If 2 were a greater number than 5, then the second command would be executed. Easy, right? Let's see how
elif
works:
>>> name = 'Sonja'

>>> if name == 'Ola':
...
print('Hey Ola!')
... elif name == 'Sonja':
...
print('Hey Sonja!')
... else:
...
print('Hey anonymous!')
...
Hey Sonja!
See what happened there?
Summary
In the last three exercises you learned about:
comparing things - in Python you can compare things by using
>
Boolean - a type of object that can only have one of two values:
True
>=
or
==
<=
<
and the
and
or
operators
False
if...elif...else - statements that allow you to execute code only when certain conditions are met.
Time for the last part of this chapter!
Your own functions!

Remember functions like
len()
that you can execute in Python? Well, good news, you will learn how to write your own
functions now!
A function is a set of instructions that Python should execute. Each function in Python starts with the keyword
def
, is given
a name and can have some parameters. Let's start with an easy one:
>>> def hi():

...
As you can see, there are those dots again! This means that nothing has really happened yet... and yes, we need to press
the
Space
key before giving our instructions:
>>> def hi():

...
print('Hi there!')
...
print('How are you?')
...
OK, our first function is ready! Press Enter to get back to the Python prompt again. Now let's execute our function:
>>> hi()
Hi there!
How are you?
Great! You're now a programmer, congratulate yourself :)!

That was easy! Let's build our first function with parameters. We will use the previous example - a function that says 'hi' to
the person running it - with a name:
>>> def hi(name):

...
As you can see, we now gave our function a parameter that we called
name
>>> def hi(name):

...
if name == 'Ola':
...
print('Hi Ola!')
...
elif name == 'Sonja':
...
print('Hi Sonja!')
...
else:
...
print('Hi anonymous!')
...
As you can see, we needed to put two indents before the
print
function, because
if
needs to know what should happen
when the condition is met. Let's see how it works now:
>>> hi()
TypeError: hi() missing 1 required positional argument: 'name'
Oops, an error. Luckily, Python gives us a pretty useful error message. It tells us that the function
defined) has one required argument (called
name
hi()
(the one we
) and that we forgot to pass it when calling the function. Let's fix it then:
>>> hi("Ola")
Hi Ola!
>>> hi("Sonja")
Hi Sonja!
>>> hi("Anja")
Hi anonymous!
Awesome, right? This way you don't have to repeat yourself every time you want to change the name of the person the
function is supposed to greet. And that's exactly why we need functions - you never want to repeat your code!
Let's do something smarter -- there are more names than two, and writing a condition for each would be hard, right?
>>> def hi(name):

...
print('Hi ' + name + '!')
...
Let's call the function now:
>>> hi("Rachel")
Hi Rachel!
Congratulations! You just learned how to write functions :)!
Loops
That's the last part already. That was quick, right? :)
As we mentioned, programmers are lazy, they don't like to repeat themselves. Programming is all about automating
things, so we don't want to greet every person by their name manually, right? That's where loops come in handy.
Still remember lists? Let's do a list of girls:
>>> girls = ['Rachel', 'Monica', 'Phoebe', 'Ola', 'You']
We want to greet all of them by their name. We have the
function to do that, so let's use it in a loop:
hi
>>> for name in girls:

...
Dots again! Remember what goes after the dots? Yes, a space :)
>>> for name in girls:

...
hi(name)
...
print('Next girl')
...
Hi Rachel!
Next girl
Hi Monica!
Next girl
Hi Phoebe!
Next girl
Hi Ola!
Next girl
Hi You!
Next girl
As you can see, everything you put inside a

girls
for
statement with an indent will be repeated for every element of the list
You can also use
for
on numbers using the
range
method:
>>> for i in range(1, 6):

...
print(i)
...
1
2
3
4
5
range
is a function that creates a list of numbers following one after the other (these numbers are provided by you as
parameters).
Note that the second of these two numbers is not included in the list that is output by Python (meaning
from 1 to 5, but does not include the number 6).
Exiting Python
You can exit Python and return to the command line using
exit()
range(1, 6)
counts
Summary
That's it. You totally rock! This really wasn't so easy, so you should feel proud of yourself. We're definitely proud of you
for making it to here!
Grab yourself a cupcake and go to the next chapter :)
What is Django?
Django (/do/ jang-goh) is a free and open source web application framework, written in Python. It's a web
framework - a set of components that helps you to develop websites faster and easier.
You see, when you're building a website, you always need a similiar set of components: a way to handle user
authentication (signing up, signing in, signing out), a management panel for your website, forms, a way to upload files,
etc.
Luckily for you other people long ago noticed that web developers face similar problems when building a new site, so
they teamed up and created frameworks (Django is one of them) that give you ready-made components you can use.
Frameworks exist to save you from having to reinvent the wheel and help alleviate some of the overhead when youre
building a new site.
Why do you need a framework?

To understand what Django actually is for, we need to take a closer look at the servers. The first thing is that the server
needs to know that you want it to serve you a webpage.
Imagine a mailbox (port) which is monitored for incoming letters (requests). This is done by a web server. The web server
reads the letter, and sends a response with a webpage. But when you want to send something, you need to have some
content. And Django is something that helps you create the content.
What happens when someone requests a website from your

server?
When a request comes to a web server it's passed to Django which tries to figure out what actually is requested. It takes a
webpage address first and tries to figure out what to do. This part is done by Django's urlresolver (note that a website
address is called a URL - Uniform Resource Locator - so the name urlresolver makes sense). It is not very smart - it takes
a list of patterns and tries to match the URL. Django checks patterns from top to the bottom and if something is matched
then Django passes the request to the associated function (which is called view).
Imagine a postman with a letter. She is walking down the street and checks each house number against the one on the
letter. If it matches, she puts the letter there. This is how the urlresolver works!
In the view function all the interesting things are done: we can look at a database to look for some information. Maybe the
user asked to change something in the data? Like a letter saying "Please change description of my job." The view can
check if you are allowed to do that, then update the job description for you and send back a message: "Done!". Then the
view generates a response and Django can send it to the user's web browser.
Of course, the description above is a little bit simplified, but you don't need to know all the technical things yet. Having a
general idea is enough.
So instead of diving too much into details, we will simply start creating something with Django and we will learn all the
important parts along the way!
Django installation
Part of this chapter is based on the django-marcador tutorial licensed under Creative Commons AttributionShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Grndemann
et al.
Virtual environment
Before we install Django, we'll get you to install an extremely useful tool that will help keep your coding environment tidy
on your computer. It's possible to skip this step, but it's highly recommended not to - starting with the best possible setup
will save you a lot of trouble in the future!
So, let's create a virtual environment (also called a virtualenv). It will isolate your Python/Django setup on a per-project
basis, meaning that any changes you make to one website won't affect any others you're also developing. Neat, right?
All you need to do is find a directory in which you want to create the
Windows it might look like
C:\Users\Name\
(where
For this tutorial we will be using a new directory
Name
virtualenv ; your
home directory, for example. On
is the name of your login).
djangogirls
from your home directory:
mkdir djangogirls
cd djangogirls
We will make a virtualenv called
myvenv . The
general command will be in the format:
python -m venv myvenv
Windows
To create a new
run
virtualenv , you
need to open the console (we told you about that a few chapters ago - remember?) and
C:\Python34\python -m venv myvenv . It will
look like this:
C:\Users\Name\djangogirls> C:\Python34\python -m venv myvenv
where
C:\Python34\python
virtualenv . You
is the directory in which you previously installed Python and
myvenv
is the name of your
can use any other name, but stick to lowercase and use no spaces. It is also good idea to keep the name
short - you'll be referencing it a lot!
Linux and OS X
Creating a
virtualenv
on both Linux and OS X is as simple as running
python3 -m venv myvenv . It will
look like this:
~/djangogirls$ python3 -m venv myvenv
myvenv
is the 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 - you'll be referencing it a lot!

NOTE: Initiating the virtual environment on Ubuntu 14.04 like this currently gives the following error:
Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
To get around this, use the
virtualenv
command instead.
~/djangogirls$ sudo apt-get install python-virtualenv

~/djangogirls$ virtualenv --python=python3.4 myvenv
Working with virtualenv

The command above will create a directory called
myvenv
(or whatever name you chose) that contains our virtual
environment (basically a bunch of directory and files). All we want to do now is start it by running:
C:\Users\Name\djangogirls> myvenv\Scripts\activate
on Windows, or:
~/djangogirls$ source myvenv/bin/activate
on OS X and Linux.
Remember to replace
NOTE: sometimes
myvenv
source
with your chosen
virtualenv
name!
might not be available. In those cases try doing this instead:
~/djangogirls$ . myvenv/bin/activate
You will know that you have
virtualenv
started when you see that the prompt in your console looks like:
(myvenv) C:\Users\Name\djangogirls>
or:
(myvenv) ~/djangogirls$
Notice the prefix
(myvenv)
appears!
When working within a virtual environment,

instead of
python3
python
will automatically refer to the correct version so you can use
python
OK, we have all important dependencies in place. We can finally install Django!
Installing Django
Now that you have your
virtualenv
started, you can install Django using
(note that we use a double equal sign:
==
).
pip
. In the console, run
pip install django==1.7.1
(myvenv) ~$ pip install django==1.7.1

Downloading/unpacking django==1.7.1
Installing collected packages: django
Successfully installed django
Cleaning up...
on Windows
If you get an error when calling pip on Windows platform please check if your project pathname contains spaces
(i.e.
is:
C:\Users\User Name\djangogirls
C:\djangogirls
). If it does please consider moving it to another place without spaces (suggestion
). After the move please try the above command again.
on Linux
If you get an error when calling pip on Ubuntu 12.04 please run
python -m pip install -U --force-reinstall pip
to fix the
pip installation in the virtualenv.

That's it! You're now (finally) ready to create a Django application! But to do that, you need a nice program to write your
code in...
Code editor
You're about to write your first line of code, so it's time to download a code editor!
There are a lot of different editors and it largely boils down to personal preference. Most Python programmers use
complex but extremely powerful IDEs (Integrated Development Environments), such as PyCharm. As a beginner,
however, that's probably less suitable; our recommendations are equally powerful, but a lot simpler.
Our suggestions are below, but feel free to ask your coach what their preferences are - it'll be easier to get help from
them.
Gedit
Gedit is an open-source, free editor, available for all operating systems.
Download it here
Sublime Text 2
Sublime Text is a very popular editor with a free evaluation period. It's easy to install and use, and it's available for all
operating systems.
Download it here
Atom
Atom is an extremely new code editor created by GitHub. It's free, open-source, easy to install and easy to use. It's
available for Windows, OSX and Linux.
Download it here
Your first Django project!

Parts of this chapter are based on the django-marcador tutorial licensed under Creative Commons AttributionShareAlike 4.0 International License. The django-marcador tutorial is copyrighted by Markus Zapke-Grndemann
et al.
We're going to create a simple blog!
The first step towards creating it is to start a new Django project. Basically, this means that we'll run some scripts provided
by Django that will create the skeleton of a Django project for us: a bunch of directories and files that we will later use.
The names of some files and directories are very important for Django. You should not rename the files that we are about
to create. Moving them to a different place is also not a good idea. Django needs to maintain a certain structure in order
to be able to find important things.
In console you should run (remember that you don't type
(myvenv) ~/djangogirls$
Remember to run everything in the virtualenv. If you don't see a prefix
, OK?):
(myvenv)
in your console you need to
activate your virtualenv. We explained how to do that in the Django installation chapter in the Working with
virtualenv part.
Run on Windows:
(myvenv) ~/djangogirls$ python myvenv\Scripts\django-admin.py startproject mysite .
or on Linux or Mac OS:
(myvenv) ~/djangogirls$ django-admin startproject mysite .
Double-check that you included the period ( . ) at the end of the command, it's important.
django-admin
is a script that will create the directories and files for you. You should now have a directory structure which
looks like this:
djangogirls
manage.py
mysite
settings.py
urls.py
wsgi.py
__init__.py
manage.py
is a script that helps with management of the site. With it we will be able to start a web server on our computer
without installing anything else, amongst other things.

The
settings.py
file contains the configuration of your website.
Remember when we talked about a postman checking where to deliver a letter?

used by
urlresolver
urls.py
file contains a list of patterns
Let's ignore the other files for now - we won't change them. The only thing to remember is not to delete them by accident!
Changing settings
Let's make some changes in
mysite/settings.py . Open
the file using the code editor you installed earlier.
It would be nice to have the correct time on our website. Go to

http://en.wikipedia.org/wiki/List_of_tz_database_time_zones and copy your relevant time zone (TZ). (eg.
You should find lines that contain
USE_TZ
and
TIME_ZONE
and modify them to look like this, substituting
Europe/Berlin
Europe/Berlin
with
your relevant time zone:
USE_TZ = False
TIME_ZONE = 'Europe/Berlin'
Setup a database
There's a lot of different database software that can store data for your site. We'll use the default one,
This is already set up in this part of your
mysite/settings.py
sqlite3
file:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
To create a database for our blog, let's run the following in the console:
djangogirls
directory that contains the
python manage.py migrate
(we need to be in the
file). If that goes well, you should see something like this:
manage.py
(myvenv) ~/djangogirls$ python manage.py migrate

Operations to perform:
Apply all migrations: admin, contenttypes, auth, sessions
Running migrations:
Applying contenttypes.0001_initial... OK
Applying auth.0001_initial... OK
Applying admin.0001_initial... OK
Applying sessions.0001_initial... OK
And we're done! Time to start the web server and see if our website is working!
You need to be in the directory that contains the
web server by running
manage.py
python manage.py runserver
file (the
djangogirls
directory). In the console, we can start the
(myvenv) ~/djangogirls$ python manage.py runserver
Now all you need to do is check that your website is running - open your browser (Firefox, Chrome, Safari, Internet
Explorer or whatever you use) and enter the address:
http://127.0.0.1:8000/
You can stop the web server again (e.g. to type other commands on the command prompt) by pressing CTRL+C - Control
and C buttons together.
Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
Ready for the next step? It's time to create some content!
Django models
What we want to create now is something that will store all posts in our blog. But to be able to do that we need to talk a
little bit about things called
objects
Objects
There is a concept in programming called
Object-oriented programming
. The idea is that instead of writing everything as a
boring sequence of programming instructions we can model things and define how they interact with each other.
So what is an object? It is a collection of properties and actions. It sounds weird, but we will give you an example.
If we want to model a cat we will create an object
sleepy ;)),
owner
And then the
Cat
(that is a
Person
Cat
that has some properties, i.e.
color
age
mood
(i.e. good, bad,
object or maybe, in case of a stray cat, this property is empty).
has some actions:
separate object with properties, i.e.
purr
taste
scratch
or
feed
(in which we will give the cat some
CatFood
, which could be a
).
Cat
-------color
age
mood
owner
purr()
scratch()
feed(cat_food)
CatFood
-------taste
So basically the idea is to describe real things in code with properties (called
methods
object properties
) and actions (called
).
How will we model blog posts then? We want to build a blog, right?
We need to answer the question: what is a blog post? What properties should it have?
Well, for sure our blog post needs some text with its content and a title, right? It would be also nice to know who wrote it so we need an author. Finally, we want to know when the post was created and published.
Post
-------title
text
author
created_date
published_date
What kind of things could be done with a blog post? It would be nice to have some
So we will need
publish
method
method.
Since we already know what we want to achieve, we can start modeling it in Django!
Django model
that publishes the post, right?
Knowing what an object is, we can create a Django model for our blog post.
A model in Django is a special kind of object - it is saved in the
database
. A database is a collection of data. This is a
place in which you will store information about users, your blog posts, etc. We will be using a SQLite database to store
our data. This is the default Django database adapter -- it'll be enough for us right now.
You can think of a model in the database as a spreadsheet with columns (fields) and rows (data).
Creating an application
To keep everything tidy, we will create a separate application inside our project. It is very nice to have everything
organized from the very beginning. To create an application we need to run the following command in the console (from
djangogirls
directory where
manage.py
file is):
(myvenv) ~/djangogirls$ python manage.py startapp blog
You will notice that a new
blog
directory is created and it contains a number of files now. Our directories and files in our
project should look like this:
djangogirls
mysite
|
__init__.py
|
settings.py
|
urls.py
|
wsgi.py
manage.py
blog
migrations
|
__init__.py
__init__.py
admin.py
models.py
tests.py
views.py
After creating an application we also need to tell Django that it should use it. We do that in the file
need to find
INSTALLED_APPS
and add a line containing
'blog',
just above
mysite/settings.py . We
. So the final product should look like this:
INSTALLED_APPS = (
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'blog',
)
Creating a blog post model

In the
blog/models.py
Let's open
file we define all objects called
blog/models.py , remove
Models
- this is a place in which we will define our blog post.
everything from it and write code like this:
from django.db import models

from django.utils import timezone
class Post(models.Model):
author = models.ForeignKey('auth.User')
title = models.CharField(max_length=200)
text = models.TextField()
created_date = models.DateTimeField(
default=timezone.now)
published_date = models.DateTimeField(
blank=True, null=True)
def publish(self):
self.published_date = timezone.now()
self.save()
def __str__(self):
return self.title
Double-check that you used two undescore characters ( _ ) on each side of
str
. Those are used frequently in
Python and sometimes we also call them "dunder" (short for "double-underscore").
It is scary, right? But no worries, we will explain what these lines mean!
All lines starting with
from
or
import
are lines that add some bits from other files. So instead of copying and pasting the
same things in every file, we can include some parts with

class Post(models.Model):
class
Post
from ... import ...
- this line defines our model (it is an
object
).
is a special keyword that indicates that we are defining an object.

is the name of our model, we can give it a different name (but we must avoid special characters and
whitespaces). Always start a class name with an uppercase letter.

models.Model
means that the Post is a Django Model, so Django knows that it should be saved in the database.
Now we define properties we were talking about:
title
text
created_date
published_date
and
author
. To do that we
need to define a type of field (is it text? A number? A date? A relation to another object, i.e. a User?).
models.CharField
- this is how you define text with a limited number of characters.
models.TextField
- this is for long texts without a limit. It will be ideal for a blog post content, right?
- this is a date and time.
models.DateTimeField
models.ForeignKey
- this is a link to another model.
We will not explain every bit of code here, since it would take too much time. You should take a look at Django's
documentation, if you want to know more about Model fields and how to define things other than those described above
(https://docs.djangoproject.com/en/1.7/ref/models/fields/#field-types).
What about
def publish(self):
function/method.
publish
? It is exactly our
publish
method we were talking about before.
def
means that this is a
is the name of the method. You can change it, if you want. The rule is that we use lowercase
and underscores instead of whitespaces (i.e. if you want to have a method that calculates average price you could call it
calculate_average_price
Methods very often

__str__()
).
return
something. There is an example of that in the
__str__
method. In this scenario, when we call
we will get a text (string) with a Post title.
If something is still not clear about models, feel free to ask your coach! We know it is very complicated, especially when
you learn what objects and functions are at the same time. But hopefully it looks slightly less magic for you now!
Create tables for models in your database

The last step here is to add our new model to our database. First we have to make Django know that we have some
changes in our model (we have just created it), type
python manage.py makemigrations blog
. It will look like this:
(myvenv) ~/djangogirls$ python manage.py makemigrations blog

Migrations for 'blog':
0001_initial.py:
- Create model Post
Django prepared for us a migration file that we have to apply now to our database, type
python manage.py migrate blog
the output should be:
(myvenv) ~/djangogirls$ python manage.py migrate blog

Operations to perform:
Apply all migrations: blog
Running migrations:
Applying blog.0001_initial... OK
Hurray! Our Post model is now in our database, it would be nice to see it, right? Jump to the next chapter to see what your
Post looks like!
Django ORM and QuerySets

In this chapter you'll learn how Django connects to the database and stores data in it. Let's dive in!
What is a QuerySet?
A QuerySet is, in essence, a list of objects of a given Model. QuerySet allows you to read the data from database, filter it
and order it.
It's easiest to learn by example. Let's try this, shall we?
Django shell
Open up your console and type this command:
> $ python manage.py shell
The effect should be like this:
(InteractiveConsole)
>>>
You're now in Django's interactive console. It's just like Python prompt but with some additional Django magic :). You can
use all the Python commands here too, of course.
All objects
Let's try to display all of our posts first. You can do that with the following command:
>>> Post.objects.all()
File "<console>", line 1, in <module>
NameError: name 'Post' is not defined
Oops! An error showed up. It tells us that there is no Post. It's correct -- we forgot to import it first!
>>> from blog.models import Post
This is simple: we import model
Post
from
blog.models
. Let's try displaying all posts again:
[]
It's an empty list. That seems to be correct, right? We didn't add any posts yet! Let's fix that.
Create object
This is how you create a Post object in database:
>>> Post.objects.create(author=user, title='Sample title', text='Test')
But we have one missing ingredient here:
user
. We need to pass an instance of
User
model as an author. How to do
that?
Let's import User model first:
>>> from django.contrib.auth.models import User
What users do we have in our database? Try this:
>>> User.objects.all()
[]
No users! Let's create a user:
>>> User.objects.create(username='ola')
<User: ola>
What users do we now have in our database? Try this:
>>> User.objects.all()
[<User: ola>]
Cool! Let's get an instance of the user now:
user = User.objects.get(username='ola')
As you can see, we now
get
User
with a
username
that equals to 'ola'. Neat! Of course, you have to adjust it to your
username.
Now we can finally create our first post:
>>> Post.objects.create(author = user, title = 'Sample title', text = 'Test')
Hurray! Wanna check if it worked?
[<Post: Sample title>]
Add more posts

You can now have a little fun and add more posts to see how it works. Add 2-3 more and go ahead to the next part.
Filter objects
A big part of QuerySets is an ability to filter them. Let's say, we want to find all posts that are authored by User ola. We will
use
filter
instead of
all
in
Post.objects.all()
. In parentheses we will state what condition(s) needs to be met by a blog post
to end up in our queryset. In our situation it is
author
that is equal to
user
. The way to write it in Django is:
author=user
Now our piece of code looks like this:
>>> Post.objects.filter(author=user)
[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
Or maybe we want to see all the posts that contain a word 'title' in the
title
field?
>>> Post.objects.filter(title__contains='title')
[<Post: Sample title>, <Post: 4th title of post>]
There are two underscore characters ( _ ) between
title
and
contains
. Django's ORM uses this syntax to separate
field names ("title") and operations or filters ("contains"). If you only use one underscore, you'll get an error like
"FieldError: Cannot resolve keyword title_contains".
You can also get a list of all published posts. We do it by filtering all the posts that have
published_date
>>> Post.objects.filter(published_date__isnull=False)
[]
Unfortunately, none of our posts are published yet. We can change that! First get an instance of a post we want to publish:
>>> post = Post.objects.get(id=1)
And then publish it with our
publish
method!
>>> post.publish()
Now try to get list of published posts again (press the up arrow button 3 times and hit Enter):
>>> Post.objects.filter(published_date__isnull=False)
[<Post: Sample title>]
Ordering objects
QuerySets also allow you to order the list of objects. Let's try to order them by
created_date
>>> Post.objects.order_by('created_date')
[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]
We can also reverse the ordering by adding
at the beginning:
>>> Post.objects.order_by('-created_date')
[<Post: 4th title of post>, <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]
Cool! You're now ready for the next part! To close the shell, type this:
>>> exit()
$
field:
Django admin
To add, edit and delete posts we've just modeled, we will use Django admin.
Let's open the
blog/admin.py
file and replace its content with this:
from django.contrib import admin

from .models import Post
admin.site.register(Post)
As you can see, we import (include) the Post model defined in the previous chapter. To make our model visible on the
admin page, we need to register the model with
admin.site.register(Post)
OK, time to look at our Post model. Remember to run
in the console to run the web server. Go
to the browser and type the address:
http://127.0.0.1:8000/admin/
You will see a login page like this:
In order to log in you need to create a superuser - a user which has control over everything on the site. Go back to you
command-line and type
python manage.py createsuperuser
, press enter and type your username (lowercase, no spaces),
email address and password when you're asked for them. The output should look like this (where username and email
should be your own ones):
(myvenv) ~/djangogirls$ python manage.py createsuperuser

Username: admin
Email address: admin@admin.com
Password:
Password (again):
Superuser created successfully.
Return to your browser and log in with the superuser's credentials you chose, you should see the Django admin
dashboard.
Go to Posts and experiment a little bit with it. Add five or six blog posts. Don't worry about the content - you can simply
copy-paste some text from this tutorial as your posts' content to save time :).
Make sure that at least two or three posts (but not all) have the publish date set. It will be helpful later.
If you want to know more about Django admin, you should check Django's documentation:
https://docs.djangoproject.com/en/1.7/ref/contrib/admin/
It is probably a good moment to grab a coffee (or tea) and eat something sweet. You created your first Django model you deserve a little treat!
Deploy!
Note Following chapter can be sometimes a bit harder to get through. Insist on finishing it, deployment is an important
part of website development process. Chapter is placed in the middle of tutorial so that mentor can help you get your
website online while you can still finish the tutorial alone if you run out of time.
Until now your website was only available on your computer, now you will learn how to deploy it! Deploying is the
process of publishing your application on the Internet so people can finally go and see your app :).
As you learned, a website has to be located on a server. There are a lot of providers, but we will use the one with the
simplest deployment process: Heroku. Heroku is free for small applications that don't have too many visitors, it'll definitely
be enough for you now.
We will be following this tutorial: https://devcenter.heroku.com/articles/getting-started-with-django, but we pasted it here
so it's easier for you.
The
file
requirements.txt
We need to create a
requirements.txt
file to tell Heroku what Python packages need to be installed on our server.
But first, Heroku needs us to install a few packages. Go to your console with
virtualenv
activated and type this:
(myvenv) $ pip install dj-database-url waitress whitenoise
After the installation is finished, go to the
djangogirls
directory and run this command:
(myvenv) $ pip freeze > requirements.txt
This will create a file called
requirements.txt
with a list of your installed packages (i.e. Python libraries that you are using,
for example Django :)).

Open this file and add the following line at the bottom:
psycopg2==2.5.3
This line is needed for your application to work on Heroku.
Procfile
Another thing we need to create is a Procfile. This will let Heroku know which commands to run in order to start our
website. Open up your code editor, create a file called
Procfile
in
djangogirls
directory and add this line:
web: waitress-serve --port=$PORT mysite.wsgi:application
This line means that we're going to be deploying a

serve --port=$PORT mysite.wsgi:application
runserver
command).
Then save it. Done!
web
application, and we'll do that by running the command
waitress-
( waitress-serve is a program that's like a more powerful version of Django's
The
runtime.txt
file
We need to tell Heroku which Python version we want to use. This is simply done by creating a
runtime.txt
and putting
the following text inside:
python-3.4.2
mysite/local_settings.py
There is a difference between settings we are using locally (on our computer) and settings for our server. Heroku is using
one database, and your computer is using a different database. That's why we need to create a seperate file for settings
that will only be available for our local enviroment.
Go ahead and create
mysite/local_settings.py
file. It should contain your
DATABASE
setup from your
mysite/settings.py
file.
Just like that:
import os
BASE_DIR = os.path.dirname(os.path.dirname(__file__))
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
DEBUG = True
Then just save it! :)
mysite/settings.py
Another thing we need to do is modify our website's
settings.py
file. Open
following lines at the end of the file:
import dj_database_url
DATABASES['default'] = dj_database_url.config()
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
ALLOWED_HOSTS = ['*']
STATIC_ROOT = 'staticfiles'
DEBUG = False
At the end of the
mysite/settings.py , copy
and paste this:
try:
from .local_settings import *
except ImportError:
pass
It'll import all of your local settings if the file exists.

Then save the file.
mysite/settings.py
in your editor and add the
mysite/wsgi.py
Open the
mysite/wsgi.py
file and add these lines at the end:
from whitenoise.django import DjangoWhiteNoise

application = DjangoWhiteNoise(application)
All right!
Heroku account
You need to install your Heroku toolbelt which you can find here (you can skip the installation if you've already installed it
during setup): https://toolbelt.heroku.com/
When running the Heroku toolbelt installation program on Windows make sure to choose "Custom Installation"
when being asked which components to install. In the list of components that shows up after that please
additionally check the checkbox in front of "Git and SSH".
On Windows you also must run the following command to add Git and SSH to your command prompt's
PATH "%PATH%;C:\Program Files\Git\bin"
PATH
setx
. Restart the command prompt program afterwards to enable the change.
Please also create a free Heroku account here: https://id.heroku.com/signup/www-home-top

Then authenticate your Heroku account on your computer by running this command:
$ heroku login
In case you don't have an SSH key this command will automatically create one. SSH keys are required to push code to
the Heroku.
Git
Heroku uses a git repository to manage your project files, so we need to use it too.
Create
.gitignore
file with the following content:
myvenv
__pycache__
staticfiles
local_settings.py
db.sqlite3
and save it. The dot on the beginning of the file name is important! As you can see, we're now telling Heroku to ignore
local_settings.py
and don't download it, so it's only available on your computer (locally).
NOTE: Remember to replace
myvenv
with the name you gave your
virtualenv !
Next, well create a new git repository and save our changes. Go to your console and run these commands:
$ git init
Initialized empty Git repository in ~/djangogirls/.git/
$ git add .
$ git commit -m "My Django Girls app"
[master (root-commit) 2943412] My Django Girls
7 files changed, 230 insertions(+)
create mode 100644 .gitignore
create mode 100644 Procfile
create mode 100644 mysite/__init__.py
create mode 100644 mysite/settings.py
create mode 100644 mysite/urls.py
create mode 100644 mysite/wsgi.py
create mode 100644 manage.py
create mode 100644 requirements.txt
create mode 100644 runtime.txt
Deploy to Heroku!
It was a lot of configuration and installing, right? But you need to do that once! Now you can deploy!
It's as simple as running this command, replacing
djangogirlsblog
with your own application name:
$ heroku create djangogirlsblog
: Remember to replace
djangogirlsblog
with the name of your application on Heroku.
This automatically added the Heroku remote for our app to our repository. Now we can do a simple git push to deploy our
application:
$ git push heroku master
Visit your application

Youve deployed your code to Heroku, and specified the process types in a
earlier). We can now tell Heroku to start this
web process
Procfile
(we chose a
web
process type
To do that, run the following command:
$ heroku ps:scale web=1
This tells Heroku to run just one instance of our
web
process. Since our blog application is quite simple, we don't need
too much power and so it's fine to run just one process. It's possible to ask Heroku to run more processes (by the way,
Heroku calls these processes "Dynos" so don't be surprised if you see this term) but it will no longer be free.
We can now visit the app in our browser with
heroku open
$ heroku open
This will open a url like https://djangogirlsblog.herokuapp.com/ in your browser. Since we only created the admin view for
the app so far, add
admin/
to the url (e.g. https://djangogirlsblog.herokuapp.com/admin/) to see a working page of our
web app.
We created a new database on Heroku, but we also need to sync it:
$ heroku run python manage.py migrate
As you can see, there is an error. Heroku created a new database for us and it's empty. We also need to sync it:
$ heroku run python manage.py createsuperuser
You should now be able to see your website in a browser! Congrats :)!
Django urls
We're about to build our first webpage -- a homepage for your blog! But first, let's learn a little bit about Django urls.
What is a URL?
A URL is simply a web address, you can see a URL every time you visit any website - it is visible in your browser's
address bar (yes!
127.0.0.1:8000
is a URL! And http://djangogirls.com is also a URL):
Every page on the Internet needs its own URL. This way your application knows what it should show to a user who opens
a URL. In Django we use something called
URLconf
(URL configuration), which is a set of patterns that Django will try to
match with the received URL to find the correct view.
How do URLs work in Django?

Let's open up the
mysite/urls.py
file and see what it looks like:
from django.conf.urls import patterns, include, url

urlpatterns = patterns('',
# Examples:
# url(r'^$', 'mysite.views.home', name='home'),
# url(r'^blog/', include('blog.urls')),
url(r'^admin/', include(admin.site.urls)),
)
As you can see, Django already put something here for us.
Lines that start with
are comments - it means that those lines won't be run by Python. Pretty handy, right?
The admin URL, which you visited in previous chapter is already here:
It means that for every URL that starts with
admin/
Django will find a corresponding view. In this case we're including a lot
of admin URLs so it isn't all packed into this small file -- it's more readable and cleaner.
Regex
Do you wonder how Django matches URLs to views? Well, this part is tricky. Django uses
regex
-- regular expressions.
Regex has a lot (a lot!) of rules that form a search pattern. It is not so easy to understand so we won't worry about it today
and you'll definitely get to know them in the future. Today we will only use the ones we need.
Here is a simple example just to not leave you stuck on this sentence: imagine you have a website with the address like
that:
http://www.mysite.com/post/12345/
, where
12345
is the number of your post. Writing separate views for all the post
numbers would be really annoying. Django makes it easier by allowing you to write
number>/
http://www.mysite.com/post/<a
. Django will take care of the rest!
Your first Django url!

Time to create our first URL! We want http://127.0.0.1:8000/ to be a homepage of our blog and display a list of posts.
We also want to keep the
mysite/urls.py
mysite/urls.py
file clean, so we will import urls from our
blog
application to the main
file.
Go ahead, delete the commented lines (lines starting with
) and add a line that will import
blog.urls
into the main url
( '' ).
Your
mysite/urls.py
file should now look like this:

url(r'', include('blog.urls')),
)
Django will now redirect everything that comes into
http://127.0.0.1:8000/
to
blog.urls
and look for further instructions
there.
blog.urls
Create a new
blog/urls.py
empty file. All right! Add these two first lines:

from . import views
Here we're just importing Django's methods and all of our
views
from
blog
application (we don't have any yet, but we will
get to that in a minute!)

After that, we can add our first URL pattern:
url(r'^$', views.post_list),
)
As you can see, we're now assigning a
view
called
post_list
to
^$
URL. But what does
^$
mean? It's a regex magic :)
Let's break it down:

^
in regex means "the beginning"; from this sign we can start looking for our pattern
matches only "the end" of the string, which means that we will finish looking for our pattern here
If you put these two signs together, it looks like we're looking for an empty string! And that's correct, because in Django url
resolvers,
http://127.0.0.1:8000/
is not a part of URL. This pattern will show Django that
go if someone enters your website at the
http://127.0.0.1:8000/
address.
Everything all right? Open http://127.0.0.1:8000/ in your browser to see the result.
views.post_list
is the right place to
There is no "It works" anymore, huh? Don't worry, it's just an error page, nothing to be scared of! They're actually pretty
useful:
You can read that there is no attribute 'post_list'. Is post_list reminding you of anything? This is how we called our view!
This means that everything is in place, we just didn't create our view yet. No worries, we will get there.
If you want to know more about Django URLconfs, look at the official documentation:
https://docs.djangoproject.com/en/1.7/topics/http/urls/
Django views - time to create!

Time to get rid of the bug we created in the last chapter :)
A view is a place where we put the "logic" of our application. It will request information from the
and pass it to a
template
model
you created before
that you will create in the next chapter. Views are just Python methods that are a little bit more
complicated than the thing we did in the Introduction to Python chapter.

Views are placed in the
views.py
file. We will add our views to the
blog/views.py
file.
blog/views.py
OK, let's open up this file and see what's in there:
from django.shortcuts import render

# Create your views here.
Not too much stuff here yet. The simplest view can look like this.
def post_list(request):
return render(request, 'blog/post_list.html', {})
As you can see, we created a method ( def ) called

render (put together) our template
post_list
blog/post_list.html
that takes
request
and
return
a method
Save the file, go to http://127.0.0.1:8000/ and see what we have got now.
Another error! Read what's going on now:
This one is easy: TemplateDoesNotExist. Let's fix this bug and create a template in the next chapter!
Learn more about Django views by reading the official documentation:
https://docs.djangoproject.com/en/1.7/topics/http/views/
render
that will
Introduction to HTML
What's a template, you may ask?
A template is a file that we can re-use to present different information in a consistent format - for example, you could use a
template to help you write a letter, because although each letter might contain a different message and be addressed to a
different person, they will share the same format.
A Django template's format is described in a language called HTML (that's the HTML we mentioned in the first chapter
How the Internet works).
What is HTML?
HTML is a simple code that is interpreted by your web browser - such as Chrome, Firefox or Safari - to display a webpage
for the user.
HTML stands for "HyperText Markup Language." HyperText means it's a type of text that supports hyperlinks between
pages. Markup means we have taken a document and marked it up with code to tell something (in this case, a browser)
how to interpret the page. HTML code is built with tags, each one starting with
<
and ending with
>
. These tags markup
elements.
Your first template!

Creating a template means creating a template file. Everything is a file, right? You have probably noticed this already.
Templates are saved in
blog/templates/blog
directory. So first create a directory called
directory. Then create another directory called
blog
templates
inside your blog
inside your templates directory:
blog
templates
blog
(You might wonder why we need two directories both called
blog
- as you will discover later, this is simply a useful
naming convention that makes life easier when things start to get more complicated.)
And now create a
post_list.html
file (just leave it blank for now) inside the
blog/templates/blog
directory.
See how your website looks now: http://127.0.0.1:8000/

If you still have an error
TemplateDoesNotExists
, try to restart your server. Go into command line, stop the reserver by
pressing Ctrl+C (Control and C buttons together) and start it again by running a
command.
No error anymore! Congratulations :) However, your website isn't actually publishing anything except an empty page,
because your template is empty too. We need to fix that.
Add the following to your template file:
<html>
<p>Hi there!</p>
<p>It works!</p>
</html>
So how does your website look now? Click to find out: http://127.0.0.1:8000/
It worked! Nice work there :)

The most basic tag,
<html>
, is always the beginning of any webpage and
see, the whole content of the website goes between the beginning tag
<p>
is a tag for paragraph elements;
</p>
</html>
<html>
is always the end. As you can
and closing tag
</html>
closes each paragraph
Head & body

Each HTML page is also divided into two elements: head and body.
head is an element that contains information about the document that is not displayed on the screen.
body is an element that contains everything else that is displayed as part of the web page.
We use
<head>
to tell the browser about the configuration of the page, and
For example, you can put a webpage title element inside the
<head>
<body>
, like this:
to tell it what's actually on the page.
<html>
<head>
<title>Ola's blog</title>
</head>
<body>
<p>Hi there!</p>
<p>It works!</p>
</body>
</html>
Save the file and refresh your page.
Notice how the browser has understood that "Ola's blog" is the title of your page? It has interpreted
blog</title>
<title>Ola's
and placed the text in the title bar of your browser (it will also be used for bookmarks and so on).
Probably you have also noticed that each opening tag is matched by a closing tag, with a
, and that elements are
nested (i.e. you can't close a particular tag until all the ones that were inside it have been closed too).
It's like putting things into boxes. You have one big box,
contains still smaller boxes:
<p></p>
<html></html>
; inside it there is
<body></body>
, and that
You need to follow these rules of closing tags, and of nesting elements - if you don't, the browser may not be able to
interpret them properly and your page will display incorrectly.
Customize your template

You can now have a little fun and try to customize your template! Here are a few useful tags for that:
<h1>A heading</h1>
- for your most important heading
<h2>A sub-heading</h2>
for a heading at the next level
<h3>A sub-sub-heading</h3>
<em>text</em>
<strong>text</strong>
<br />
... and so on, up to
<h6>
emphasizes your text

strongly emphasizes your text
goes to another line (you can't put anything inside br)
<a href="http://google.com/">link</a>
creates a link
<ul><li>first item</li><li>second item</li></ul>

<div></div>
defines a section of the page
Here's an example of a full template:
makes a list, just like this one!
<html>
<head>
<title>Django Girls blog</title>
</head>
<body>
<div>
<h1><a href="">Django Girls Blog</a></h1>
</div>
<div>
<p>published: 14.06.2014, 12:14</p>
<h2><a href="">My first post</a></h2>
<p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce
</div>
<div>
<p>published: 14.06.2014, 12:14</p>
<h2><a href="">My second post</a></h2>
<p>Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Donec id elit non mi porta gravida at eget metus. Fusce
</div>
</body>
</html>
We've created three

The first
div
Another two
p
div
sections here.
element contains the title of our blogpost - it's a heading and a link
div
elements contain our blogposts with a published date,
h2
with a post title that is clickable and two
s (paragraph) of text, one for the date and one for our blogpost.
It gives us this effect:
Yaaay! But so far, our template only ever displays exactly the same information - whereas earlier we were talking about
templates as allowing us to display different information in the same format.
What we want really want to do is display real posts added in our Django admin - and that's where we're going next.
One more thing
It'd be good to see if your website will be still working on Heroku, right? Let's try deploying again.
First off, let's see what files have changed since we last deployed:
$ git status
Let's tell
git
to include all the changes from the current directory:
$ git add -A .
-A
(short for "all") means that
git
will also recognize if you've deleted files (by default, it only recognizes
new/modified files). Also remember (from chapter 3) that

Before we upload all the files, let's check what
git
means the current directory.
will be uploading (all the files that
git
will upload should now appear
in green):
$ git status
We're almost there, now it's time to tell it to save this change in its history. We're going to give it a "commit message"
where we describe what we've changed. You can type anything you'd like at this stage, but it's helpful to type something
descriptive so that you can remember what you've done in the future.
$ git commit -m "Changed the HTML for the site."
Make sure you use double quotes around the commit message.
Once we've done that, we can finally upload (push) our changes to the website on heroku:
git push heroku master
And that should be it! Once Heroku is finished, you can go ahead and refresh your website in the browser. Changes
should be visible!
Django Querysets
We have different pieces in place: the
Post
model is defined in
models.py , we
have
post_list
in
views.py
and the template
added. But how will we actually make our posts appear in our HTML template? Because that is what we want: take some
content (models saved in the database) and display it nicely in our template, right?
This is exactly what views are supposed to do: connect models and templates. In our
post_list
view we will need to take
models we want to display and pass them to the template. So basically in a view we decide what (model) will be
displayed in a template.
OK, so how will we achieve it?
We need to open our
blog/views.py . So
far
post_list
view looks like this:

Remember when we talked about including code written in different files? Now it is the moment when we have to include
the model we have written in
models.py . We
will add this line
like this:

Dot after
from
means current directory or current application. Since
can simply use
and the name of the file (without
But what's next? To take actual blog posts from
.py ). Then
Post
views.py
and
models.py
are in the same directory we
we import the name of the model ( Post ).
model we need something called
QuerySet
QuerySet
You should already be familiar with how QuerySets work. We talked about it in Django ORM (QuerySets) chapter.
So now we are interested in a list of blog posts that are published and sorted by
published_date
, right? We already did
that in QuerySets chapter!
Post.objects.filter(published_date__isnull=False).order_by('published_date')
Now we put this piece of code inside the
blog/views.py
file by adding it to the function
def post_list(request)

posts = Post.objects.filter(published_date__isnull=False).order_by('published_date')
Please note that we create a variable for our QuerySet:
posts
. Treat this as the name of our QuerySet. From now on we
can refer to it by this name.

The last missing part is passing the
In the
render
posts
QuerySet to the template (we will cover how to display it in a next chapter).
function we already have parameter with
request
(so everything we receive from the user via the Internet)
and a template file
'blog/post_list.html' . The
last parameter, which looks like this:
things for the template to use. We need to give them names (we will stick to
{'posts': posts}
So finally our
. Please note that the part before

blog/views.py
is wrapped with quotes
is a place in which we can add some
{}
'posts'
right now :)). It should look like this:
'' .
file should look like this:

posts = Post.objects.filter(published_date__isnull=False).order_by('published_date')
return render(request, 'blog/post_list.html', {'posts': posts})
That's it! Time to go back to our template and display this QuerySet!
If you want to read a little bit more about QuerySets in Django you should look here:
https://docs.djangoproject.com/en/1.7/ref/models/querysets/
Django templates
Time to display some data! Django gives us some helpful, built-in template tags for that.
What are template tags?

You see, in HTML, you can't really put Python code, because browsers don't understand it. They only know HTML. We
know that HTML is rather static, while Python is much more dynamic.
Django template tags allow us to transfer Python-like things into HTML, so you can build dynamic websites faster and
easier. Yikes!
Display post list template

In the previous chapter we gave our template a list of posts in the
posts
variable. Now we will display it in HTML.
To print a variable in Django template, we use double curly brackets with the variable's name inside, like this:
{{ posts }}
Try this in your

{{ posts }}
blog/templates/blog/post_list.html
template (replace everything between the second
<div></div>
tags with
line), save the file and refresh the page to see the results:
As you can see, all we've got is this:
[<Post: My second post>, <Post: My first post>]
This means that Django understands it as a list of objects. Remember from Introduction to Python how we can display
lists? Yes, with the for loops! In a Django template, you do them this way:
{% for post in posts %}

{{ post }}
{% endfor %}
Try this in your template.
It works! But we want them to be displayed like the static posts we created earlier in the Introduction to HTML chapter.
You can mix HTML and template tags. Our
body
will look like this:
<div>
<h1><a href="/">Django Girls Blog</a></h1>
</div>
<div>
<p>published: {{ post.published_date }}</p>
<h1><a href="">{{ post.title }}</a></h1>
<p>{{ post.text|linebreaks }}</p>
</div>
{% endfor %}
Everything you put between
{% for %}
and
{% endfor %}
will be repeated for each object in the list. Refresh your page:
Have you noticed that we used a slightly different notation this time
data in each of the fields defined in our
line-breaks into paragraphs.
One more thing
Post
model. Also the
{{ post.title }}
|linebreaks
or
{{ post.text }}
? We are accessing
is piping the posts' text through a filter to convert
It'd be good to see if your website will still be working on Heroku, right? Let's try deploying again. If you forgot how to do it,
check the end of chapter 15:
$ git
...
$ git
$ git
...
$ git
...
$ git
status
add -A .
status
commit -m "Used Django templates instead of static HTML."
push heroku master
Congrats! Now go ahead and try adding a new post in your Django admin (remember to add published_date!), then
refresh your page to see if the post appears there.
Works like a charm? We're proud! Treat yourself something sweet, you have earned it :)
CSS - make it pretty!

Our blog still looks pretty ugly, right? Time to make it nice! We will use CSS for that.
What is CSS?
Cascading Style Sheets (CSS) is a language used for describing the look and formatting of a website written in markup
language (like HTML). Treat it as make-up for our webpage ;).
But we don't want to start from scratch again, right? We will, once more, use something that has already been done by
programmers and released on the Internet for free. You know, reinventing the wheel is no fun.
Let's use Bootstrap!

Bootstrap is one of the most popular HTML and CSS frameworks for developing beautiful websites:
http://getbootstrap.com/
It was written by programmers who worked for Twitter and is now developed by volunteers from all over the world.
Install Boostrap
To install Bootstrap, you need to add this to your
<head>
in your
.html
file ( blog/templates/blog/post_list.html ):
<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">

<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css">
<script src="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/js/bootstrap.min.js"></script>
This doesn't add any files to your project. It just points to files that exist on the internet. Just go ahead, open your website
and refresh the page. Here it is!
Looking nicer already!
Static files in Django

Another thing you will learn about today is called static files. Static files are all your CSS and images -- files that are not
dynamic, so their content doesn't depend on request context and will be the same for every user.
CSS is a static file, so in order to customize CSS, we need to first configure static files in Django. You'll only need to do it
once. Let's start:
Configure static files in Django

First, we need to create a directory to store our static files in. Go ahead and create a directory called
djangogirls
static
inside your
directory.
djangogirls
static
manage.py
Open up the
mysite/settings.py
file, scroll to the bottom of it and add the following lines:
STATICFILES_DIRS = (
os.path.join(BASE_DIR, "static"),
)
This way Django will know where to find your static files.
Your first CSS file!

Let's create a CSS file now, to add your own style to your web-page. Create a new directory called
directory. Then create a new file called
blog.css
inside this
css
css
inside your
static
directory. Ready?
static
css
blog.css
Time to write some CSS! Open up the
static/css/blog.css
file in your code editor.
We won't be going too deep into customizing and learning about CSS here, because it's pretty easy and you can learn it
on your own after this workshop. We really recommend doing this Codeacademy HTML & CSS course to learn everything
you need to know about making your websites more pretty with CSS.
But let's do at least a little. Maybe we could change the color of our header? To understand colors, computers use special
codes. They start with
and are followed by 6 letters (A-F) and numbers (0-9). You can find color codes for example
here: http://www.colorpicker.com/. You may also use predefined colors, such as

In your
static/css/blog.css
red
and
green
file you should add the following code:
h1 a {
color: #FCA205;
}
h1 a
is a CSS Selector. This means we're applying our styles to any
have in code something like:
<h1><a href="">link</a></h1>
element inside of an
h1
element (e.g. when we
). In this case, we're telling it to change its color to
#FCA205
which is orange. Of course, you can put your own color here!
In a CSS file we determine styles for elements in the HTML file. The elements are identified by the element name (i.e.
h1
body ), the
attribute
class
or the attribute
id
. Class and id are names you give the element by yourself. Classes
define groups of elements, and ids point to specific elements. For example, the following tag may be identified by CSS
using the tag name
, the class
external_link
, or the id
link_to_wiki_page
<a href="http://en.wikipedia.org/wiki/Django" class="external_link" id="link_to_wiki_page">
Read about CSS Selectors in w3schools.

Then, we need to also tell our HTML template that we added some CSS. Open the
file
and add this line at the very beginning of it:
{% load staticfiles %}
We're just loading static files here :). Then, between the
<head>
and
</head>
, after the links to the Bootstrap CSS files
(the browser reads the files in the order they're given, so code in our file may override code in Bootstrap files), add this
line:
<link rel="stylesheet" href="{% static 'css/blog.css' %}">
We just told our template where our CSS file is located.

Your file should now look like this:
<html>
<head>
</head>
<body>
<div>
</div>
<div>
</div>
{% endfor %}
</body>
</html>
OK, save the file and refresh the site!
Nice work! Maybe we would also like to give our website a little air and increase the margin on the left side? Let's try this!
body {
padding-left: 15px;
}
Add this to your CSS, save the file and see how it works!
Maybe we can customize the font in our header? Paste this into your
<head>
in
file:
<link href="//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext" rel="stylesheet" type="text/css">
This line will import a font called Lobster from Google Fonts (https://www.google.com/fonts).
Now add the line
font-family: 'Lobster';
between the braces
and
h1 a {
color: #FCA205;
font-family: 'Lobster';
}
in the CSS file
) and refresh the page:
static/css/blog.css
inside the
h1 a
declaration block (the code
Great!
As mentioned above, CSS has a concept of classes, which basically allows you to name a part of the HTML code and
apply styles only to this part, not affecting others. It's super helpful if you have two divs, but they're doing something very
different (like your header and your post), so you don't want them to look the same.
Go ahead and name some parts of the HTML code. Add a class called
page-header
to your
div
that contains your
header, like this:
<div class="page-header">
</div>
And now add a class
post
to your
div
containing a blog post.
<div class="post">
</div>
We will now add declaration blocks to different selectors. Selectors starting with
relate to classes. There are many great
tutorials and explanations about CSS on the Web to help you understand the following code. For now, just copy and
paste it into your
mysite/static/css/blog.css
file:
.page-header {
background-color: #ff9400;
margin-top: 0;
padding: 20px 20px 20px 40px;
}
.page-header h1, .page-header h1 a, .page-header h1 a:visited, .page-header h1 a:active {
color: #ffffff;
font-size: 36pt;
text-decoration: none;
}
.content {
margin-left: 40px;
}
h1, h2, h3, h4 {
font-family: 'Lobster', cursive;
}
.date {
float: right;
color: #828282;
}
.save {
float: right;
}
.post-form textarea, .post-form input {
width: 100%;
}
.top-menu, .top-menu:hover, .top-menu:visited {
color: #ffffff;
float: right;
font-size: 26pt;
margin-right: 20px;
}
.post {
margin-bottom: 70px;
}
.post h1 a, .post h1 a:visited {
color: #000000;
}
Then surround the HTML code which displays the posts with declarations of classes. Replace this:

<div class="post">
</div>
{% endfor %}
in the
with this:
<div class="content container">

<div class="row">
<div class="col-md-8">
<div class="post">
<div class="date">
{{ post.published_date }}
</div>
</div>
{% endfor %}
</div>
</div>
</div>
Save those files and refresh your website.
Woohoo! Looks awesome, right? The code we just pasted is not really so hard to understand and you should be able to
understand most of it just by reading it.
Don't be afraid to tinker with this CSS a little bit and try to change some things. If you break something, don't worry, you
can always undo it!
Anyway, we really recommend taking this free online Codeacademy HTML & CSS course as some post-workshop
homework to learn everything you need to know about making your websites prettier with CSS.
Ready for the next chapter?! :)
Template extending
Another nice thing Django has for you is template extending. What does this mean? It means that you can use the same
parts of your HTML for different pages of your website.
This way you don't have to repeat yourself in every file, when you want to use the same information/layout. And if you
want to change something, you don't have to do it in every template, just once!
Create base template

A base template is the most basic template that you extend on every page of your website.
Let's create a
base.html
file in
blog/templates/blog/
blog
templates
blog
base.html
post_list.html
Then open it up and copy everything from
post_list.html
to
base.html
file, like this:
<html>
<head>
<link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
</head>
<body>
</div>
<div class="row">
<div class="post">
<div class="date">
</div>
</div>
{% endfor %}
</div>
</div>
</div>
</body>
</html>
Then in
base.html
, replace your whole
<body>
(everything between
<body>
and
</body>
) with this:
<body>
</div>
<div class="row">
{% block content %}
{% endblock %}
</div>
</div>
</div>
</body>
We basically replaced everything between
{% for post in posts %}{% endfor %}
with:
{% block content %}
{% endblock %}
What does it mean? You just created a

templates that extend
base.html
Now save it, and open your

body and then also delete
block
, which is a template tag that allows you to insert HTML in this block in other
. We will show you how to do this in a moment.
<div class="page-header"></div>
again. Delete everything else other than what's inside the
, so the file will look like this:

<div class="post">
<div class="date">
</div>
</div>
{% endfor %}
And now add this line to the beginning of the file:
{% extends 'blog/base.html' %}
It means that we're now extending the

line we just added) between
base.html
{% block content %}
template in
and
post_list.html
. Only one thing left: put everything (except the
{% endblock content %}
. Like this:
{% block content %}
<div class="post">
<div class="date">
</div>
</div>
{% endfor %}
That's it! Check if your website is still working properly :)

If you have an error
TemplateDoesNotExists
that says that there is no
blog/base.html
file and you have
runserver
running in the console, try to stop it (by pressing Ctrl+C - Control and C buttons together) and restart it by running a
command.
Extend your application

We've already completed all the different steps necessary for the creation of our website: we know how to write a model,
url, view and template. We also know how to make our website pretty.
Time to practice!
The first thing we need in our blog is, obviously, a page to display one post, right?
We already have a
Post
model, so we don't need to add anything to
models.py .
Create a link in the template

We will start with adding a link inside
file. So far it should look like:
{% block content %}
<div class="post">
<div class="date">
</div>
</div>
{% endfor %}
We want to have a link to a post detail page on the post's title. Let's change
into
a link:
<h1><a href="{% url 'blog.views.post_detail' pk=post.pk %}">{{ post.title }}</a></h1>
Time to explain the mysterious
{% url 'blog.views.post_detail' pk=post.pk %}
. As you might suspect, the
{% %}
notation
means that we are using Django template tags. This time we will use one that will create a URL for us!
blog.views.post_detail
(the directory
blog
),
is a path to a
views
post_detail
view we want to create. Please note:
is from the name of the
views.py
file and the last bit -
blog
is the name of our application
post_detail
- is the name of the view.
Now when we go to:
http://127.0.0.1:8000/
we will have an error (as expected, since we don't have a URL or a view for
post_detail
). It will look like this:
Let's create a URL in
for our
urls.py
post_detail
view!
URL: http://127.0.0.1:8000/post/1/
We want to create a URL to point Django to a view called
url(r'^post/(?P<pk>[0-9]+)/$', views.post_detail),
to the
post_detail
blog/urls.py
, that will show an entire blog post. Add the line
file. It should look like this:

from . import views
)
That one looks scary, but no worries - we will explain it for you:
it starts with
post/
again -- "the beginning"
only means that after the beginning, the URL should contain the word post and /. So far so good.
(?P<pk>[0-9]+)
- this part is trickier. It means that Django will take everything that you place here and transfer it to a
view as a variable called

and 9).
valid, but
/
[0-9]
also tells us that it can only be a number, not a letter (so everything between 0
http://127.0.0.1:8000/post/1234567890/
http://127.0.0.1:8000/post//
is not
is perfectly ok!
- then we need / again
- "the end"!
That means if you enter

view called
pk
pk
means that there needs to be one or more digits there. So something like
post_detail
is shortcut for
http://127.0.0.1:8000/post/5/
primary key . This
(remember: lowercase and

post_id
into your browser, Django will understand that you are looking for a
and transfer the information that
pk
equals
to that view.
name is often used in Django projects. But you can name your variable as you like
instead of whitespaces!). For example instead of
, so this bit would look like:
(?P<post_id>[0-9]+)
Ok! Let's refresh the page:
http://127.0.0.1:8000/
Boom! Yet another error! As expected!
(?P<pk>[0-9]+)
we could have variable
Do you remember what the next step is? Of course: adding a view!
post_detail view
This time our view is given an extra parameter
post_detail(request, pk):
pk
. Our view needs to catch it, right? So we will define our function as
def
. Note that we need to use exactly the same name as the one we specified in urls ( pk ). Omitting
this variable is incorrect and will result in an error!

Now, we want to get one and only one blog post. To do this we can use querysets like this:
Post.objects.get(pk=pk)
But this code has a problem. If there is no
Post
with given
primary key
( pk ) we will have a super ugly error!
We don't want that! But, of course, Django comes with something that will handle that for us:
get_object_or_404
there is no
page).
Post
with the given
pk
it will display much nicer page (called
Page Not Found 404
. In case
The good news is that you can actually create your own
Page not found
not super important right now, so we will skip it.

Ok, time to add a view to our
We should open
views.py
blog/views.py
file!
and add the following code:
from django.shortcuts import render, get_object_or_404
Near other
from
lines. And at the end of the file we will add our view:
def post_detail(request, pk):

post = get_object_or_404(Post, pk=pk)
return render(request, 'blog/post_detail.html', {'post': post})
Yes. It is time to refresh the page:
http://127.0.0.1:8000/
page and make it as pretty as you want. But it's
It worked! But what happens when you click a link in blog post title?
Oh no! Another error! But we already know how to deal with it, right? We need to add a template!
We will create a file in
It will look like this:
blog/templates/blog
called
post_detail.html
{% block content %}
<div class="date">
{% if post.published_date %}
{% endif %}
</div>
<h1>{{ post.title }}</h1>
{% endblock %}
Once again we are extending
base.html
. In the
content
block we want to display a post's published_date (if it exists), title
and text. But we should discuss some important things, right?

{% if ... %} ... {% endif %}
is a template tag we can use when we want to check something (remember
Introduction to Python chapter?). In this scenario we want to check if a post's

Ok, we can refresh our page and see if
Page not found
published_date
if ... else ..
from
is not empty.
is gone now.
Yay! It works!
One more thing: deploy time!

$ git
...
$ git
$ git
...
$ git
...
$ git
status
add -A .
status
commit -m "Added more views to the website."
push heroku master
And that should be it! Congrats :)
Django Forms
The final thing we want to do on our website is create a nice way to add and edit blog posts. Django's
is rather hard to customize and make pretty. With
forms
admin
is cool, but it
we will have absolute power over our interface - we can do
almost anything we can imagine!

The nice thing about Django forms is that we can either define one from scratch or create a
ModelForm
which will save
the result of the form to the model.

This is exactly what we want to do: we will create a form for our
Like every important part of Django, forms have their own file:
We need to create a file with this name in the
blog
Post
model.
forms.py .
directory.
blog
forms.py
Ok, let's open it and type the following code:
from django import forms

class PostForm(forms.ModelForm):
class Meta:
model = Post
fields = ('title', 'text',)
We need to import Django forms first ( from django import forms ) and, obviously, our
PostForm
Post
model ( from .models import Post ).
, as you probably suspect, is the name of our form. We need to tell Django, that this form is a
Django will do some magic for us) Next, we have
class Meta
forms.ModelForm
, where we tell Django which model should be used to create this form ( model = Post ).
should be the person who is currently logged in (you!) and
created_date
title
and
text
to be exposed -
should be automatically set when we
create a post (i.e in the code), right?

And that's it! All we need to do now is use the form in a view and display it in a template.
So once again we will create: a link to the page, a URL, a view and a template.
Link to a page with the form

It's time to open
(so
is responsible for that.
Finally, we can say which field(s) should end up in our form. In this scenario we want only
author
ModelForm
blog/templates/blog/base.html
. We will add a link in
div
named
page-header
<a href="{% url 'blog.views.post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
Note that we want to call our new view
post_new .
After adding the line, your html file should now look like this:
<html>
<head>
<link href='//fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext' rel='stylesheet' type='text/css'>
</head>
<body>
<a href="{% url 'blog.views.post_new' %}" class="top-menu"><span class="glyphicon glyphicon-plus"></span></a>
</div>
<div class="row">
{% block content %}
{% endblock %}
</div>
</div>
</div>
</body>
</html>
After saving and refreshing the page
http://127.0.0.1:8000
you will obviously see a familiar
NoReverseMatch
error, right?
URL
We open
blog/urls.py
and add a line:
url(r'^post/new/$', views.post_new, name='post_new'),
And the final code will look like this:

from . import views
url(r'^post/new/$', views.post_new, name='post_new'),
)
After refreshing the site, we see an
AttributeError
, since we don't have
post_new
view implemented. Let's add it right now.
post_new view
Time to open the
blog/views.py
file and add the following lines with the rest of the
from
rows:
from .forms import PostForm
and our view:
def post_new(request):
form = PostForm()
return render(request, 'blog/post_edit.html', {'form': form})
To create a new
Post
form, we need to call
PostForm()
and pass it to the template. We will go back to this view, but for
now, let's create quickly a template for the form.
Template
We need to create a file
post_edit.html
in the
blog/templates/blog
directory. To make a form work we need several things:
we have to display the form. We can do that for example with a simple
the line above needs to be wrapped with an HTML form tag:
we need a
Save
button. We do that with an HTML button:
and finally just after the opening
<form ...>
{{ form.as_p }}
<form method="POST">...</form>
<button type="submit">Save</button>
tag we need to add
{% csrf_token %}
. This is very important, since it
makes your forms secure! Django will complain if you forget about this bit if you try to save the form:
Ok, so let's see how the HTML in
post_edit.html
should look:
{% block content %}
<h1>New post</h1>
<form method="POST" class="post-form">{% csrf_token %}
{{ form.as_p }}
<button type="submit" class="save btn btn-default">Save</button>
</form>
{% endblock %}
Time to refresh! Yay! Your form is displayed!
But, wait a minute! When you type something in
title
and
text
fields and try to save it - what will happen?
Nothing! We are once again on the same page and our text is gone... and no new post is added. So what went wrong?
The answer is: nothing. We need to do a little bit more work in our view.
Saving the form

Open
blog/views.py
once again. Currently all we have in
post_new
view is:
form = PostForm()
When we submit the form, we are back in the same view, but this time we have some more data in
specifically in
request.POST . Remember
the fields from the form are now in

for
method
is
GET , but we
that in the HTML file our
request.POST . You
<form>
should not rename
request
definition had the variable

POST
, more
method="POST"
? All
to anything else (the only other valid value
have no time to explain what the difference is).
So in our view we have two separate situations to handle. First: when we access the page for the first time and we want a
blank form. Second: when we go back to the view with all form's data we just typed. So we need to add a condition (we
will use
if
for that).
if request.method == "POST":
[...]
else:
form = PostForm()
It's time to fill in the dots
[...]
. If
method
is
POST
then we want to construct the
PostForm
with data from the form, right? We
will do that with:
form = PostForm(request.POST)
Easy! Next thing is to check if the form is correct (all required fields are set and no incorrect values will be saved). We do
that with
form.is_valid()
We check if the form is valid and if so, we can save it!
if form.is_valid():
post = form.save(commit=False)
post.author = request.user
post.save()
Basically, we have two things here: we save the form with

field in the
PostForm
and this field is required!).
to add author first. Most of the time you will use

post.save()
form.save
commit=False
form.save()
and we add an author (since there was no
means that we don't want to save
, without
commit=False
Post
author
model yet - we want
, but in this case, we need to do that.
will preserve changes (adding author) and a new blog post is created!
Finally, it would be awesome if we can immediatelly go to
post_detail
page for newly created blog post, right? To do that
we need one more import:
from django.shortcuts import redirect
Add it at the very beginning of your file. And now we can say: go to
post_detail
page for a newly created post.
return redirect('blog.views.post_detail', pk=post.pk)
blog.views.post_detail
is the name of the view we want to go to. Remember that this view requires a
it to the views we use
pk=post.pk
, where
post
pk
variable? To pass
is the newly created blog post!
Ok, we talked a lot, but we probably want to see what the whole view looks like now, right?
form = PostForm(request.POST)
if form.is_valid():
post.save()
else:
form = PostForm()
Let's see if it works. Go to the page
http://127.0.0.1:8000/post/new/
post is added and we are redirected to
post_detail
, add a
title
and
text
, save it... and voil! The new blog
page!
You problably have noticed that we are not setting publish date at all. We will introduce a publish button in Django Girls
Tutorial: Extensions.
That is awesome!
Form validation
Now, we will show you how cool Django forms are. A blog post needs to have
did not say (as opposed to
published_date
title
and
text
fields. In our
Post
model we
) that these fields are not required, so Django, by default, expects them to be
set.
Try to save the form without
title
and
text
. Guess, what will happen!
Django is taking care of validating that all the fields in our form are correct. Isn't it awesome?
As we have recently used the Django admin interface the system currently thinks we are logged in. There are a few
situations that could lead to us being logged out (closing the browser, restarting the DB etc.). If you find that you are
getting errors creating a post referring to a lack of a logged in user, head to the admin page
http://127.0.0.1:8000/admin
and log in again. This will fix the issue temporarily. There is a permanent fix awaiting you
in the Homework: add security to your website! chapter after the main tutorial.
Edit form
Now we know how to add a new form. But what if we want to edit an existing one? It is very similar to what we just did.
Let's create some important things quickly (if you don't understand something, you should ask your coach or look at the
previous chapters, since we covered all these steps already).
Open
blog/templates/blog/post_detail.html
and add this line:
<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
so that the template will look like:
{% block content %}
<div class="date">
{% if post.published_date %}
{% endif %}
<a class="btn btn-default" href="{% url 'post_edit' pk=post.pk %}"><span class="glyphicon glyphicon-pencil"></span></a>
</div>
<h1>{{ post.title }}</h1>
{% endblock %}
In
blog/urls.py
we add this line:
url(r'^post/(?P<pk>[0-9]+)/edit/$', views.post_edit, name='post_edit'),
We will reuse the template

Let's open a
blog/views.py
blog/templates/blog/post_edit.html
, so the last missing thing is a view.
and add at the very end of the file:
def post_edit(request, pk):

post = get_object_or_404(Post, pk=pk)
form = PostForm(request.POST, instance=post)
if form.is_valid():
post.save()
else:
form = PostForm(instance=post)
This looks almost exactly the same as our
post_new
parameter from urls. Next: we get the
Post
model we want to edit with
view, right? But not entirely. First thing: we pass an extra
create a form we pass this post as an
instance
get_object_or_404(Post, pk=pk)
both when we save the form:
form = PostForm(request.POST, instance=post)
and when we just opened a form with this post to edit:
form = PostForm(instance=post)
Ok, let's test if it works! Let's go to
post_detail
pk
and then, when we
page. There should be an edit button in the top-right corner:
When you click it you will see the form with our blog post:
Feel free to change the title or the text and save changes!
Congratulations! Your application is getting more and more complete!
If you need more information about Django forms you should read the documentation:
https://docs.djangoproject.com/en/1.7/topics/forms/
One more thing: deploy time!

$ git
...
$ git
$ git
...
$ git
...
$ git
status
add -A .
status
commit -m "Added views to create/edit blog post inside the site."
push heroku master
And that should be it! Congrats :)
Domain
Heroku gave you a domain, but it's long, hard to remember, and ugly. It'd be awesome to have a domain name that is
short and easy to remember, right?
In this chapter we will teach you how to buy a domain and direct it to Heroku!
Where to register a domain?

A typical domain costs around $15 a year. There are cheaper and more expensive options, depending on the provider.
There are a lot of companies that you can buy a domain from: a simple google search will give hundreds of options.
Our favourite one is I want my name. They advertise as "painless domain management" and it really is painless.
How to register domain in IWantMyName?

Go to iwantmyname and type a domain you want to have in the search box.
You should now see a list of all available domains with the term you put in the search box. As you can see, a smiley face
indicates that the domain is available for you to buy, and a sad face that it is already taken.
We've decided to buy
djangogirls.in
Go to checkout. You should now sign up for iwantmyname if you don't have an account yet. After that, provide your credit
card info and buy a domain!
After that, click
DNS records
Domains
in the menu and choose your newly purchased domain. Then locate and click on the
manage
link:
Now you need to locate this form:
And fill it in with the following details:

Hostname: www
Type: CNAME
Value: your domain from Heroku (for example djangogirls.herokuapp.com)
TTL: 3600
Click the Add button and Save changes at the bottom.

It can take up to a couple of hours for your domain to start working, so be patient!
Configure domain in Heroku

You also need to tell Heroku that you want to use your custom domain.
Go to the Heroku Dashboard, login to your Heroku account and choose your app. Then go into app Settings and add
your domain in the
That's it!
Domains
section and save your changes.
What's next?
Congratulate yourself! You're totally awesome. We're proud! <3
What to do now?
Take a break and relax. You have just done something really huge.
After that make sure to:
Follow Django Girls on Facebook or Twitter to stay up to date
Can you recommend any further resources?

Yes! First, go ahead and try our other book, called Django Girls Tutorial: Extensions.
Later on, you can try recources listed below. They're all very recommended!
Django's official tutorial
New Coder tutorials
Code Academy Python course
Code Academy HTML & CSS course
Django Carrots tutorial
Learn Python The Hard Way book
Getting Started With Django video lessons
Two Scoops of Django: Best Practices for Django book

Djangogirls Tutorial

Uploaded by

Copyright:

Available Formats

Djangogirls Tutorial

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Djangogirls Tutorial

Uploaded by

Copyright:

Available Formats

Table of Contents

Django Girls Tutorial

What will you learn during the tutorial?

About and contributing

How the Internet works

Introduction to the command-line interface

What is the command line?

Open the command-line interface

, just like this:

sign, like this:

Your first command (YAY!)

Let's start with something simple. Type this command:

And then hit Enter. This is our result:

List files and directories

Change current directory

Check if it's really changed:

and then hit

button twice to get

> mkdir djangogirls

This little command will create a folder with the name

on your desktop. You can check if it's there just by

/ dir command! Try it :)

directory create a directory called

Now time to delete the

Attention: Deleting files using

very careful with this command.

is irrecoverable, meaning deleted files will be gone forever! So, be

> rmdir /S djangogirls

Done! To be sure it's actually deleted, let's check it:

close the window

Lets start with Python

sudo apt-get install python3.4

sudo yum install python3.4

double click Python.mpkg to run the installer.

and hit Enter.

Your first Python command!

commands in the Python language. You don't have to type in

. For us this means that for now we may only use

- Python will do that for you.

or use the shortcut

for Windows and

and hit Enter.

>>> "Hi there " + "Ola"

You can also multiply strings with a number:

>>> "Runnin' down the hill"

or escaping apostrophe with a backslash ( \ ):

>>> 'Runnin\' down the hill'

Nice, huh? To see your name in uppercase letters, simply type:

You just used the

function on your string! A function (like

) is a set of instructions that Python has to

perform on a given object ( "Ola" ) once you call it.

Wonder why sometimes you call functions with a

at the end of a string (like

) and sometimes you first call a

. That's why we're giving

and hit Enter:

It worked! We used the

function inside of the