详解Django中的TEMPLATES设置

TEMPLATES是Django 1.8的新特性，TEMPLATES是一个列表，包含所有在Django中使用的模板引擎的设置。列表中的每一项都是一个字典，包含某个引擎的选项。

以下是一个简单的设定，告诉Django模板引擎从已安装的应用程序（installed applications）的templates子目录中读取模板：

TEMPLATES = [
  {
    'BACKEND': 'django.template.backends.django.DjangoTemplates',
    'APP_DIRS': True,
  },
]

以下选项对所有引擎（backends）都可用。

BACKEND

默认：无定义

使用的模板引擎。内建的模板引擎有：

'django.template.backends.django.DjangoTemplates'
'django.template.backends.jinja2.Jinja2'

通过设置BACKEND为一个完整的（fully-qualified）路径（例如'mypackage.whatever.Backend'），你可以使用非Django自带的引擎。

NAME

该模板引擎的别名。它是一个标识符，让你在渲染时可以选择一个引擎。别名在所有配置好的模板引擎中必须是唯一的。

当未提供值时，默认是定义引擎类的模板名，也即是与BACKEND相邻的最后一部分。

例如如果引擎是'mypackage.whatever.Backend'，那么它的默认名为'whatever'。

DIRS

默认：[]（空列表）

引擎用于查找模板源文件的目录，按搜索顺序排列。

APP_DIRS

默认：False

引擎是否在已安装应用程序（的目录）内查找模板源文件。

OPTIONS

默认：{}（空字典）

传递给该模板引擎（backend）的其他参数。不同的引擎，可用的参数不一样。

TEMPLATE_CONTEXT_PROCESSORS

默认：

("django.contrib.auth.context_processors.auth",
"django.template.context_processors.debug",
"django.template.context_processors.i18n",
"django.template.context_processors.media",
"django.template.context_processors.static",
"django.template.context_processors.tz",
"django.contrib.messages.context_processors.messages")

TEMPLATE_DEBUG

默认：False

一个打开/关闭模板调试模式的布尔值。如果值是True，在模板渲染期间，抛出任何异常都将显示一个可爱的、详情报告的错误页面。该页面包含该模板相关的代码段，并且使用适当的行高亮。

注意如果DEBUG是True，Django只会显示可爱的错误页面。

TEMPLATE_DIRS

默认：()（空列表）

django.template.loaders.filesystem.Loader搜索模板源代码的路径列表，，按搜索顺序排列。

注意即使在Windows中，这些路径也是使用Unix风格的正斜杠。

TEMPLATE_LOADERS

默认：

('django.template.loaders.filesystem.Loader',
'django.template.loaders.app_directories.Loader')

模板读取器类的元组，用字符串指定。每个读取器类知道怎样从一个特定源（particular source）中导入模板。可选地，也可以使用一个元组来代替使用一个字符串。元组中的第一项应该是读取器的模块，随后的项是在初始化时传递给读取器。

TEMPLATE_STRING_IF_INVALID

默认：''（空字符串）

当使用了不可用的（比如说拼写错误）变量时模板系统输出的字符串。