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

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

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

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

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

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

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

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

Первые шаги

Вы новичок в Django или программировании? Это то, с чего нужно начать!

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

Модель

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

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

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

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

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

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

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

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

Формы

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

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

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

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

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

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

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

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

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

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

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

Международная и локальная поддержка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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