app | ||
.gitignore | ||
config.py | ||
init_db.py | ||
LICENSE | ||
README.md | ||
requirements.txt | ||
run.py |
區塊鏈知識庫系統 (Blockchain Knowledge Hub)
一個基於 Flask 的區塊鏈知識管理系統,提供結構化的區塊鏈知識內容展示和管理功能。
功能特點
- 四大知識區塊:基本概念、技術原理、日常應用、潛力與挑戰
- 多層級內容結構:區塊 > 主題 > 子知識點 > 關鍵字
- 關鍵字懸停解釋功能
- 完整的後台管理系統
- 響應式設計,支援各種設備
技術棧
- 後端:Python Flask
- 前端:Bootstrap 5
- 資料庫:SQLite
- ORM:SQLAlchemy
安裝說明
- 建立虛擬環境
python -m venv venv
- 啟動虛擬環境
# Windows
venv\Scripts\activate
# Mac/Linux
source venv/bin/activate
- 安裝依賴
pip install -r requirements.txt
- 初始化資料庫
python init_db.py
- 運行應用
flask run
系統結構
資料模型
- Section (區塊)
- Topic (主題)
- Subtopic (子知識點)
- Keyword (關鍵字)
主要功能
-
前台功能
- 瀏覽知識內容
- 關鍵字解釋
- 響應式導航
-
後台管理
- 區塊管理(新增/編輯/刪除)
- 主題管理(新增/編輯/刪除)
- 子知識點管理(新增/編輯/刪除)
- 關鍵字管理(新增/編輯/刪除)
文件結構
blockchain_wiki/
├── app/
│ ├── __init__.py # Flask 應用程式設定
│ ├── models.py # 資料庫模型
│ ├── routes.py # 路由控制
│ ├── database.db # SQLite 資料庫
│ ├── templates/ # HTML 模板
│ │ ├── base.html
│ │ ├── index.html
│ │ ├── section.html
│ │ └── admin/
│ └── static/ # 靜態資源
│ └── css/
│ └── style.css
├── config.py # 設定檔
└── run.py # 應用程式入口
使用說明
前台瀏覽
- 訪問首頁查看所有知識區塊
- 使用左側導航欄切換不同區塊
- 將滑鼠移到關鍵字上可查看解釋
後台管理
- 點擊導航欄的「管理」按鈕進入後台
- 可以進行內容的新增、編輯、刪除操作
- 關鍵字管理獨立,不受其他內容刪除影響
開發說明
- 使用 Flask Blueprint 進行路由管理
- 使用裝飾器處理資料庫操作和錯誤處理
- 關鍵字為獨立實體,不會因內容刪除而刪除
- 完整的錯誤處理和用戶提示
注意事項
- 初次使用需要初始化資料庫
- 建議定期備份資料庫文件
- 關鍵字在刪除前請確認是否仍在使用中
- 確保 Python 版本 >= 3.6
未來規劃
- 使用者認證系統
- 搜尋功能
- 內容版本控制
- API 接口
- 內容匯出功能
- 多語言支援