“加载”是什么意思？ 在 Django 模板中做什么？

Question

由于“load”对于搜索来说太通用了：

1. “load”的目的是什么？在这种特殊情况下它有什么作用？ - 在模板文件中，base_weblog.html，

   {% 加载博客 %}{% render_month_links %}

2. 是否使用了一些命名约定，以便“加载” 做好它的工作吗？ 例如文件夹和/或文件的名称和/或 类名？

3. “加载”的文档在哪里？您能详细说明吗？

---

详细信息：

该示例来自以下来源 http://www.djangoproject.com/ - 直接下载网址是 通过http://shrinkster.com/17g8。

部分文件夹结构（没有文件扩展名的项目是文件夹）：

django_website

  apps
    accounts
    aggregator
    blog
      urls.py
      models.py
        class Entry(models.Model)

      templatetags
        weblog.py
    contact
    docs

  templates
    base_weblog.html

    aggregator
    blog
      entry_archive.html
      entry_archive_year.html
      month_links_snippet.html
      entry_archive_month.html
      entry_detail.html
      entry_snippet.html
      entry_archive_day.html
    comments
    contact
    docs
    feeds
    flatfiles
    flatpages
    registration

Answer 1

load：

加载自定义模板标签集。

请参阅自定义标签和过滤器库 了解更多信息。

Answer 2

“load”之后的“weblog”（在模板文件 django_website/templates/base_weblog.html 中）引用文件夹 django_website/apps/blog/ 中的文件 weblog.py模板标签。 文件夹 templatetags 必须准确命名，并且必须包含名为 __init__.py 的文件（问题 2）。

“load”使自定义模板标签（在本例中为 render_latest_blog_entries 和 render_month_links）可在模板 django_website\templates\base_weblog.html 中使用在这种情况下。 “负载”是一个安全和性能功能。

Answer 3

加载标签可以加载内置 和 通过设置 load 标签中的文件来自定义 Django 模板标签和过滤器。

例如自定义 Django 模板标签和过滤器，在 core 文件夹中创建 templatetags 文件夹，其中包含 __init__.py（空文件）和 custom_tags.py，其中 settings.py如下所示，然后不要忘记重新启动服务器以将custom_tags.py应用到Django项目。 *其他名称对于 custom_tags.py 来说也可以，根据我的实验，custom_tags.py 可以在没有 __init__.py（空文件）的情况下工作，但基本上，最好按照 文档 说：

django-project
 |-core
 |  |-settings.py
 |  └-templatetags # Here
 |     |-__init__.py
 |     └-custom_tags.py
 |-templates
 |  └-index.html
 |-app1
 └-app2

并且，不要忘记将 core 设置为 settings.py 中的 >INSTALLED_APPS 将 custom_tags.py 应用到 Django 项目，如下所示。 *将core设置为INSTALLED_APPS也可以使用python manage.pycollectstatic将core文件夹中的静态文件收集到Django项目根文件夹中。 我建议在开始构建 Django 项目之前将 core 设置为 INSTALLED_APPS：

# "core/settings.py"

INSTALLED_APPS = [
    # ...
    'core', # Here
    'app1',
    'app2',
]

然后，创建 uppercase 和 lowercase 标签在 custom_tags.py 中，如下所示。 *您可以看到我的答案解释@register.simple_tag：

# "core/templatetags/custom_tags.py"

from django.template import Library

register = Library()

@register.simple_tag
def uppercase(arg):
    return arg.upper()

@register.filter
def lowercase(arg):
    return arg.lower()

然后，您需要通过在加载中省略.py来设置文件custom_tags标签使用 uppercase 和 lowercase 标签，如下所示：

# "templates/index.html"

{% load custom_tags %}

{% uppercase "Hello World" %} # HELLO WORLD
{{ "Hello World" | lowercase }} # hello world

并且，您还可以创建 app1 和 app2 等文件夹> templatetags 文件夹中包含 __init__.py（空文件）和 custom_tags.py，如下所示。 *其他名称适用于 app1 和 app2 文件夹，根据我的实验，custom_tags.py 位于 app1 和如果没有 __init__.py（空文件），app2 文件夹将无法工作，因此必须在 __init__.py（空文件）下创建>app1 和 app2 文件夹：

django-project
 |-core
 |  |-settings.py
 |  └-templatetags
 |     |-app1 # Here
 |     |  |-__init__.py
 |     |  └-custom_tags.py
 |     |-app2 # Here
 |     |  |-__init__.py
 |     |  └-custom_tags.py
 |     |-__init__.py
 |     └-custom_tags.py
 |-templates
 |  └-index.html
 |-app1
 └-app2

然后，您需要设置文件夹 app1 和 app2< 后面的文件 custom_tags /code> 在 load 标签中使用 app1/custom_tags.py 和 app2/custom_tags.py 中定义的标签，如下所示

# "templates/index.html"
                   #  ↓ ↓ Here ↓ ↓     ↓ ↓ Here ↓ ↓
{% load custom_tags app1.custom_tags app2.custom_tags %}

# ...

：如果多个文件中存在相同的 uppercase 标签，如下所示：

# "core/templatetags/custom_tags.py"

@register.simple_tag
def uppercase(arg):
    return arg.upper()

# "core/templatetags/app1/custom_tags.py"

@register.simple_tag
def uppercase(arg):
    return arg.upper() + " app1"

# "core/templatetags/app2/custom_tags.py"

@register.simple_tag
def uppercase(arg):
    return arg.upper() + " app2"

那么，load 标签中设置的最后一个文件的 uppercase 标签为 所示

# "templates/index.html"
                                    #  ↓ ↓ Here ↓ ↓
{% load custom_tags app1.custom_tags app2.custom_tags %}

{% uppercase "Hello World" %} # HELLO WORLD app2

最后，除了 core 文件夹之外，您还可以通过多个应用程序文件夹 app1 和 app2 创建多个 templatetags 文件夹，如下 如下图所示：

django-project
 |-core
 |  |-settings.py
 |  └-templatetags # Here
 |     |-__init__.py
 |     └-custom_tags.py
 |-templates
 |  └-index.html
 |-app1
 |  └-templatetags # Here
 |     |-__init__.py
 |     └-custom_tags.py
 └-app2
    └-templatetags # Here
       |-__init__.py
       └-custom_tags.py

不过，我建议在 core 文件夹中只创建一个 templatetags 文件夹，因为有以下 3 个原因：

1. 只管理一个 templatetags 文件夹更容易管理core 文件夹中的 code>templatetags 文件夹比通过多个应用文件夹管理多个 templatetags 文件夹要好。

2. 对于 Django Admin，没有用于创建 templatetags 文件夹的文件夹，因此 core 文件夹是 Django Admin 执行此操作的最合理位置。

第三个原因是因为通过多个 templatetags 文件夹，如果有多个同名文件，如 custom_tags.py 如下所示：

django-project
 |-core
 |  |-settings.py
 |  └-templatetags
 |     |-__init__.py
 |     └-custom_tags.py # Here
 |-templates
 |  └-index.html
 |-app1
 |  └-templatetags
 |     |-__init__.py
 |     └-custom_tags.py # Here
 └-app2
    └-templatetags # Here
       |-__init__.py
       └-custom_tags.py # Here

那么，Django 中只会加载一个文件模板，但根据我的实验，我不知道要加载哪个文件，如下所示：

# "templates/index.html"
                             
{% load custom_tags %} # I don't know which `custom_tags.py` is loaded.