在前面的几节中我们都是使用简单的 django.http.HttpResponse 来把内容显示到网页上来的,本节中将讲解如何使用渲染模板的方法来显示内容
本节的代码使基于Django 2.0,但Django 1.4-Django 1.11的操作流程也是一样的
后文中给出的示例代码可以在Django1.4.x 到 Django 1.11.x上运行
1.创建一个zqxt_tmpl项目,和一个名称为learn的应用,并且
django-admin.py startproject zqxt_tmpl
cd zqxt_tmpl
python manage.py startapp learn
2.把learn加入到settings.INSTALLED_APPS中
INSTALLED_APPS=(
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'learn',
)
3.打开 learn/views.py写一个首页的视图
from django.shortcuts import render
def home(request):
return render(request,'home.html')
4.在 learn目录下新建一个templates文件夹,里面新建一个home.html
默认配置下,Django的模板系统会自动找到app下面的templates文件夹中的模板文件
目录的结构是这样的:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
zqxt_tmpl
├── learn
│ ├── __init__.py
│ ├── admin.py
│ ├── migrations
│ │ └── __init__.py
│ ├── models.py
│ ├── templates
│ │ └── home.html
│ ├── tests.py
│ └── views.py
├── manage.py
└── zqxt_tmpl
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
4 directories, 12 files
|
5.在home.html中写入一些内容
<html>
<head><tite></title></head>
<body></body>
</html>
6.将视图函数对应到网址,更改zqxt_tmpl/url.py
Django 1.7.x 及以下可以这样:
1
2
3
4
5
6
7
8
9
10
|
from
django.conf.urls
import
include, url
from
django.contrib
import
admin
urlpatterns
=
[
url(r
'^$'
,
'learn.views.home'
, name
=
'home'
),
# new
# url(r'^blog/', include('blog.urls')),
#
url(r
'^admin/'
, include(admin.site.urls)),
]
|
Django 1.8.x 及以上:
1
2
3
4
5
6
7
8
9
|
from
django.conf.urls
import
include, url
from
django.contrib
import
admin
from
learn
import
views as learn_views
urlpatterns
=
[
url(r
'^$'
, learn_views.home, name
=
'home'
),
#
url(r
'^admin/'
, include(admin.site.urls)),
]
|
7.创建数据库表
python manage.py syncdb
#Django 1.7以及以上要用
python manage.py migrate
创建数据库虽然本节中不会用到,但是可以让一些提示消失
8.运行开发服务器,查看效果
python manage.py runserver
模板补充知识:
网站模板的设计,一般的,我们做网站有一些通用的部分,比如 导航,底部,访问统计代码等等
nav.html, bottom.html, tongji.html
可以写一个 base.html 来包含这些通用文件(include)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
<!DOCTYPE html>
<
html
>
<
head
>
<
title
>{% block title %}默认标题{% endblock %} - 自强学堂</
title
>
</
head
>
<
body
>
{% include 'nav.html' %}
{% block content %}
<
div
>这里是默认内容,所有继承自这个模板的,如果不覆盖就显示这里的默认内容。</
div
>
{% endblock %}
{% include 'bottom.html' %}
{% include 'tongji.html' %}
</
body
>
</
html
>
|
如果需要,写足够多的 block 以便继承的模板可以重写该部分,include 是包含其它文件的内容,就是把一些网页共用的部分拿出来,重复利用,改动的时候也方便一些,还可以把广告代码放在一个单独的html中,改动也方便一些,在用到的地方include进去。其它的页面继承自 base.html 就好了,继承后的模板也可以在 block 块中 include 其它的模板文件。
比如我们的首页 home.html,继承或者说扩展(extends)原来的 base.html,可以简单这样写,重写部分代码(默认值的那一部分不用改)
1
2
3
4
5
6
7
8
|
{% extends 'base.html' %}
{% block title %}欢迎光临首页{% endblock %}
{% block content %}
{% include 'ad.html' %}
这里是首页,欢迎光临
{% endblock %}
|
注意:模板一般放在app下的templates中,Django会自动去这个文件夹中找。但 假如我们每个app的templates中都有一个 index.html,当我们在views.py中使用的时候,直接写一个 render(request, 'index.html'),Django 能不能找到当前 app 的 templates 文件夹中的 index.html 文件夹呢?(答案是不一定能,有可能找错)
Django 模板查找机制: Django 查找模板的过程是在每个 app 的 templates 文件夹中找(而不只是当前 app 中的代码只在当前的 app 的 templates 文件夹中找)。各个 app 的 templates 形成一个文件夹列表,Django 遍历这个列表,一个个文件夹进行查找,当在某一个文件夹找到的时候就停止,所有的都遍历完了还找不到指定的模板的时候就是 Template Not Found (过程类似于Python找包)。这样设计有利当然也有弊,有利是的地方是一个app可以用另一个app的模板文件,弊是有可能会找错了。所以我们使用的时候在 templates 中建立一个 app 同名的文件夹,这样就好了。