不管是寫自定義標(biāo)簽還是過濾器，第一件要做的事是創(chuàng)建模板庫（Django能夠?qū)氲幕窘Y(jié)構(gòu)）。

創(chuàng)建一個模板庫分兩步走：

    第一，決定模板庫應(yīng)該放在哪個Django應(yīng)用下。 如果你通過 manage.py startapp 創(chuàng)建了一個應(yīng)用，你可以把它放在那里，或者你可以為模板庫單獨創(chuàng)建一個應(yīng)用。 我們更推薦使用后者，因為你的filter可能在后來的工程中有用。

    無論你采用何種方式，請確保把你的應(yīng)用添加到 INSTALLED_APPS 中。 我們稍后會解釋這一點。

    第二，在適當(dāng)?shù)腄jango應(yīng)用包里創(chuàng)建一個 templatetags 目錄。 這個目錄應(yīng)當(dāng)和 models.py 、 views.py 等處于同一層次。 例如：

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

    在 templatetags 中創(chuàng)建兩個空文件： 一個 __init__.py （告訴Python這是 一個包含了Python代碼的包）和一個用來存放你自定義的標(biāo)簽/過濾器定義的文件。 第二個文件的名字稍后將用來加載標(biāo)簽。 例如，如果你的自定義標(biāo)簽/過濾器在一個叫作 poll_extras.py 的文件中，你需要在模板中寫入如下內(nèi)容：

{% load poll_extras %}

    {% load %} 標(biāo)簽檢查 INSTALLED_APPS 中的設(shè)置，僅允許加載已安裝的Django應(yīng)用程序中的模板庫。 這是一個安全特性；它可以讓你在一臺電腦上部署很多的模板庫的代碼，而又不用把它們暴露給每一個Django安裝。

如果你寫了一個不和任何特定模型/視圖關(guān)聯(lián)的模板庫，那么得到一個僅包含 templatetags 包的Django應(yīng)用程序包是完全正常的。 對于在 templatetags 包中放置多少個模塊沒有做任何的限制。 需要了解的是：{%load%}語句是通過指定的Python模塊名而不是應(yīng)用名來加載標(biāo)簽/過濾器的。

一旦創(chuàng)建了Python模塊，你只需根據(jù)是要編寫過濾器還是標(biāo)簽來相應(yīng)的編寫一些Python代碼。

作為合法的標(biāo)簽庫，模塊需要包含一個名為register的模塊級變量。這個變量是template.Library的實例，是所有注冊標(biāo)簽和過濾器的數(shù)據(jù)結(jié)構(gòu)。 所以，請在你的模塊的頂部插入如下語句：

from django import template

register = template.Library()

注意

請閱讀Django默認(rèn)的過濾器和標(biāo)簽的源碼，那里有大量的例子。 他們分別為： django/template/defaultfilters.py 和 django/template/defaulttags.py 。django.contrib中的某些應(yīng)用程序也包含模板庫。

創(chuàng)建 register 變量后，你就可以使用它來創(chuàng)建模板的過濾器和標(biāo)簽了。

最新評論