- 模板加载的内幕
模板加载的内幕
一般说来,你会把模板以文件的方式存储在文件系统中,但是你也可以使用自定义的 template loaders 从其他来源加载模板。
Django有两种方法加载模板
django.template.loader.get_template(template_name)
:get_template
根据给定的模板名称返回一个已编译的模板(一个Template
对象)。 如果模板不存在,就触发TemplateDoesNotExist
的异常。django.template.loader.select_template(template_name_list)
:select_template
很像get_template
,不过它是以模板名称的列表作为参数的。 它会返回列表中存在的第一个模板。 如果模板都不存在,将会触发TemplateDoesNotExist
异常。
正如在第四章中所提到的,默认情况下这些函数使用 TEMPLATE_DIRS
的设置来载入模板。 但是,在内部这些函数可以指定一个模板加载器来完成这些繁重的任务。
一些加载器默认被禁用,但是你可以通过编辑 TEMPLATE_LOADERS
设置来激活它们。 TEMPLATE_LOADERS
应当是一个字符串的元组,其中每个字符串都表示一个模板加载器。 这些模板加载器随Django一起发布。
django.template.loaders.filesystem.load_template_source
: 这个加载器根据TEMPLATE_DIRS
的设置从文件系统加载模板。它默认是可用的。django.template.loaders.app_directories.load_template_source
: 这个加 载器从文件系统上的Django应用中加载模板。 对INSTALLED_APPS
中的每个应用,这个加载器会查找templates
子目录。 如果这个目录存在,Django就在那里寻找模板。这意味着你可以把模板和你的应用一起保存,从而使得Django应用更容易和默认模板一起发布。 例如,如果INSTALLED_APPS
包含('myproject.polls','myproject.music')
,那么get_template('foo.html')
会按这个顺序查找模板:-/path/to/myproject/polls/templates/foo.html
-/path/to/myproject/music/templates/foo.html
请注意加载器在首次被导入的时候会执行一个优化: 它会缓存一个列表,这个列表包含了INSTALLED_APPS
中带有templates
子目录的包。这个加载器默认启用。django.template.loaders.eggs.load_template_source
: 这个加载器类似app_directories
,只不过它从Python eggs而不是文件系统中加载模板。 这个加载器默认被禁用;如果你使用eggs来发布你的应用,那么你就需要启用它。 Python eggs可以将Python代码压缩到一个文件中。
Django按照 TEMPLATE_LOADERS
设置中的顺序使用模板加载器。 它逐个使用每个加载器直至找到一个匹配的模板。