IdealYard

Используя Vue и Flask создается разделенный на фронтенд и бэкенд RESTful-личный блог.

Часть описаний проекта можно найти здесь 👉О IdealYard, если не найдете нужной информации, свяжитесь с нами по электронной почте или через Issues;

⚠ Внимание

1. Этот блог предназначен только для изучения принципов, фронтенд-страницы не реализуют адаптивную верстку, и у нас нет времени на ее реализацию. Содержимое блога также не обновляется. О повседневных записях можно узнать на блоге Бийянь ;

2. Если вы новичок в Flask, рекомендую книгу "Flask Web Development: From Beginner to Advanced" для русскоязычных читателей. Также рекомендую посетить этот сайт: HelloFlask - Flask ресурсы ;

3. Из-за истечения срока действия сервера, данный блог временно не имеет демонстрационной функции. Если кто-то развернет его и предоставит ссылку на демонстрацию, мы будем очень признательны. Временно вы можете посмотреть простую демонстрацию функций по ссылке ниже. Использование Vue и Flask для создания разделенного на фронтенд и бэкенд RESTful-личного блога_哔哩哔哩 (゜-゜)つロ 干杯~-bilibili

Использование Vue и Flask для создания разделенного на фронтенд и бэкенд RESTful-личного блога4. Из-за этого Flask-RESTful уже не является хорошим выбором, возможно, flask-restx и Apiflask (разработанные китайскими разработчиками) будут лучшими альтернативами. Если вы хотите изучить, рекомендую перейти на более активно поддерживаемые расширения.Необходимо различать расширения и фреймворки, смотрите: Пожалуйста, не сравнивайте Flask и FastAPI | Лиху

Поскольку "FastAPI должен сравниваться с Web API-фреймворками на основе Flask", какие подходящие объекты для сравнения? Flask-RESTX, Flask-Rebar, flask-apispec, flask-smorest, Flask-RESTful, APIFairy хотя они и пытаются стать фреймворками, но по сути остаются расширениями Flask.

Общение

1. Для технических вопросов рекомендуется задавать вопросы через Issues · imoyao/idealyard для обратной связи с сообществом, см. также: Issue #15 · imoyao/idealyard
2. По предложению пользователей был создан QQ-чат, номер группы: 613922612. Однако обратите внимание: этот проект является чисто открытым, и я не зарабатываю на этом деньги (у меня есть свои дела). В ближайшем будущем у меня нет возможности уделять время на ответы на вопросы пользователей. Поэтому основная цель группы — это создание платформы для обмена опытом между новичками. Если возможно, обсуждайте свои вопросы в открытом доступе, а не просто выкладывайте скриншоты и ждите ответа.

Внимание

Если это не обязательно, пожалуйста, тщательно обдумайте, стоит ли присоединяться! Некоторые пользователи присоединяются, не говорят ни слова и затем покидают группу. Такое поведение, когда пользователи присоединяются и затем покидают группу, создает необоснованные помехи.

3. Будьте добры, добры, добры. Связь через интернет — это драгоценная связь. Пожалуйста, относитесь к другим с уважением и честностью.

Предварительные условия

Python

3.6+

MySQL

mysql  Ver 14.14 Distrib 5.7.26, for linux-glibc2.12 (x86_64) using  EditLine wrapper

или

MariaDB

[root@python]# mysql --version
mysql  Ver 15.1 Distrib 5.5.64-MariaDB, for Linux (x86_64) using readline 5.1

Создание базы данных

База данных для режима разработки: iyblog_dev, конфигурация может быть изменена в этой конфигурации

CREATE USER 'USERNAME'@'localhost' IDENTIFIED BY 'PASSWORD';
-- Если требуется поддержка эмодзи, установите кодировку utf8mb4. В противном случае используйте кодировку utf8.
CREATE DATABASE DATABASENAME CHARSET=utf8mb4;
grant all privileges on DATABASENAME.* to USERNAME@localhost identified by 'PASSWORD';
flush privileges;

Настройка окружения

1. После входа в текущую директорию установите pipenv для управления пакетами

   pip install pipenv [--user]
2. Установите зависимости Python

   pipenv install 
3. Настройте переменные окружения

   vi .flaskenv
4. Редактируйте файл dot.env, настройте переменные окружения и переименуйте файл в .env ```bash vi dot.env mv dot.env .env # См. ветку master

Передняя часть

Установка node и npm/yarn и изменение источника пакетов можно найти в руководствах в интернете. Передняя часть развертывания демонстрируется с использованием инструмента управления пакетами npm. Если вы используете yarn для управления пакетами, пожалуйста, внесите соответствующие изменения самостоятельно (вы уже используете yarn, поэтому, конечно, вы не сможете не найти файл package.json.😉)

Для конфигурации команд фронтенда обратитесь к разделу scripts в файле front/package.json.

Установка зависимостей

npm install

Режим разработки

1. Измените адрес и порт запросов к серверу в файле front/config/dev.env.js на реальный адрес API.
2. Запустите фронтенд.

npm run dev

Режим производства

1. Перейдите в директорию

cd front

2. Установите адрес BASE_API для окружения prod в файле front/config/prod.env.js.

// /idealyard/front/config/prod.env.js
module.exports = {
  NODE_ENV: '"production"',
  BASE_API: '"http://192.168.116.21:5000/api"'  // TODO: замените на реальный адрес API
}

3. Установите режим router на history.

// путь: front/src/router/index.js:16

const router = new VueRouter({
  // https://router.vuejs.org/zh/guide/essentials/history-mode.html#html5-history-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80
  // mode: 'history',
  routes: []
})

4. Сборка проекта

npm run build

Для получения дополнительной информации обратитесь к файлу document/deploy.md.## Поддержка Docker

pass

TODO

По причине нехватки времени, некоторые проблемы остаются нерешенными, подробнее см. здесь. Если вы хотите сделать PR, вы также можете использовать этот список для определения известных проблем и багов.

Дополнительно

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

Обзор кода

Структура директорий и статистика по количеству строк кода см. здесь.

Обзор фронтенда

Благодарности

Большое спасибо Г-же @Sabiner за поддержку, которая подтолкнула меня к написанию личного блога. Все началось с того дня, когда Чжоу Чуцинь прошел через деревню Ню.

Спасибо одновременно @LeiWong за помощь в поиске багов и решении проблем во время разработки.---

Человек должен уметь менять подгузник, планировать вторжение, убивать свинью, управлять кораблем, проектировать здание, писать сонет, сбалансировать счета, строить стену, вправлять вывих, успокаивать умирающего, принимать приказы, давать приказы, сотрудничать, действовать самостоятельно, решать уравнения, анализировать новую проблему, ворошить навоз, программировать компьютер, готовить вкусную еду, эффективно сражаться, умереть мужественно. Специализация — это для насекомых. -- Роберт Ансон Хайнлайн "Времени достаточно, чтобы полюбить"