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

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

Первые шаги

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

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

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

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

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

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

Django содержит много документации. Обзор организации поможет вам найти необходимую информацию:

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

Уровень модели

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

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

Уровень представления

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

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

Уровень шаблонов

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

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

Формы

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

• Основы: Обзор | API форм | Встроенные поля | Встроенные виджеты
• Продвинутые: Формы для моделей | Интеграция медиа | Наборы форм | Настройка валидации

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

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

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

Админ-панель

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

• Админ-сайт
• Действия админ-панели
• Генератор документации админ-панели

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

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

• Обзор безопасности
• Указанные проблемы безопасности в Django
• Защита от кликджекинга
• Защита от межсайтовых поддельных запросов (CSRF)
• Криптографическое подписывание
• Средства защиты

Локализация и международная поддержка

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

• Обзор | Международная поддержка | Локализация | Форматирование веб-интерфейса и ввода данных форм с учетом локали
• Временные зоны

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

Существует множество техник и инструментов, которые могут помочь вашему коду работать эффективнее — быстрее и с меньшим использованием системных ресурсов.

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

Географический фреймворк

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

Общие инструменты для веб-приложений

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

• Авторизация: Обзор | Использование системы авторизации | Управление паролями | Настройка авторизации | Ссылка на API
• Кэширование
• Ведение журнала
• Отправка электронной почты
• Синдикационные ленты (RSS/Atom)
• Пагинация
• Фреймворк сообщений
• Сериализация
• Сессии
• Карты сайта
• Управление статическими файлами
• Валидация данных

Другие основные функциональные возможности

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

• Обработка условного контента
• Типы контента и общие отношения
• Flatpages
• Перенаправления
• Сигналы
• Фреймворк проверки системы
• Фреймворк сайтов
• Unicode в Django

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

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

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