TEMPLATES

Django 1.8的新特性
一個(gè)列表，包含所有在Django中使用的模板引擎的設(shè)置。列表中的每一項(xiàng)都是一個(gè)字典，包含某個(gè)引擎的選項(xiàng)。

以下是一個(gè)簡(jiǎn)單的設(shè)定，告訴Django模板引擎從已安裝的應(yīng)用程序（installed applications）的templates子目錄中讀取模板：

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


          

以下選項(xiàng)對(duì)所有引擎（backends）都可用。
BACKEND

默認(rèn)：無(wú)定義
使用的模板引擎。內(nèi)建的模板引擎有：

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


          

通過(guò)設(shè)置BACKEND為一個(gè)完整的（fully-qualified）路徑（例如'mypackage.whatever.Backend'），你可以使用非Django自帶的引擎。
NAME

默認(rèn)：看下面
該模板引擎的別名。它是一個(gè)標(biāo)識(shí)符，讓你在渲染時(shí)可以選擇一個(gè)引擎。別名在所有配置好的模板引擎中必須是唯一的。
當(dāng)未提供值時(shí)，默認(rèn)是定義引擎類的模板名，也即是與BACKEND相鄰的最后一部分。
例如如果引擎是'mypackage.whatever.Backend'，那么它的默認(rèn)名為'whatever'。
DIRS

默認(rèn)：[]（空列表）
引擎用于查找模板源文件的目錄，按搜索順序排列。
APP_DIRS

默認(rèn)：False
引擎是否在已安裝應(yīng)用程序（的目錄）內(nèi)查找模板源文件。
OPTIONS

默認(rèn)：{}（空字典）
傳遞給該模板引擎（backend）的其他參數(shù)。不同的引擎，可用的參數(shù)不一樣。
TEMPLATE_CONTEXT_PROCESSORS

默認(rèn)：

            
("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")

          

??? 自1.8版本起，不贊成使用：
??? 在一個(gè)DjangoTemplates引擎中的OPTIONS設(shè)置'context_processors'選項(xiàng)來(lái)代替。

用于填充在RequestContext中的上下文的調(diào)用函數(shù)（callables）的元組。這些函數(shù)獲取一個(gè)request對(duì)象作為它的參數(shù)，返回一個(gè)將要填充至上下文項(xiàng)目的字典。

• ??? Django 1.8的變化：
• ??? 在Django 1.8中，內(nèi)建模板的上下文處理器從django.core.context_processors移至django.template.context_processors。

TEMPLATE_DEBUG

默認(rèn)：False

• ??? 自1.8版本起，不贊成使用：
• ??? 在一個(gè)DjangoTemplates引擎中的OPTIONS設(shè)置'debug' 選項(xiàng)來(lái)代替。

一個(gè)打開(kāi)/關(guān)閉模板調(diào)試模式的布爾值。如果值是True，在模板渲染期間，拋出任何異常都將顯示一個(gè)可愛(ài)的、詳情報(bào)告的錯(cuò)誤頁(yè)面。該頁(yè)面包含該模板相關(guān)的代碼段，并且使用適當(dāng)?shù)男懈吡痢?
注意如果DEBUG是True，Django只會(huì)顯示可愛(ài)的錯(cuò)誤頁(yè)面。
參見(jiàn) DEBUG。
TEMPLATE_DIRS

默認(rèn)：()（空列表）

• ??? 自1.8版本起，不贊成使用：
• ??? 在一個(gè)DjangoTemplates引擎中設(shè)置'DIRS'選項(xiàng)來(lái)代替。

django.template.loaders.filesystem.Loader搜索模板源代碼的路徑列表，，按搜索順序排列。
注意即使在Windows中，這些路徑也是使用Unix風(fēng)格的正斜杠。
參見(jiàn) The Django template language 。
TEMPLATE_LOADERS

默認(rèn)：

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

          

• ??? 自1.8版本起，不贊成使用：
• ??? 在一個(gè)DjangoTemplates引擎中的OPTIONS設(shè)置'loader'選項(xiàng)來(lái)代替。

模板讀取器類的元組，用字符串指定。每個(gè)讀取器類知道怎樣從一個(gè)特定源（particular source）中導(dǎo)入模板。可選地，也可以使用一個(gè)元組來(lái)代替使用一個(gè)字符串。元組中的第一項(xiàng)應(yīng)該是讀取器的模塊，隨后的項(xiàng)是在初始化時(shí)傳遞給讀取器。參見(jiàn) The Django template language: for Python programmers。
TEMPLATE_STRING_IF_INVALID

默認(rèn)：''（空字符串）

• ??? 自1.8版本起，不贊成使用：
• ??? 在一個(gè)DjangoTemplates引擎中的OPTIONS設(shè)置'string_if_invalid' 選項(xiàng)來(lái)代替。

當(dāng)使用了不可用的（比如說(shuō)拼寫錯(cuò)誤）變量時(shí)模板系統(tǒng)輸出的字符串。參見(jiàn) How invalid variables are handled。

???