idealyard

IdealYard

使用Vue2和Flask建立前後端分離的RESTful 個人部落格。

關於該專案的部分說明可在此處找到About IdealYard，如果沒有找到需要的內容，請郵件或Issues 交流；

注意

1. 該部落格僅用於學習原理，前端頁面並未實現響應式佈局，暫時也沒有精力去實現，博客內容也沒有時間去打理。關於日常的記錄部落格主要在別院牧會中更新。

2. 如果你是Flask 初學者，推薦一本國人書籍給大家《Flask Web開發實戰：入門、進階與原理解析》，本人也是該書的閱讀者與受益者。同時建議多去這個網站看看：HelloFlask - Flask資源集合地

3. 由於伺服器到期，本部落格暫無演示功能，如果有同學部署上線並可以提供演示鏈接，則非常感謝。暫時請點擊下方連結觀看簡單的功能演示。 使用Vue 和Flask 搭建前後端分離的RESTful 個人部落格功能展示_嗶哩嗶哩(゜-゜)つロ乾杯~-bilibili

4. 由於這裡提到的原因，Flask-RESTful 已經不是一個很好的選擇，可能flask-restx 和Apiflask <國人開發>（注意：由於本框架正在活躍開發期內，使用時請慎重評估） 是一個更好的替代品。如果需要學習，也建議遷移到維護更積極的擴充上面去。

注意區分擴充和框架的區別，請參閱：請不要把Flask 和FastAPI 放到一起比較| 李輝

既然「FastAPI 應該和基於Flask 的Web API 框架比較」，那麼適當的比較物件有哪些？ 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 ' ;
-- 如果需要支持emoji，则设置utf8mb4编码。否则使用utf-8编码即可
CREATE DATABASE DATABASENAME CHARSET = utf8mb4;
grant all privileges on DATABASENAME. * to USERNAME@localhost identified by ' PASSWORD ' ;
flush privileges;

環境配置

1. 進入目前目錄之後，先透過pip安裝pipenv管理包

   pip install pipenv [--user]

2. 安裝Python依賴

   pipenv install 

3. 配置環境變數

   vi .flaskenv

4. 編輯dot.env檔,配置環境變數並重新命名為.env

   vi dot.env
   mv dot.env .env        # 参考 master 分支

前端

node和npm/yarn的安裝和換源請網路搜尋教學自行完成。

前端部署部分是以npm作為套件管理工具進行演示的，如果使用yarn進行套件管理，請自行修改（你都使用yarn了，肯定不會找不到package.json的。）

前端指令配置請參考front/package.json中的scripts章節。

安裝依賴

npm install

開發模式

1. 修改前端檔案front/config/dev.env.js中後端請求的位址和連接埠為實際api位址
2. 啟動前端

npm run dev

生產模式

1. 切換目錄

 cd front

2. 設定prod環境BASE_API位址

 // /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模式

 // path: front/src/router/index.js:16

const router = new VueRouter ( {
  // https://router.vuejs.org/zh/guide/essentials/history-mode.html#html5-history-%E6%A8%A1%E5%BC%8F
  // mode: 'history',
  routes : [ ]
} )

4. build文件

npm run build

請參閱document/deploy.md檔案以了解更多。

Docker 支援

pass

TODO

因為時間關係，還有一些問題沒有解決，詳見此處如果有同學需要PR ，也可以參考此處已知未解決問題和bug單。

更多

與其在別處仰望,不如在這裡並肩。 開發模式配置及說明請參閱更多文檔

程式碼概覽

目錄結構和代碼量統計參考此處

前端概覽

致謝

感謝G 小姐@Sabiner的鼓勵才會產生動手寫個人部落格的想法。一切緣起，都要從丘處機經過牛家村的那個下午說起…

同時感謝@LeiWong在開發中遇到問題幫助尋找bug並解決問題時付出的時間。

---

A human being should be able to change a diaper, plan an invasion, butcher a hog, conn a ship, design a building, write a sonnet, balance accounts, build a wall, set a bone, comfort the dying, take orders, give. orders, cooperate, act alone, solve equations, analyze a new problem, pitch manure, program a computer, cook a tasty meal, fight efficiently, die gallantly. Specialization is for insects.

一個人應該能夠換尿布， 策劃戰爭， 殺豬， 開船， 設計房子， 寫十四行詩， 結算賬戶， 砌牆， 接脫臼的骨頭， 安慰瀕死的人， 服從命令， 發布命令， 攜手合作， 獨立行動， 解數學方程， 分析新問題， 鏟糞， 電腦編程， 做出可口的飯， 善打架， 勇敢地死去。 只有昆蟲才囿於一門。

-- 羅伯特·安森·海因萊因《時間足夠你愛》