Добро пожаловать во Flask

Добро пожаловать в документацию по Flask. Начните с раздела Инсталляция, затем ознакомьтесь с разделом Быстрый старт. Есть также более детальное Учебник, которое покажет, как создать на Flask маленькое, но полноценное приложение. Общие заготовки описаны в разделе Заготовки для Flask. Оставшаяся документация детально описывает каждый из компонентов Flask, с точными ссылками в раздел API (перевод на начальной стадии).

Flask зависит от шаблонизатора Jinja2 и инструментария WSGI Werkzeug. Их документация может быть найдена здесь:

• Документация по Jinja2
• Документация по Werkzeug

Руководство пользователя

Эта, в значительной мере скучная часть документации, начинается с некоторой вводной информации о Flask, а затем фокусируется на инструкциях по веб-разработке шаг-за-шагом с использованием Flask.

• Предисловие
  • Что означает «микро»?
  • Конфигурация и Соглашения
  • Расти вместе с Flask
• Предисловие для опытных программистов
  • Внутрипоточные объекты (Thread-Locals) во Flask
  • Разработка для Веб с осторожностью
  • Статус Python 3
• Инсталляция
  • virtualenv
  • Установка непосредственно в систему
  • Жизнь на переднем краю
  • pip и setuptools в MS Windows
• Быстрый старт
  • Минимальное приложение
  • Режим отладки
  • Маршрутизация
  • Статические файлы
  • Визуализация шаблонов
  • Доступ к данным запроса
  • Ошибки и перенаправления
  • Об ответах
  • Сессии
  • Message Flashing
  • Ведение журналов
  • Как зацепиться (hooking) к промежуточному слою WSGI
  • Развёртывание приложения на веб-сервере
• Учебник
  • Введение в Flaskr
  • Шаг 0: Создание папок
  • Шаг 1: Схема базы данных
  • Шаг 2: Код для настройки приложения
  • Шаг 3: Соединения с базой данных
  • Шаг 4: Создание базы данных
  • Шаг 5: Функции представления
  • Шаг 6: Шаблоны
  • Шаг 7: Добавление стиля
  • Бонус: Тестирование приложения
• Шаблоны
  • Установка Jinja
  • Стандартный контекст
  • Стандартные фильтры
  • Управление автоэкранированием
  • Регистрация фильтров
  • Процессоры контекста
• Тестирование приложений Flask
  • Приложение
  • Скелет для тестирования
  • Первый тест
  • Вход и выход
  • Тестирование добавления сообщений
  • Другие трюки с тестами
  • Подделка ресурсов и контекста
  • Сохранение окружения контекста
  • Доступ к сессиям и их изменение
• Журналирование ошибок приложения
  • Письма об ошибках
  • Журналирование в файл
  • Управление форматом журнала
  • Другие библиотеки
• Отладка ошибок приложения
  • В случае сомнений запускайте вручную
  • Работа с отладчиками
• Обработка конфигурации Flask
  • Основы конфигурации
  • Встроенные параметры конфигурации
  • Задание конфигурации с помощью файлов
  • Лучшие способы задания конфигурации
  • Режим разработки и режим эксплуатации
  • Каталоги экземпляров
  • Примечания переводчика
• Сигналы
  • Подписка на сигналы
  • Создание сигналов
  • Отправка сигналов
  • Сигналы и контекст запроса Flask
  • Подписки на сигналы с использованием декоратора
  • Сигналы ядра
• Сменные представления (Pluggable Views)
  • Основной принцип
  • Подсказки метода
  • Диспетчеризация на базе метода
  • Декорирующие представления
  • Представления метода для различных API
• Контекст приложения Flask
  • Назначение контекста приложения
  • Создание контекста приложения
  • Локальность контекста
  • Использование контекста
• Контекст запроса Flask
  • Подробнее о локальных объектах контекста
  • Как работает контекст
  • Функции обратного вызова и ошибки
  • Функции обратного вызова teardown_request
  • Замечания о посредниках
  • Защита контекста при ошибках
• Модульные приложения Flask с использованием blueprint’ов
  • Для чего нужны blueprint’ы?
  • Концепция blueprint’ов
  • Мой первый blueprint
  • Регистрация blueprint’ов
  • Ресурсы blueprint’а
  • Генерирование URL’ов
  • Обработчики ошибок
• Расширения Flask
  • Поиск расширений
  • Использование расширений
  • Flask до версии 0.8
• Работа с командной оболочкой
  • Создание контекста запроса
  • Формирование запроса до/после
  • Дальнейшее развитие опыта работы с командной оболочкой
• Заготовки для Flask
  • Большие приложения во Flask
  • SQLAlchemy во Flask
  • Загрузка файлов
  • Кэширование
  • Декораторы представлений во Flask
  • Всплывающие сообщения
  • Собственные страницы ошибок
• Варианты развёртывания
  • Настройка mod_wsgi (Apache) для Flask
  • FastCGI

Справка об API

Если Вы ищите информацию по конкретным функции, классу или мотоду, эта часть документации для Вас.

• API (перевод на начальной стадии)
  • Объект приложения
  • Объекты blueprint
  • Данные входящих запросов
  • Объекты ответа
  • Сессии
  • Интерфейс сессий
  • Тестовый клиент
  • Глобальные переменные
  • Полезные функции и классы
  • Передача сообщений
  • Поддержка JSON
  • Отрисовка шаблонов
  • Конфигурация
  • Расширения
  • Потоки
  • Внутренние дополнения
  • Сигналы
  • Class-Based Views
  • URL Route Registrations
  • View Function Options

Дополнительные заметки

Здесь заметки для заинтересованных - о дизайне, правовая информация и лог изменений.

• Проектные решения во Flask
  • Явный объект приложения
  • Система маршрутизации
  • Одна система шаблонизации
  • Микро, но с зависимостями
  • Локальные объекты потоков
  • Что есть Flask и чем он не является
• FAQ по HTML/XHTML
  • История XHTML
  • История HTML5
  • HTML в сравнении с XHTML
  • Что означает «строгий»?
  • Новые технологии в HTML5
  • Что следует использовать?

Статус перевода на 01.09.2014

• Статус перевода на 01.09.2014

Оригинал этой страницы: http://flask-russian-docs.readthedocs.io/ Оригинал исходной страницы: https://flask.pocoo.org/docs/1.0/

© 2012-2019 Перевод ferm32

© 2013 Перевод разделов design, … http://vladimir-stupin.blogspot.ru/