Linux, OpenSource, Programming And Hacks

Oct 6, 2016

Simple Hello World page with django 1.9 in Ubuntu / Linux Mint [Beginners] [Part - 1]

Oct 6, 2016
Django is a web framework written in python. It is good for fast web application development. In this tutorial we will learn how to make a simple web page showing "Hello World" using django templates. we will also be applying styling to our page with css static files, we won't be dealing with any database or any advanced stuffs here.

This tutorial is aimed at beginners, So I 'll try to explain things in simple language without much technical detail.

First, you need to install  django, There are several ways to do so. The one I prefer and recommend is using virtual environment which allows us to separate our django project from the rest of our system, so that the software package version do not conflict with different projects

Install virtual environment.

we begin by installing pip 

sudo apt-get install python-pip

then using pip we install virtualenv

sudo pip install virtualenv

Create and Activate Virtual environment

Start a new virtual environment with the name myenv

aman@vostro:~$ virtualenv myenv
New python executable in /home/aman/myenv/bin/python
Installing setuptools, pip, wheel...done.

change directory into the virtual environment that you just created

aman@vostro:~$ cd myenv

Activate the virtual environment.

aman@vostro:~/myenv$ source bin/activate
(myenv) aman@vostro:~/myenv$

Notice, the name of the virtual environment inside the brackets shows that the virtual environment is activated.

Let's hit the ls command to see what inside it!

aman@vostro:/myenv$ ls
bin  include  lib  local  pip-selfcheck.json

you don't really need to understand these files :)

Install django in virtual environment

Now, we will Install django inside myenv

(myenv) aman@vostro:~/myenv$ pip install django==1.9
Collecting django==1.9
  Downloading Django-1.9-py2.py3-none-any.whl (6.6MB)
    100% |████████████████████████████████| 6.6MB 124kB/s 
Installing collected packages: django
Successfully installed django-1.9
(myenv) aman@vostro:~/myenv$

you can check if django was installed using pip freeze command

(myenv) aman@vostro:~/myenv$ pip freeze

Start our new Django Project

1. Now we will create our Django project named 'mywebpage'

(myenv) aman@vostro:~/myenv$ django-admin startproject mywebpage

and hit the ls command to see what myenv contains now.

(myenv) aman@vostro:~/myenv$ ls
bin  include  lib  local  mywebpage  pip-selfcheck.json
you can see that a new folder named mywebpage has been created

We will rename mywebpage to src, I will explain why we are doing it later!

(myenv) aman@vostro:~/myenv$ mv mywebpage/ src

Now lets cd into src and hit ls to see its contents

(myenv) aman@vostro:~/myenv$ cd src/
(myenv) aman@vostro:~/myenv/src$ ls  mywebpage
well, it contains a file called and another folder named mywebpage

So, we renamed the previous folder to src to avoid confusion.

Note: Always remember that src is the root of our project and our file is in it.

the is a python file which points to your settings files. don't worry if its not making sense now. It will later!!

go inside mywebpage folder

(myenv) aman@vostro:~/myenv/src$ cd mywebpage/
(myenv) aman@vostro:~/myenv/src/mywebpage$ ls

you can see 4 files: is a special file that tells that its parent directory is a module.
You don't really have to do anything with this file. holds all the apps, database settings. handles our requests and responses. - here we define our urls. for example for a url like we must put its pattern in our file.

you can open these files and just try to understand them.

if you didn't understand what these files do then you will in the next few steps :)

Run our server

and Now we will Run our Django Development server locally to test if everything was setup correctly.

To do so you need to be in the same directory where file is located
so change your directory to the previous one.

(myenv) aman@vostro:~/myenv/src/mywebpage$ cd ..
(myenv) aman@vostro:~/myenv/src$ 

and now enter this command to run our server

(myenv) aman@vostro:~/myenv/src$ python runserver
Performing system checks...

System check identified no issues (0 silenced).

You have unapplied migrations; your app may not work properly until they are applied.
Run 'python migrate' to apply them.

October 06, 2016 - 15:05:43
Django version 1.9, using settings 'mywebpage.settings'
Starting development server at
Quit the server with CONTROL-C.

Now just copy-paste the ip-address of the server in your browser and you should be able to see that your django server is up and running.

So, now let's proceed to our goal of creating a simple html page.

Create an App

An App is something that does a job. A project may have multiple apps. All of which specialize in doing their single jobs. The app that we will create has the job just of  showing 'Hello world'

Let's create the app named helloworld

make sure you're in the src directory!

(myenv) aman@vostro:~/myenv/src$ django-admin startapp helloworld
(myenv) aman@vostro:~/myenv/src$ ls
db.sqlite3  helloworld  mywebpage

this command has created a folder named helloworld containing 4 files
let's see those files  migrations

__init.py__ - This file indicates that your app is a python package. - your logic goes here. - for testing purposes. - this file holds your databases infos.

Don't worry if you don't understand these files :)

At this point I would say that you add your src folder to a text editor where you can easily manage all the project code. I would recommend sublime text or Atom text editor.

Now, we must add our newly created app to Installed Apps in like shown below using text editor of choice. 


In the next part of this tutorial we will deal with templates, views and urls to finally create our 'Hello world' page.

No comments:

Post a Comment