从项目的模板目录覆盖¶

首先，我们将探索通过在项目的模板目录中创建替换模板来覆盖模板。

假设您正在尝试覆盖名为blog的第三方应用程序的模板，该应用程序提供模板blog/post.html和blog/list.html。您项目的相关设置如下所示

from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

INSTALLED_APPS = [
    ...,
    "blog",
    ...,
]

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [BASE_DIR / "templates"],
        "APP_DIRS": True,
        # ...
    },
]

如果您使用默认项目模板创建了项目，则TEMPLATES设置和BASE_DIR将已存在。需要修改的设置是DIRS。

这些设置假设您的项目根目录下有一个templates目录。要覆盖blog应用程序的模板，请在templates目录中创建一个文件夹，并将模板文件添加到该文件夹

templates/
    blog/
        list.html
        post.html

模板加载器首先在DIRS目录中查找模板。blog应用程序中的视图请求blog/post.html和blog/list.html模板时，加载器将返回您刚刚创建的文件。

从应用程序的模板目录覆盖¶

由于您正在覆盖位于项目应用程序外部的模板，因此更常见的方法是使用第一种方法并将模板覆盖放在项目的模板文件夹中。但是，如果您愿意，也可以将覆盖放在应用程序的模板目录中。

首先，确保您的模板设置正在检查应用程序目录内部

TEMPLATES = [
    {
        # ...
        "APP_DIRS": True,
        # ...
    },
]

如果您想将模板覆盖放在名为myapp的应用程序中，并且要覆盖的模板名为blog/list.html和blog/post.html，则您的目录结构将如下所示

myapp/
    templates/
        blog/
            list.html
            post.html

将APP_DIRS设置为True后，模板加载器将在应用程序的模板目录中查找并找到模板。

扩展被覆盖的模板¶

配置好模板加载器后，您可以使用{% extends %}模板标签扩展模板，同时覆盖它。这可以让您进行小的自定义，而无需重新实现整个模板。

例如，您可以使用此技术将自定义徽标添加到admin/base_site.html模板

 {% extends "admin/base_site.html" %}

 {% block branding %}
   <img src="link/to/logo.png" alt="logo">
   {{ block.super }}
 {% endblock %}

需要注意的关键点

• 此示例在templates/admin/base_site.html处创建一个文件，该文件使用配置的项目级templates目录覆盖admin/base_site.html。

• 新模板扩展了admin/base_site.html，它与正在被覆盖的模板相同。

• 该模板只替换了branding块，添加了自定义徽标，并使用block.super保留了之前的內容。

• 其余模板从admin/base_site.html继承而未更改。

此技术有效是因为模板加载器在解析extends标签时不考虑已加载的覆盖模板（位于templates/admin/base_site.html）。结合block.super，它是一种进行小规模自定义的强大技术。