Django基础，Day10 - template 模板引擎与路径设置

作为一个Web框架，Django需要一个方便的方式来生成动态的HTML。最常见的方法依赖于模板。模板包含所需的HTML输出的静态部分以及一些特殊的语法描述如何插入动态内容。

Django框架后端默认支持自生内置的一套模板系统DTL(Django Template Language) 和 有名的Jinja2模板系统。当然，也可以从第三方模块中之前其他模板系统。如果没有特殊要求，建议使用Django自带的DTL模板系统，这也是django 1.8之前唯一可以的内置选项。

TEMPLATE 默认配置

settings.py:

TEMPLATES = [
    {
        ‘BACKEND‘: ‘django.template.backends.django.DjangoTemplates‘,
        ‘DIRS‘: [os.path.join(BASE_DIR, ‘templates‘)],
        ‘APP_DIRS‘: True,
        ‘OPTIONS‘: {
            ‘context_processors‘: [
                ‘django.template.context_processors.debug‘,
                ‘django.template.context_processors.request‘,
                ‘django.contrib.auth.context_processors.auth‘,
                ‘django.contrib.messages.context_processors.messages‘,
            ],
        },
    },
]

BACKEND:模板引擎类的python路径，内置的模板引擎分别有‘django.template.backends.django.DjangoTemplates‘和‘django.template.backends.jinja2.Jinja2‘

DIRS:模板引擎搜索模板的路径，如上，默认搜索project目录下的templates目录


APP_DIRS:告诉模板引擎是否搜索app目录下的templates目录。默认为true，即是默认搜索app目录下的templates目录

实例说明

根据前面章节的实例，可见我们使用了默认的TEMPLATE设置，html页面直接存放在app目录下的template目录下，如 polls/templates/polls/index.html.

在view.index 中直接使用

return render(request, ‘polls/index.html‘, context)

即可渲染到polls/index.html 页面。

如果设置为 ‘APP_DIRS‘: False,则会搜索模板失败，如：

根据错误信息，可见模板引擎搜索模板的路径在project下的templates中。如果将index.html 移动到mysite\templates\polls\index.html 中即可访问。

若以上 ‘APP_DIRS‘: True,且同时存在

mysite\templates\polls\index.html

mysite\polls\templates\polls\index.html

则会访问 mysite\templates\polls\index.html 而不是 mysite\polls\templates\polls\index.html

多模板引擎设置

Django项目可以配置一个或多个模板引擎（甚至是零，如果你不使用模板）。

TEMPLATES = [
    {
        ‘BACKEND‘: ‘django.template.backends.django.DjangoTemplates‘,
        ‘DIRS‘: [
            ‘/home/html/example.com‘,
            ‘/home/html/default‘,
        ],
    },
    {
        ‘BACKEND‘: ‘django.template.backends.jinja2.Jinja2‘,
        ‘DIRS‘: [
            ‘/home/html/jinja2‘,
        ],
    },
]

If you call get_template(‘story_detail.html‘), here are the files Django will look for, in order:

• /home/html/example.com/story_detail.html (‘django‘ engine)
• /home/html/default/story_detail.html (‘django‘ engine)
• /home/html/jinja2/story_detail.html (‘jinja2‘ engine)

If you call select_template([‘story_253_detail.html‘, ‘story_detail.html‘]), here’s what Django will look for:

• /home/html/example.com/story_253_detail.html (‘django‘ engine)
• /home/html/default/story_253_detail.html (‘django‘ engine)
• /home/html/jinja2/story_253_detail.html (‘jinja2‘ engine)
• /home/html/example.com/story_detail.html (‘django‘ engine)
• /home/html/default/story_detail.html (‘django‘ engine)
• /home/html/jinja2/story_detail.html (‘jinja2‘ engine)

When Django finds a template that exists, it stops looking.