[Django模板系统]如何使用Django模板系统

注：以下内容转载自 现代魔法学院 网站的 如何使用Django模板系统 一文，仅供学习使用。

前面我们大概了解了下 Django 的模板系统，接下来，我们看看怎么去使用它。

我们先要明白它是如何工作的。我们暂不打算将它与先前创建的视图结合在一起，因为我们现在的目的是了解它是如何独立工作的。换言之，通常你会将模板和视图一起使用，但是我们只是想突出模板系统是一个 Python 库，你可以在任何地方使用它，而不仅仅是在 Django 视图中。

在 Python 代码中使用 Django 模板的最基本方式如下：

可以用原始的模板代码字符串创建一个 Template 对象， Django 同样支持用指定模板文件路径的方式来创建 Template 对象;

调用模板对象的 render 方法，并且传入一套变量 context。它将返回一个基于模板的展现字符串，模板中的变量和标签会被 context 值替换。

代码如下：

>>> from django import template
>>> t = template.Template('My name is {{ name }}.')
>>> c = template.Context({'name': 'Adrian'})
>>> print t.render(c)
My name is Adrian.
>>> c = template.Context({'name': 'Fred'})
>>> print t.render(c)
My name is Fred.

就这样，下面我们详细介绍上面这段代码的含义：

创建模板对象

创建一个 Template 对象最简单的方法就是直接实例化它。Template 类就在 django.template 模块中，构造函数接受一个参数，原始模板代码。让我们深入挖掘一下 Python的解释器看看它是怎么工作的。

转到 project 目录（由 django-admin.py startproject 命令创建），输入命令 python manage.py shell 启动交互界面。

如果你曾经使用过 Python，你一定好奇，为什么我们运行 python manage.py shell 而不是 python。

这两个命令都会启动交互解释器，但是 manage.py shell 命令有一个重要的不同：在启动解释器之前，它告诉 Django 使用哪个设置文件。Django 框架的大部分子系统，包括模板系统，都依赖于配置文件；如果 Django 不知道使用哪个配置文件，这些系统将不能工作。

如果你想知道，这里将向你解释它背后是如何工作的。Django 搜索 DJANGO_SETTINGS_MODULE 环境变量，它被设置在 settings.py中。例如，假设 mysite 在你的 Python 搜索路径中，那么 DJANGO_SETTINGS_MODULE 应该被设置为：‘mysite.settings’。

当你运行命令：python manage.py shell，它将自动帮你处理 DJANGO_SETTINGS_MODULE。在当前的这些示例中，我们鼓励你使用 “python manage.py shell” 这个方法，这样可以免去你大费周章地去配置那些你不熟悉的环境变量。

随着你越来越熟悉 Django，你可能会偏向于废弃使用 “manage.py shell”，而是在你的配置文件 .bash_profile 中手动添加 DJANGO_SETTINGS_MODULE 这个环境变量。如果你更喜欢 idle，可以试着自己配置。

让我们来了解一些模板系统的基本知识：

>>> from django.template import Template
>>> t = Template('My name is {{ name }}.')
>>> print t

如果你跟我们一起做，你将会看到下面的内容：

<django.template.Template object at 0xb7d5f24c>

0xb7d5f24c 每次都会不一样，这没什么关系；这只是Python运行时 Template 对象的 ID。

当你创建一个 Template 对象，模板系统在内部编译这个模板到内部格式，并做优化，做好渲染的准备。如果你的模板语法有错误，那么在调用 Template() 时就会抛出 TemplateSyntaxError 异常：

>>> from django.template import Template
>>> t = Template('{% notatag %}')
Traceback (most recent call last):
File "<stdin>", line 1, in ?
...
django.template.TemplateSyntaxError: Invalid block tag: 'notatag'

这里，块标签(block tag)指向的是”{% notatag %}“，块标签与模板标签是同义的。

系统会在下面的情形抛出 TemplateSyntaxError 异常：

无效的tags

标签的参数无效

无效的过滤器

过滤器的参数无效

无效的模板语法

未封闭的块标签 （针对需要封闭的块标签）

下一小节再介绍模板渲染。