详解在Python的Django框架中创建模板库的方法

无论是开发自定义标签还是过滤器，首要任务是构建Django能够识别并导入的基本模板库结构。

构建模板库主要包含两个关键步骤：

首先，确定模板库所属的Django应用。若已通过 manage.py startapp 命令创建了应用，可直接将模板库置于该应用下；也可选择为模板库单独创建一个应用。推荐采用后一种方式，因为此类过滤器或标签可能在未来的项目中复用。

无论采取哪种方式，务必确保将该应用添加到 INSTALLED_APPS 配置中，具体原因将在后续说明。

其次，在对应的Django应用包内创建 templatetags 目录。该目录应与 models.py、views.py 等文件处于同一层级。例如：

books/
  __init__.py
  models.py
  templatetags/
  views.py

在 templatetags 目录下创建两个空文件：一个是 __init__.py（标识该目录为包含Python代码的包），另一个用于存放自定义标签或过滤器的定义文件。第二个文件的名称将在后续加载标签时使用。例如，若自定义标签/过滤器定义在名为 poll_extras.py 的文件中，需在模板中使用如下语句：

{% load poll_extras %}

{% load %} 标签会检查 INSTALLED_APPS 中的配置，仅允许加载已安装Django应用中的模板库。这是一种安全机制，允许在一台计算机上部署多个模板库代码，而无需向所有Django安装暴露这些代码。

如果编写的模板库不与任何特定模型或视图关联，创建一个仅包含 templatetags 包的Django应用程序包是完全合理的。templatetags 包中可放置任意数量的模块。需要注意的是，{%load%} 语句是通过指定的Python模块名（而非应用名）来加载标签或过滤器的。

创建Python模块后，只需根据目标是编写过滤器还是标签，编写相应的Python代码即可。

作为合法的标签库，模块必须包含一个名为 register 的模块级变量。该变量是 template.Library 的实例，用于存储所有注册的标签和过滤器数据结构。因此，请在模块顶部插入以下语句：

from django import template

register = template.Library()

注意

建议阅读Django默认过滤器和标签的源代码，其中包含大量示例。相关文件分别为：django/template/defaultfilters.py 和 django/template/defaulttags.py。此外，django.contrib 中的某些应用程序也包含模板库。

创建 register 变量后，即可利用它来创建模板的过滤器和标签。