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

Всё необходимое, что вам нужно знать о Django.

Первые шаги

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

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

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

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

• Попробуйте часто задаваемые вопросы – в них есть ответы на многие распространённые вопросы.
• Ищете конкретную информацию? Попробуйте Индекс, Индекс модулей или подробное оглавление.
• Ничего не нашли? Посмотрите часто задаваемые вопросы: Получение помощи для получения информации о получении поддержки и задавании вопросов сообществу.
• Сообщите о ошибках в 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
• Защита от кликджекинга
• Защита от CSRF атак
• Криптографическое подписание
• Средства безопасности

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

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

• Обзор | Локализация | Интернализация | Локализованный формат веб-интерфейса и входные данные форм
• Часовые пояса

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

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

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

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

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

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

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

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

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

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

• Условное обработка содержимого
• Типы содержимого и общие отношения
• Плоские страницы
• Перенаправления
• Сигналы
• Фреймворк системной проверки
• Фреймворк сайтов
• Unicode в Django

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

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

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