Поддержка шаблонов Jinja2

Настройка Django

Для поддержки шаблонов Jinja2 необходимо настроить Django. Поскольку администрирование Wagtail написано с использованием стандартных шаблонов Django, Django необходимо настроить для использования обоих движков шаблонов. Добавьте конфигурацию бэкэнда шаблонов Jinja2 в настройку TEMPLATES для вашего приложения, как показано здесь:

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        # ... the rest of the existing Django template configuration ...
    },
    {
        'BACKEND': 'django.template.backends.jinja2.Jinja2',
        'APP_DIRS': True,
        'OPTIONS': {
            'extensions': [
                'wagtail.jinja2tags.core',
                'wagtail.admin.jinja2tags.userbar',
                'wagtail.images.jinja2tags.images',
            ],
        },
    }
]

Шаблоны Jinja должны быть размещены в каталоге jinja2/ вашего приложения. Например, стандартное расположение шаблонов для модели EventPage в приложении events будет events/jinja2/events/event_page.html.

По умолчанию среда Jinja не имеет никаких функций или фильтров Django. Дополнительную информацию о django.template.backends.jinja2.Jinja2 (настройка Jinja для Django) можно найти в документации Django.

self в шаблонах

В шаблонах Django self можно использовать для ссылки на текущую страницу, блок потока или панель поля. В Jinja self зарезервировано для внутреннего использования. При написании шаблонов Jinja используйте page для ссылок на страницы, value для блоков потока и field_panel для панелей полей.

Теги, функции и фильтры шаблонов

<a href="{{ pageurl(page.more_information) }}">More information</a>

<a href="{{ slugurl("about") }}">About us</a>

{# Print an image tag #}
{{ image(page.header_image, "fill-1024x200", class="header-image") }}

{# Resize an image #}
{% set background=image(page.background_image, "max-1024x1024") %}
<div class="wrapper" style="background-image: url({{ background.url }});">

{{ page.body|richtext }}

{{ wagtail_site().site_name }}

{{ wagtailuserbar() }}

{% include_block page.body %}
{% include_block page.body with context %} {# The same as the previous #}
{% include_block page.body without context %}