Документация 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 имеет понятие «представлений» для инкапсуляции логики, ответственной за обработку запроса пользователя и возвращение ответа. Найдите все, что вам нужно знать о представлениях по приведенным ниже ссылкам:

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

Слой шаблонов

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

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

Формы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Совместимость с Python

Django стремится к совместимости с различными вариантами и версиями Python:

• Поддержка Jython
• Совместимость с Python 3

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

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

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

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

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

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

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

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

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

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

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