Django 入门：搭建博客雏形

本文中的操作环境：

Ubuntu 14.04.1
Python 2.7
Django 1.8.5

创建项目

django-admin.py startproject mysite

工程目录结构：

└─ mysite
    ├── manage.py
    └── mysite
        ├── __init__.py
        ├── settings.py
        ├── urls.py
        └── wsgi.py

manage.py ----- Django项目里面的工具，通过它可以调用django shell和数据库等。
settings.py ----- 包含了项目的默认设置，包括数据库信息，调试标志以及其他一些工作的变量。
urls.py ----- 负责把URL模式映射到应用程序。

初始化后台数据库

python 自带SQLite数据库，Django支持各种主流的数据库，这里为了方便推荐使用SQLite，如果使用其它数据库请在settings.py文件中设置。

切换到mysite创建数据库：

root@ubuntu:~/django/mysite$ python manage.py migrate
Operations to perform:
  Synchronize unmigrated apps: staticfiles, messages
  Apply all migrations: admin, contenttypes, auth, sessions
Synchronizing apps without migrations:
  Creating tables...
    Running deferred SQL...
  Installing custom SQL...
Running migrations:
  Rendering model states... DONE
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying sessions.0001_initial... OK

创建完成后，项目根目录会生成db.sqlite3文件

设置admin应用

admin 是Django 自带的一个后台管理系统。

1. 创建admin帐号

root@ubuntu:~/django/mysite$ python manage.py createsuperuser
Username (leave blank to use 'root'): admin
Email address: admin@admin.com
Password:
Password (again):
Superuser created successfully.

python 1.7开始引入了migrate模块替换了之前的syncdb功能，此外用户创建也需要独立操作

2. 在我们创建django项目时，admin就已经创建，打开mysite/mysite/urls.py文件：

from django.conf.urls import include, url
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', include(admin.site.urls)),
]

3. 启动django容器

root@ubuntu:~/django/mysite$ python manage.py runserver 0.0.0.0:8000
Performing system checks...

System check identified no issues (0 silenced).
October 20, 2015 - 10:41:02
Django version 1.8.5, using settings 'mysite.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

4. 访问后台应用
   http://127.0.0.1:8000/admin
   输入第一步创建的用户名和密码，即可登录网站后台

创建blog应用

在mysite目录下创建blog应用

cd mysite
python manage.py startapp blog

目录结构：

blog
├── admin.py
├── __init__.py
├── migrations
│    └── __init__.py
├── models.py
├── tests.py
└── views.py

添加blog应用，打开mysite/mysite/settings.py文件：

# Application definition

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',
)

在列表末尾，添加blog 应用

为blog应用设计Model(数据库表)

blog目录下的models.py文件，是定义blog数据结构的地方

1. 设计model
   打开mysite/blog/models.py 文件进行修改：

from django.db import models
from django.contrib import admin

# Create your models here.
class BlogsPost(models.Model):
    title = models.CharField(max_length = 150)
    body = models.TextField()
    timestamp = models.DateTimeField()

admin.site.register(BlogsPost)

2. 再次初始化数据库

root@ubuntu:~/django/mysite$ python manage.py makemigrations blog
Migrations for 'blog':
  0001_initial.py:
    - Create model BlogsPost
root@ubuntu:~/django/mysite$ python manage.py migrate
Operations to perform:
  Synchronize unmigrated apps: staticfiles, messages
  Apply all migrations: admin, blog, contenttypes, auth, sessions
Synchronizing apps without migrations:
  Creating tables...
    Running deferred SQL...
  Installing custom SQL...
Running migrations:
  Rendering model states... DONE
  Applying blog.0001_initial... OK

3. 再次runserver启动服务，访问admin后台，创建文章
   登陆成功后会发现多出了blog一栏

选择Add

输入博客标题，正文、日期时间、点击Save创建博客

设置admin 的BlogsPost界面

打开mysite/blog/models.py文件，做如下修改：

from django.db import models
from django.contrib import admin

class BlogsPost(models.Model):
    title = models.CharField(max_length = 150)
    body = models.TextField()
    timestamp = models.DateField()

class BlogsPostAdmin(admin.ModelAdmin):
    list_display = ('title','timestamp')

admin.site.register(BlogsPost,BlogsPostAdmin)

创建BlogPostAdmin类，继承admin.ModelAdmin父类，以列表的形式显示BlogPost的标题和时间
刷新后页面产生变化

创建blog的公共部分

从Django的角度看，一个页面具有三个典型的组件：

• 一个模板（template）：模板负责把传递进来的信息显示出来
• 一个视图（view）：视图负责从数据库获取需要显示的信息
• 一个URL模式：它负责把收到的请求和你的试图函数匹配，有时候也会向视图传递一些参数

创建模板

在blog项目下创建templates目录（mysite/blog/templates/）,在目录下创建模板文件index.html，内容如下：

{% for blog in blog_list %}
    <h2>{{ blog.title }}</h2>
    <p>{{ blog.timestamp }}</p>
    <p>{{ blog.body }}</p>
{% endfor %}

创建视图函数

打开mysite/blog/views.py文件：

#coding=utf-8
from django.shortcuts import render
from blog.models import BlogsPost
from django.shortcuts import render_to_response

def index(request):
    blog_list = BlogsPost.objects.all()
    return render_to_response('index.html',{'blog_list':blog_list})

blog_list = BlogPost.objects.all() ：获取数据库里面所拥有BlogPost对象
render_to_response()返回一个页面(index.html)，顺带把数据库中查询出来的所有博客内容（blog_list）也一并返回

创建blog的URL模式

在mysite/mysite/urls.py文件里添加blog的url：

#coding=utf-8

from django.conf.urls import patterns, include, url
from django.contrib import admin

urlpatterns = patterns('',
    url(r'^admin/', include(admin.site.urls)),
    url(r'^index/$', 'blog.views.index'),

)

再次runserver启动服务，访问blog应用
http://127.0.0.1:8000/index

页面如下：

此时可以继续到admin后台添加blog，刷新这个页面来显示新添加的blog

添加样式及美化blog

创建基础模板

在mysite/blog/templates目录里创建base.html的模板：

<html>
    <head>
        <style type="text/css">
            body{color:#efd;background:#453;padding:0 5em;margin:0}
            h1{padding:2em 1em;background:#675}
            h2{color:#bf8;border-top:1px dotted #fff;margin-top:2em}
            p{margin:1em 0}
        </style>
    </head>

    <body>
        <h1>Django Blog</h1>
        <h3>Blog Title</h3>
        {% block content %}
        {% endblock %}
    </body>
</html>

修改主页模板

修改index.html模板，让它引用base.html模板和它的content块

{% extends "base.html" %}
{% block content %}
{% for blog in blog_list %}
    <h2>{{ blog.title }}</h2>
    <p>{{ blog.timestamp }}</p>
    <p>{{ blog.body }}</p>
{% endfor %}
{% endblock %}

再次刷新博客页面：

附录：简单Django项目

此项目涉及简单的增删改查，可以做进阶入门使用

Github : DjangoTest