Документация Django

Всё, что нужно знать о Django.

Первые шаги

Вы только начинаете знакомство с Django или программированием? Начните здесь!

С нуля: Обзор | Установка
Руководство: Часть 1: запросы и ответы | Часть 2: модели и сайт администрирования | Часть 3: представления и шаблоны | Часть 4: формы и универсальные представления | Часть 5: тестирование | Часть 6: статические файлы | Часть 7: настройка сайта администрирования | Часть 8: добавление сторонних пакетов
Продвинутые руководства: Как написать повторно используемые приложения | Как внести свой первый вклад в Django

Получение помощи

Возникли трудности? Мы готовы помочь!

Загляните в раздел часто задаваемых вопросов — там есть ответы на многие распространённые вопросы.
Ищете конкретную информацию? Попробуйте воспользоваться указателем, указателем модулей или подробным оглавлением.
Не нашли нужного? См. Часто задаваемые вопросы: получение помощи, чтобы узнать, как получить поддержку и задать вопросы сообществу.
Сообщайте об ошибках в Django в нашем трекере задач.

Как организована документация

Документация Django обширна. Общее представление о её структуре поможет понять, где искать нужную информацию:

Руководства шаг за шагом знакомят вас с созданием веб-приложения. Начните отсюда, если вы только знакомитесь с Django или разработкой веб-приложений. Также см. раздел «Первые шаги».
Тематические руководства рассматривают ключевые темы и понятия на достаточно высоком уровне, а также содержат полезные сведения и пояснения.
Справочники содержат техническую справочную информацию об API и других аспектах устройства Django. В них описано, как всё работает и как этим пользоваться, но предполагается, что вы знакомы с основными понятиями.
Практические руководства — это инструкции. Они описывают шаги для решения ключевых задач и типичных проблем. Они рассчитаны на более продвинутых читателей, чем обычные руководства, и предполагают некоторое знакомство с принципами работы Django.

Слой моделей

Django предоставляет уровень абстракции («модели») для организации и обработки данных веб-приложения. Подробнее об этом:

Модели: Введение в модели | Типы полей | Индексы | Параметры Meta | Класс модели
Наборы запросов: Выполнение запросов | Справочник методов QuerySet | Выражения поиска
Экземпляры моделей: Методы экземпляров | Доступ к связанным объектам
Миграции: Введение в миграции | Справочник операций | SchemaEditor | Создание миграций
Дополнительные темы: Менеджеры | Необработанный SQL | Транзакции | Агрегация | Поиск | Пользовательские поля | Несколько баз данных | Пользовательские поисковые выражения | Выражения запросов | Условные выражения | Функции базы данных
Другое: Поддерживаемые базы данных | Устаревшие базы данных | Предоставление исходных данных | Оптимизация доступа к базе данных | Особенности PostgreSQL

Слой представлений

В Django представления инкапсулируют логику обработки пользовательского запроса и формирования ответа. Всё необходимое о представлениях вы найдёте по ссылкам ниже:

Основы: URLconf | Функции представлений | Вспомогательные функции | Декораторы | Асинхронная поддержка
Справочник: Встроенные представления | Объекты запросов и ответов | Объекты TemplateResponse
Загрузка файлов: Обзор | Объекты файлов | API хранилищ | Управление файлами | Пользовательское хранилище
Представления на основе классов: Обзор | Встроенные представления для отображения | Встроенные представления для редактирования | Использование примесей | Справочник API | Сводный указатель
Дополнительные темы: Создание CSV | Создание PDF
Промежуточное ПО: Обзор | Встроенные классы промежуточного ПО

Слой шаблонов

Слой шаблонов предоставляет удобный для дизайнеров синтаксис отображения информации пользователю. Узнайте, как дизайнеры могут использовать этот синтаксис, а программисты — расширять его:

Основы: Обзор
Для дизайнеров: Обзор языка | Встроенные теги и фильтры | Форматирование для удобства чтения
Для программистов: API шаблонов | Пользовательские теги и фильтры | Пользовательский бэкенд шаблонов

Формы

Django предоставляет широкие возможности для создания форм и обработки данных форм.

Основы: Обзор | API форм | Встроенные поля | Встроенные виджеты
Дополнительные темы: Формы для моделей | Подключение медиафайлов | Наборы форм | Настройка проверки данных

Процесс разработки

Узнайте о различных компонентах и инструментах, которые помогут вам разрабатывать и тестировать приложения Django:

Настройки: Обзор | Полный список настроек
Приложения: Обзор
Исключения: Обзор
django-admin и manage.py: Обзор | Добавление пользовательских команд
Тестирование: Введение | Написание и запуск тестов | Встроенные инструменты тестирования | Дополнительные темы
Развёртывание: Обзор | Серверы WSGI | Серверы ASGI | Развёртывание статических файлов | Отслеживание ошибок в коде по электронной почте | Контрольный список для развёртывания

Панель администрирования

Узнайте всё необходимое об автоматизированном интерфейсе администрирования — одной из самых популярных возможностей Django:

Безопасность

Безопасность имеет первостепенное значение при разработке веб-приложений, и Django предоставляет множество средств и механизмов защиты:

Интернационализация и локализация

Django предлагает надёжную платформу интернационализации и локализации, которая поможет разрабатывать приложения для разных языков и регионов мира:

Производительность и оптимизация

Существует множество методов и инструментов, которые помогают повысить эффективность выполнения кода: ускорить его работу и сократить потребление системных ресурсов.

Обзор производительности и оптимизации

Географическая платформа

GeoDjango призван стать географической веб-платформой мирового класса. Его цель — максимально упростить создание веб-приложений ГИС и использование возможностей данных с пространственной привязкой.

Распространённые инструменты веб-приложений

Django предлагает множество инструментов, часто необходимых при разработке веб-приложений:

Другие основные возможности

Узнайте о других основных возможностях платформы Django:

Проект Django с открытым исходным кодом

Узнайте о процессе разработки самого проекта Django и о том, как вы можете внести свой вклад:

Сообщество: Участие в разработке Django | Процесс выпуска релизов | Организация команды | Репозиторий исходного кода Django | Политики безопасности | Списки рассылки и форум
Принципы проектирования: Обзор
Документация: Об этой документации
Сторонние дистрибутивы: Обзор
Django с течением времени: Стабильность API | Примечания к выпускам и инструкции по обновлению | График устаревания

© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/6.0/index/