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

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

Первые шаги

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

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

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

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

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

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

У Django много документации. Обзор высокого уровня ее организации поможет вам узнать, где искать определенные вещи:

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

Модельная часть

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

Модели: Введение в модели | Типы полей | Индексы | Параметры мета | Класс модели
QuerySets: Выполнение запросов | Справочник по методам 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/5.2/index/