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

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

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

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

• Попробуйте справочник по часто задаваемым вопросам – в нём есть ответы на многие распространённые вопросы.
• Ищете конкретную информацию? Попробуйте индекс, индекс модулей или подробное оглавление.
• Поищите информацию в архивах рассылки django-users, или опубликуйте вопрос.
• Задайте вопрос в канале #django IRC или найдите ответ в журнале IRC-логов.
• Сообщите о проблемах с Django в нашем трекере ошибок.

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

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

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

Первые шаги

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

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

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

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

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

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

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

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

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

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

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

Формы

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

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

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

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

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

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

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

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

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

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

• Обзор безопасности
• Разглашенные проблемы безопасности в Django
• Защита от Clickjacking
• Защита от CSRF-атак
• Криптографическое подписание
• Средства обеспечения безопасности

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

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

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

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

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

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

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

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

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

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

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

Другие основные функции

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

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

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

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

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