Django 模板

Django 模板

之前都是用简单的 django.http.HttpResponse 来把内容展示到网页上,本节将讲解如何使用渲染的模板来显示内容。

  • 创建一个 tmpl 项目,和一个名称为 learn 的应用
django-admin startproject tmpl
python manage.py startapp learn
  • 把 learn 加入到 settings.INSTALLED_APPS 中
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'learn',
]
  • 编辑 learn/views.py
from django.shortcuts import render

def home(request):
    return render(request,'home.html')
  • 在 learn 目录下创建一个 templates 目录,新建一个 home.html

默认配置下,django 的模板系统会自动找到 app 下面的 templates 文件夹中的模板文件

<!DOCTYPE html>
<html>
<head>
    <title>欢迎光临</title>
</head>
<body>
欢迎光临
</body>
</html>
  • 修改 urls.py
from django.conf.urls import url
from django.contrib import admin
from learn import views as learn_views

urlpatterns = [
    url(r'^$',learn_views.home,name='home'),
    url(r'^admin/', admin.site.urls),
]

模板补充知识

网站模板的设计,一般的,我们做网站有一些通用的部分,比如导航,底部,访问统计代码等。

  • nav.html
  • bottom.html
  • tongji.html

可以写一个 base.html 来包含这些通用文件

<!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 ,可以重写部分代码

{% extends 'base.html' %}

{% block title %} 欢迎光临 {% endblock %}

{% block content %}
{% include 'ad.html' %}
这里是首页
{% endblock %}

注意:

模板一般放在 app 下的 templates 中,Django 会自动去这个文件夹中找。

但假如我们每个 apptemplates 中都有一个 index.html,当我们在 views.py 中使用的时候,直接写一个 render(request,'index,html')Django 能不能找到当前apptemplates 中的 index.html 呢?
答案是不一定能,可能会找错

Django 模板查找机制:

Django 查找模板的过程是在每个 apptemplates 文件夹中找(而不是只在当前 apptemplates 文件夹中找) 。各个 apptemplates 形成一个文件夹列表,Django 遍历这个列表,一个个文件进行查找,当某一个文件夹找到的时候就停止,所有都遍历完了还找不到指定的模板的时候就是 Template Not Found (过程类似 python 找包),这样设计有利也有弊,有利的是一个 app 可以用到另一个 app 的模板文件,弊是有可能找错了。所以我们使用的时候在 templates 中监理一个 app 同名的文件夹。

这就需要把每个 app 中的 templates 文件夹中再建一个 app 名称,仅和该 app 相关的模板放在 app/templates/app/ 目录下面。

例如:项目 zqxt 有两个 app ,分别为 tutorial 和 tryit、

zqxt
├── tutorial
│   ├── __init__.py
│   ├── admin.py
│   ├── models.py
│   ├── templates
│   │   └── tutorial # tutorial 特有
│   │       ├── index.html
│   │       └── search.html
│   ├── tests.py
│   └── views.py
├── tryit
│   ├── __init__.py
│   ├── admin.py
│   ├── models.py
│   ├── templates
│   │   └── tryit	# tryit 特有
│   │       ├── index.html
│   │       └── poll.html
│   ├── tests.py
│   └── views.py
├── manage.py
└── zqxt
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

这样,使用的时候,模板就是 tutorial/index.htmltryit/index.html ,不会混淆

posted @ 2017-04-21 18:18  Andy_Linux  阅读(177)  评论(0)    收藏  举报