一个基于Flask和GitHub Pages的个人博客系统。
- 支持Markdown格式写作
- 文章分类和标签管理
- 按日期归档
- 全文搜索功能
- 响应式设计,支持移动端访问
- 评论系统(基于GitHub Issues)
.
├── data/
│ ├── posts/ # Markdown文章
│ └── images/ # 文章图片
├── static/
│ └── js/ # JavaScript文件
├── templates/ # 模板文件
└── build/ # 构建输出目录
- 在
data/posts
目录下创建Markdown文件 - 文件名格式:
YYYY-MM-DD-title.md
- 文件开头需要包含以下frontmatter:
title: 文章标题
date: YYYY-MM-DD
category: 分类名
tags: [标签1, 标签2]
description: 文章描述
- 克隆仓库:
git clone https://github.com/jeffrey-zhang/jeffrey-zhang.github.io.git
cd jeffrey-zhang.github.io
- 安装依赖:
pip install -r requirements.txt
- 运行开发服务器:
python app.py
项目使用GitHub Actions自动部署到GitHub Pages。每次推送到main分支时会自动触发构建和部署。
- 确保仓库已启用GitHub Pages功能
- 将代码推送到main分支
- GitHub Actions会自动构建并部署网站
MIT License