Django中使用jinjia2模板引擎的方法

在Django中，有自带的模板引擎DjangoTemplates用来渲染模板，使用Django的模版语言，叫做DTL，Jinja2也是十分常见的模板渲染引擎，Django对Jinja2也提供了支持，那么如何将你的Django项目配置成使用Jinja2引擎呢？

安装Jinja2

首先，需要在当前环境中安装Jinja2： pip install jinja2 可以通过pip list查看当前python环境中安装的模块。

配置文件

Django的配置，一般是放在settings.py文件中，模板的配置也在此文件中，如果你是使用Django-admin startproject project_name来创建的项目的话，配置文件的默认路径为： ./project_name/project_name/settings.py 在配置文件中找到如下代码：

    TEMPLATES = [
    {
    'BACKEND': 'django.template.backends.django.DjangoTemplates',
    'DIRS': [],
    'APP_DIRS': True,
    'OPTIONS': {
    # ... some options here ...
    },
    },
    ]

 

• 字段解释
  • BACKEND： 即配置的后端模板引擎
  • DIRS：默认为空列表，引擎搜索模板文件的路径
  • APP_DIRS：默认为True（使用Django-admin startproject创建），表示引擎是否去已安装的app路径下去搜索模板文件。

这段代码即为Django默认生成的模板配置。所以，将引擎替换成Jinja2的第一步，就是修改这一段配置：

OPTIONS

    TEMPLATES = [
    {
    'BACKEND': 'django.template.backends.jinja2.Jinja2',
    'DIRS': [],
    'APP_DIRS': True,
    'OPTIONS': {
    # ... some options here ...
    },
    },
    ]

 

使用Jinja2时，需要在OPTIONS字段中，添加环境变量的路径，以使得模版API可以统一起来，你可以创建这样一个文件project_name/jinja2.py，内容如下：

from django.contrib.staticfiles.storage import staticfiles_storage
from django.urls import reverse      
from jinja2 import Environment
def environment(**options):
env = Environment(**options)
env.globals.update({
 'static': staticfiles_storage.url,
 'url': reverse,
 })
 return env

 

并且在options中添加如下代码：

    TEMPLATES = [
    {
    'BACKEND': 'django.template.backends.jinja2.Jinja2',
    'DIRS': [],
    'APP_DIRS': True,
    'OPTIONS': {
    # ... some options here ...
    ‘project_name.jinja2.environment’
    },
    },
    ]

 

至此，就可以在项目中愉快的使用Jinja2啦～