README增加完整从头到尾详细教程
This commit is contained in:
@@ -2,6 +2,123 @@
|
||||
|
||||
PPT管理系统，实现**静态模板内容**与**动态数据内容**的智能合并。
|
||||
|
||||
---
|
||||
|
||||
## 📚 从零开始完整教程（必读）
|
||||
|
||||
### 第一步：创建你的第一个静态PPT模板
|
||||
|
||||
#### 方式A: 运行脚本快速生成示例（推荐新手）
|
||||
|
||||
```bash
|
||||
cd f:\ppt\ppt_manager
|
||||
python create_sample_template.py
|
||||
```
|
||||
|
||||
✅ 自动生成: `static_ppt/macro_analysis_template.pptx` (23页空白模板)
|
||||
|
||||
#### 方式B: 手工创建属于你自己的模板（正式项目用）
|
||||
|
||||
1. **打开Microsoft PowerPoint → 新建空白演示文稿**
|
||||
|
||||
2. **保存到**: `f:\ppt\ppt_manager\static_ppt\你的模板名称.pptx`
|
||||
|
||||
3. **页面布局建议**:
|
||||
| 页码 | 内容类型 | 说明 |
|
||||
|------|----------|------|
|
||||
| 1页 | 封面 | static |
|
||||
| 2页 | 目录 | static |
|
||||
| 3页 | 分析框架 | static |
|
||||
| 4页 | GDP图表页 | **dynamic** → Python脚本生成 |
|
||||
| 5页 | CPI图表页 | **dynamic** → Python脚本生成 |
|
||||
| 6-23页 | 其他原理内容 | static |
|
||||
|
||||
4. **保存模板**
|
||||
|
||||
---
|
||||
|
||||
### 第二步：理解 `config/project_config.yaml` 配置
|
||||
|
||||
```yaml
|
||||
projects:
|
||||
macro_analysis: # 项目ID
|
||||
name: "宏观数据分析报告" # 显示名称
|
||||
static_ppt: "static_ppt/macro_analysis_template.pptx" # 模板路径 ✅
|
||||
total_slides: 23 # 总页数
|
||||
slide_mapping:
|
||||
1: static # 第1页 = 静态来自模板
|
||||
2: static # 第2页 = 静态来自模板
|
||||
3: static # 第3页 = 静态来自模板
|
||||
4: dynamic_chart_gdp # 第4页 = 动态执行GDP脚本生成图片插入
|
||||
5: dynamic_chart_inflation # 第5页 = 动态执行CPI脚本生成图片插入
|
||||
6: static
|
||||
...更多...
|
||||
23: static
|
||||
|
||||
dynamic_generators: # 动态key 到 脚本文件路径 的映射
|
||||
dynamic_chart_gdp: "scripts/gdp_chart.py"
|
||||
dynamic_chart_inflation: "scripts/inflation_chart.py"
|
||||
dynamic_table_employment: "scripts/employment_table.py"
|
||||
dynamic_chart_trade: "scripts/trade_chart.py"
|
||||
dynamic_content_market: "scripts/market_analysis.py"
|
||||
```
|
||||
|
||||
**关键点**:
|
||||
- `slide_mapping` 里的 key 如果不是 `static`，就去 `dynamic_generators` 里找对应脚本执行
|
||||
- 脚本返回PNG图片路径，系统把图片插入对应新生成的页面
|
||||
|
||||
---
|
||||
|
||||
### 第三步：更新动态数据（改脚本取真实数据）
|
||||
|
||||
打开 `scripts/gdp_chart.py` 改成你自己的采集逻辑：
|
||||
|
||||
```python
|
||||
def generate(output_dir):
|
||||
import pandas as pd
|
||||
|
||||
# --------------------------
|
||||
# 在这里替换成你真实的取数代码:
|
||||
# --------------------------
|
||||
# df = pd.read_sql("SELECT * FROM gdp_stats", conn)
|
||||
# 或 df = pd.read_csv("你的真实GDP数据文件.csv")
|
||||
# 或 API调用: requests.get("https://stats.gov.cn/api/gdp")
|
||||
|
||||
# 下面是示例模拟数据，跑通后替换成真实采集代码
|
||||
quarters = ['2026Q1', '2026Q2']
|
||||
actual_data_from_api = [5.2, 5.1]
|
||||
|
||||
# 生成matplotlib图
|
||||
import matplotlib.pyplot as plt
|
||||
plt.plot(quarters, actual_data_from_api)
|
||||
plt.savefig(f"{output_dir}/my_real_gdp_chart.png")
|
||||
|
||||
return f"{output_dir}/my_real_gdp_chart.png"
|
||||
```
|
||||
|
||||
**其他脚本同理修改**:
|
||||
- CPI → `scripts/inflation_chart.py`
|
||||
- 就业数据 → `scripts/employment_table.py`
|
||||
- 贸易数据 → `scripts/trade_chart.py`
|
||||
- 市场分析 → `scripts/market_analysis.py`
|
||||
|
||||
---
|
||||
|
||||
### 第四步：启动Web生成
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
python app.py
|
||||
```
|
||||
|
||||
浏览器打开 **http://localhost:5000**
|
||||
|
||||
点击项目卡片上的 🚀 **"开始生成"** 按钮
|
||||
|
||||
✅ 生成的PPT在 `f:\ppt\ppt_manager\output\` 目录
|
||||
|
||||
---
|
||||
|
||||
## ✨ 核心特性
|
||||
|
||||
- 📁 **静态PPT管理**: 固定不变的原理内容放在本地PPT模板中
|
||||
@@ -25,7 +142,7 @@ ppt_manager/
|
||||
│ ├── trade_chart.py # 进出口图表
|
||||
│ └── market_analysis.py # 市场分析图表
|
||||
├── dynamic_content/ # 动态生成的图片存放
|
||||
├── output/ # 最终生成的PPT输出目录
|
||||
├── output/ # 👉 最终生成的PPT在这里
|
||||
├── logs/ # 日志目录
|
||||
├── src/
|
||||
│ ├── config_loader.py # 配置加载器
|
||||
@@ -34,13 +151,13 @@ ppt_manager/
|
||||
│ └── ppt_generator.py # 主合成引擎
|
||||
├── templates/
|
||||
│ └── index.html # Web界面
|
||||
├── app.py # Flask Web应用
|
||||
├── app.py # Flask Web应用（端口5000）
|
||||
├── main.py # 命令行入口
|
||||
├── create_sample_template.py # 创建示例模板脚本
|
||||
├── create_sample_template.py # ✅ 快速创建示例模板脚本
|
||||
└── requirements.txt # Python依赖
|
||||
```
|
||||
|
||||
## 🚀 快速开始
|
||||
## 🚀 快速开始（TL;DR）
|
||||
|
||||
### 1. 安装依赖
|
||||
|
||||
@@ -70,7 +187,7 @@ python main.py macro_analysis
|
||||
|
||||
## ⚙️ 配置说明
|
||||
|
||||
在 [config/project_config.yaml](file:///f:/ppt/ppt_manager/config/project_config.yaml) 中配置：
|
||||
在 `config/project_config.yaml` 中配置：
|
||||
|
||||
```yaml
|
||||
projects:
|
||||
@@ -79,14 +196,15 @@ projects:
|
||||
static_ppt: "static_ppt/macro_analysis_template.pptx"
|
||||
total_slides: 23
|
||||
slide_mapping:
|
||||
1: static # 静态页，来自模板
|
||||
1: static
|
||||
2: static
|
||||
3: static
|
||||
4: dynamic_chart_gdp # 动态页，执行对应脚本
|
||||
4: dynamic_chart_gdp
|
||||
5: dynamic_chart_inflation
|
||||
...
|
||||
dynamic_generators:
|
||||
dynamic_chart_gdp: "scripts/gdp_chart.py" # 脚本对应关系
|
||||
dynamic_chart_gdp: "scripts/gdp_chart.py"
|
||||
dynamic_chart_inflation: "scripts/inflation_chart.py"
|
||||
...
|
||||
```
|
||||
|
||||
@@ -113,3 +231,19 @@ def generate(output_dir):
|
||||
| 10页 | dynamic | 进出口贸易 | 每月更新 |
|
||||
| 13页 | dynamic | A股市场分析 | 每周更新 |
|
||||
| 其他页 | static | 原理、方法论 | 固定不变 |
|
||||
|
||||
---
|
||||
|
||||
## ❓ 常见问题排查
|
||||
|
||||
**Q1: 报错 `FileNotFoundError: 静态PPT文件不存在: static_ppt/macro_analysis_template.pptx`**
|
||||
|
||||
运行 `python create_sample_template.py` 生成示例模板
|
||||
|
||||
**Q2: 访问localhost:5000首页报错**
|
||||
|
||||
检查Flask是否正常启动在5000端口，以及templates目录是否存在
|
||||
|
||||
**Q3: 生成的PPT里动态页是空白**
|
||||
|
||||
检查动态脚本是否报错，查看logs目录下日志排查
|
||||
|
||||
Reference in New Issue
Block a user