Мы показали вам как загружать шаблон, заполнять Context и возвращать объект HttpResponse с обработанным шаблоном. Мы оптимизировали код, используя get_template() для загрузки шаблона. Но вам по-прежнему требуется набирать много кода для выполнения этих действий. По причине частого использования этой последовательности действий Django предоставляет более короткий метод, который позволяет вам выполнять эти действия одной строкой кода.

Речь идёт о функции render_to_response(), которая определена в модуле django.shortcuts. Чаще всего вы будете использовать render_to_response() вместо вышеописанных действий, кроме случая когда ваш работодатель оценивает ваш труд по количеству написанных строк кода.

Ниже представлен старый знакомый пример current_datetime, использующий функцию render_to_response():

from django.shortcuts import render_to_response
import datetime

def current_datetime(request):
    now = datetime.datetime.now()
    return render_to_response('current_datetime.html', {'current_date': now})

Какая разница! Пройдёмся по изменениям в коде:

Первым аргументом функции render_to_response() должно быть имя используемого шаблона. Вторым аргументом, если он есть, должен быть словарь, используемый при создании контекста для этого шаблона. Если вы не предоставите второй аргумент, функция будет использовать пустой словарь.

Рассмотрим последнюю инкарнацию функции current_datetime:

def current_datetime(request):
    now = datetime.datetime.now()
    return render_to_response('current_datetime.html', {'current_date': now})

Постоянно вы будете ловить себя на том, что вы вычисляете значения, сохраняете их в переменных (см. now в предыдущем примере) и отправляете эти переменные в шаблон. Особо ленивые разработчики должны отметить, что это немного излишне назначать имена временным переменным и шаблонным переменным. Это не только излишне, но и требует много набора на клавиатуре.

Таким образом, если вы один из таких ленивых разработчиков и вам нравится краткий код, вы можете воспользоваться встроенной в Python функцией locals(). Она возвращает словарь, хранящий все локальные переменные и их соответствующие значения (речь идёт о всех переменных, определённых в текущей области видимости). Следовательно, предыдущую функцию представления можно переписать так:

def current_datetime(request):
    current_date = datetime.datetime.now()
    return render_to_response('current_datetime.html', locals())

Здесь, вместо ручного ввода контекстного словаря, как это было раньше, вы передали значение функции locals(), которое содержало все переменные определённые в этой точке выполнения функции. Как результат, мы переименовали переменную now в current_date, потому что это то имя, которое шаблон ожидает. В этом примере locals() не предлагает значительного удобства, но эта методика может сохранить вам время, если вы используете несколько шаблонных переменных или если вы ленивы.

Следует обратить внимание при использовании locals() на то, что она включает в результат каждую локальную переменную. Это может быть не совсем то, что вам нужно. В предыдущем примере, locals() также включает request. Важно ли это для вас, зависит от вашего приложения и вашего уровня перфекционизма.

Может стать неудобно хранить все шаблоны в одном каталоге. Вам может понадобиться хранить шаблоны в подкаталогах вашего каталога шаблонов, это нормально. Действительно, мы рекомендуем делать так. Более продвинутые особенности Django (такие как общая система представлений, которая будет описана в главе «Генерация данных, отличных от HTML») ожидают такое расположение шаблонов по умолчанию.

Хранение шаблонов в подкаталогах несложное занятие. В вашем вызове get_template(), просто включите имя подкаталога и слэш перед именем шаблона, вот так:

t = get_template('dateapp/current_datetime.html')

Так как render_to_response() является небольшой обёрткой к get_template(), вы можете делать то же самое и с первым аргументом функции render_to_response().

Нет ограничений на глубину дерева подкаталогов. Используйте столько сколько нужно.

После того как мы описали механизм загрузки шаблонов, мы можем рассказать о встроенном шаблонном теге, который использует его: {% include %}. Этот тег позволяет вам подключать содержимое другого шаблона. Аргументом тега является путь к подключаемому шаблону. Имя шаблона может быть представлено как переменной, так и строкой, заключённой в двойные или одинарные кавычки. Если вы используете один и тот же код в нескольких шаблонах, рассмотрите возможность использования тега {% include %}, чтобы исключить дублирование кода.

Следующий пример дважды подключает содержимое шаблона nav.html. Строки примера эквивалентны, несмотря на разницу используемых кавычек:

{% include 'nav.html' %}
{% include "nav.html" %}

Следующий пример показывает как следует подключать содержимое шаблона includes/nav.html:

{% include 'includes/nav.html' %}

Следующий пример подключает содержимое шаблона, имя которого содержится в переменной template_name:

{% include template_name %}

Подобно функции get_template(), имя файла для шаблона определяется с использованием каталога для шаблонов из параметра конфигурации TEMPLATE_DIRS.

Подключенные шаблоны обрабатываются в контексте шаблона, который их подключил. Например, рассмотрим два шаблона:

# mypage.html

<html>
<body>
{% include "includes/nav.html" %}
<h1>{{ title }}</h1>
</body>
</html>

# includes/nav.html

<div id="nav">
    You are in: {{ current_section }}
</div>

При обработке шаблона mypage.html с контекстом, в котором определена переменная current_section, тогда переменная будет доступна в «подключенном» шаблоне, как вы могли ожидать.

Если подключаемый шаблон не существует, Django выполнит одно действие из нижеприведённых: