Документация Django¶
Все, что нужно знать о Django.
Первые шаги¶
Новичок в Django или в программировании? Начните изучение отсюда!
- С нуля: Быстрый обзор | Установка
- Учебник: Часть 1: Запросы и ответы | Часть 2: Модели и админка | Часть 3: Представления и шаблоны | Часть 4: Формы и базовые представления | Часть 5: Тестирование | Часть 6: Статические файлы | Часть 7: Настройка интерфейса администратора
- Расширенные учебные пособия: Как писать многократно используемые приложения | Написание первого патча для Django
Получение помощи¶
Есть проблемы? Мы с радостью поможем!
- Прочитайте FAQ – здесь содержатся ответы на самые распространенные вопросы.
- Ищете конкретную информацию? Загляните в Алфавитный указатель, Состав модуля или полное содержание документации.
- Ничего не нашли? См. ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ: Получение помощи для получения информации о том, как получить поддержку и задать вопросы сообществу.
- Сообщайте об ошибках в ticket tracker.
Как организована документация¶
У Джанго много документации. Общий обзор того, как она организована, поможет вам узнать, где искать необходимое:
- Руководства. Пройдите серию шагов по созданию веб-приложения. Начните с них, если вы новичок в Django или разработке веб-приложений. Также посмотрите «Первые шаги» ниже.
- Руководства объясняют ключевые темы и концепции на достаточно высоком уровне и предоставляют полезную справочную информацию и пояснения.
- Справочные руководства содержат техническую информацию по API и другим аспектам работы Django. Они описывают, как всё работает и как это использовать, но предполагают, что у вас есть базовое понимание ключевых понятий.
- Практические руководства являются рецептами. Они проведут вас через шаги, связанные с решением ключевых проблем и вариантов использования Django. Они более продвинуты, чем учебные пособия, и предполагают, что вы знаете как Django работает.
Уровень модели¶
Django предоставляет уровень абстракции («модели») для структурирования и управления данными вашего веб-приложения. Узнайте больше об этом ниже:
- Модели: Введение в модели | Типы полей | Индексы | Опции Meta | Класс Model
- QuerySets: Работа с запросами | Справочник по API QuerySet | Поисковые выражения
- Объекты модели: Методы модели | Доступ к связанным объектам
- Миграции: Введение в миграции | Справочник по операциям | SchemaEditor | Writing migrations
- Продвинутое: Менеджеры | Чистый SQL | Транзакции | Агрегирование | Поиск | Собственные поля | Несколько баз данных | Пользовательский поиск | Выражения запросов | Условные выражения | Функции базы данных
- Другое: Поддерживаемы базы данных | Устаревшие базы данных | Предоставление исходных данных | Оптимизация доступа к базе данных | Особенности PostgreSQL
Представления¶
В Django есть концепция «представлений» для инкапсуляции логики, ответственной за обработку запроса пользователя и возврат ответа. Все, что вам нужно знать о представлениях, вы найдете по ссылкам ниже:
- Основы: Основы конфигурации URL | Функции представлений | Вспомогательные функции | Декораторы | Asynchronous Support
- Справочные руководства: Встроенные функции | Объекты запроса и ответа (request/response) | Объекты TemplateResponse
- Загрузка файлов: Обзор | Файловые объекты | API хранилища | Управление файлами | Пользовательское хранилище
- Представления на основе классов: Обзор | Встроенные виды отображения | Встроенные виды редактирования | Использование миксинов | Справочник по API | Плоский индекс
- Расширенный: Генерация CSV | Генерация PDF
- Промежуточное программное обеспечение: Обзор | Встроенные классы промежуточного программного обеспечения
Шаблоны¶
Шаблоны обеспечивают удобный для дизайнера синтаксис для визуализации информации, которая будет представлена пользователю. Узнайте, как этот синтаксис может использоваться дизайнерами и как он может быть расширен программистами:
- Основы: Обзор
- Для дизайнеров: Обзор языка | Встроенные теги и фильтры | Улучшение читаемости
- Для программистов: API шаблонов | Пользовательские теги и фильтры | Серверная часть настраиваемого шаблона
Формы¶
Django предоставляет богатую основу для облегчения создания форм и манипулирования данными форм.
- Основы: Обзор | API форм | Встроенные поля | Встроенные виджеты
- Дополнительно: Формы для моделей | Интеграция медиа | Формсеты (наборы форм) | Настройка валидации
Процесс разработки¶
Узнайте о различных компонентах и инструментах, которые помогут вам в разработке и тестировании приложений Django:
- Настройки: Обзор | Полный список настроек
- Приложения: Обзор
- Исключения: Обзор
- django-admin и manage.py: Обзор | Добавление пользовательских команд
- Тестирование: Введение | Написание и выполнение тестов | Включенные инструменты тестирования | Продвинутые темы
- Развертывание: Обзор | WSGI серверы | ASGI серверы | Развертывание статических файлов | Отслеживание ошибок кода по электронной почте | Контрольный список развертывания
Админка¶
Узнайте все, что вам нужно знать об автоматизированном интерфейсе администратора, одной из самых популярных функций Django:
Безопасность¶
Безопасность - тема первостепенной важности при разработке веб-приложений, и Django предоставляет множество инструментов и механизмов защиты:
Интернационализация и локализация¶
Django предлагает надежную систему интернационализации и локализации, которая поможет вам в разработке приложений для различных языков и регионов мира:
Производительность и оптимизация¶
Существует множество методик и инструментов, которые могут помочь сделать ваш код более эффективным - более быстрым и использующим меньше системных ресурсов.
Географический фреймворк¶
GeoDjango намеревается стать географическим веб-фреймворком мирового класса. Его цель - максимально упростить создание веб-приложений ГИС и использование возможностей пространственных данных.
Общие инструменты веб-приложений¶
Django предлагает множество инструментов, обычно необходимых при разработке веб-приложений:
- Аутентификация: Обзор | Использование системы аутентификации | Управление паролями | Настройка аутентификации | Справочник по API
- Кэширование
- Логирование
- Отправка электронных писем
- Каналы синдикации (RSS/Atom)
- Пагинация
- Система сообщений
- Сериализация
- Сессии
- Карты сайта (sitemaps)
- Управление статическими файлами
- Валидация данных
Другие основные функциональные возможности¶
Узнайте о некоторых других основных функциональных возможностях фреймворка Django:
Django — проект с открытым исходным кодом¶
Узнайте о процессе разработки самого проекта Django и о том, как вы можете внести свой вклад:
- Сообщество: Как принять участие | Процесс выпуска | Организация команды | Репозиторий исходного кода Django | Политики безопасности | Списки рассылок
- Философия дизайна: Обзор
- Документация: Об этой документации
- Дистрибутивы сторонних производителей: Обзор
- Django с течением времени: Стабильность API | Примечания к выпуску и инструкции по обновлению | Deprecation Timeline