Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs: 统一 SVG 命名规范从 slide_XX_xxx.svg 到 NN_xxx.svg

hugohe35fe63dd3c363
diff --git a/README.md b/README.md
index 3fa12abf..04c885f5 100644
--- a/README.md
+++ b/README.md
@@ -680,7 +680,7 @@ ppt-master/
### 输出管理
-1. **文件命名** - 使用清晰的命名规则(如:`slide_01_cover.svg`)
+1. **文件命名** - 使用清晰的命名规则(如:`01_cover.svg`)
2. **版本控制** - 保存每次迭代的版本
3. **格式转换** - 根据需要转换为 PNG 或 PDF
4. **项目组织** - 将每个演示项目放在 `projects/` 目录下,包含设计规范和 SVG 输出
@@ -739,8 +739,8 @@ projects/
├── 来源文档.md # 源文档(可选)
├── preview.html # 预览页面(自动生成)
└── svg_output/ # 生成的SVG文件
- ├── slide_01_cover.svg
- ├── slide_02_xxx.svg
+ ├── 01_cover.svg
+ ├── 02_xxx.svg
└── ...
```
diff --git a/README_EN.md b/README_EN.md
index 819755d9..b3c9e52f 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -688,7 +688,7 @@ ppt-master/
### Output Management
-1. **File Naming** - Use clear naming rules (e.g.: `slide_01_cover.svg`)
+1. **File Naming** - Use clear naming rules (e.g.: `01_cover.svg`)
2. **Version Control** - Save versions of each iteration
3. **Format Conversion** - Convert to PNG or PDF as needed
4. **Project Organization** - Place each presentation project in `projects/` directory, including design specifications and SVG output
@@ -747,8 +747,8 @@ projects/
├── 来源文档.md # Source document (optional)
├── preview.html # Preview page (auto-generated)
└── svg_output/ # Generated SVG files
- ├── slide_01_cover.svg
- ├── slide_02_xxx.svg
+ ├── 01_cover.svg
+ ├── 02_xxx.svg
└── ...
```
diff --git a/docs/quick_reference.md b/docs/quick_reference.md
index b6bf2c98..4e173fd5 100644
--- a/docs/quick_reference.md
+++ b/docs/quick_reference.md
@@ -146,9 +146,9 @@
```
请根据设计规范生成第[X]页:[页面主题]
-请将SVG保存到:projects/[项目名]_[YYYYMMDD]/svg_output/slide_[页码]_[主题].svg
+请将SVG保存到:projects/[项目名]_[YYYYMMDD]/svg_output/[页码]_[主题].svg
-例如: projects/company_report_20251012/svg_output/slide_01_cover.svg
+例如: projects/company_report_20251012/svg_output/01_cover.svg
```
### 请求修改
@@ -337,22 +337,22 @@ design_specification.md
### SVG 文件
```
-格式: slide_{页码}_{主题}.svg
+格式: {页码}_{主题}.svg
示例:
-slide_01_cover.svg
-slide_02_kpi_dashboard.svg
-slide_03_market_analysis.svg
+01_cover.svg
+02_kpi_dashboard.svg
+03_market_analysis.svg
```
### 优化后的 SVG
```
-格式: yh_slide_{页码}_{主题}.svg
+格式: yh_{页码}_{主题}.svg
示例:
-yh_slide_01_cover.svg
-yh_slide_02_kpi_dashboard.svg
+yh_01_cover.svg
+yh_02_kpi_dashboard.svg
```
## 🔗 快速链接
diff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.md
index 9f6eb8b6..ce2cb0c5 100644
--- a/docs/workflow_tutorial.md
+++ b/docs/workflow_tutorial.md
@@ -105,8 +105,8 @@
▼
┌────────────────────────┐
│ SVG 文件 (逐页生成) │
- │ slide_01_cover.svg │
- │ slide_02_xxx.svg │
+ │ 01_cover.svg │
+ │ 02_xxx.svg │
│ ... │
└────────────┬───────────┘
│
@@ -149,8 +149,8 @@
│ SVG 输出 │
│ ┌──────────────────┐ │
│ │ svg_output/ │ │
- │ │ ├── slide_01.svg │ │
- │ │ ├── slide_02.svg │ │
+ │ │ ├── 01_xxx.svg │ │
+ │ │ ├── 02_xxx.svg │ │
│ │ └── ... │ │
│ └──────────────────┘ │
└────────────┬───────────┘
diff --git a/projects/README.md b/projects/README.md
index 94e4558b..aa2a613f 100644
--- a/projects/README.md
+++ b/projects/README.md
@@ -17,7 +17,7 @@ project_name_format_YYYYMMDD/
├── README.md
├── 设计规范与内容大纲.md
├── svg_output/
-│ ├── slide_01_cover.svg
+│ ├── 01_cover.svg
│ └── ...
└── images/ (可选)
```
diff --git a/tools/README.md b/tools/README.md
index 4ab8eafd..eb959df1 100644
--- a/tools/README.md
+++ b/tools/README.md
@@ -392,7 +392,7 @@ python3 tools/error_helper.py missing_readme project_path=my_project
```bash
# 检查单个文件
-python3 tools/svg_quality_checker.py examples/project/svg_output/slide_01.svg
+python3 tools/svg_quality_checker.py examples/project/svg_output/01_cover.svg
# 检查整个目录
python3 tools/svg_quality_checker.py examples/project/svg_output
@@ -911,7 +911,7 @@ python3 tools/svg_rect_to_path.py examples/ppt169_demo/svg_output/01_cover.svg
python3 tools/fix_image_aspect.py path/to/slide.svg
# 处理多个文件
-python3 tools/fix_image_aspect.py slide_01.svg slide_02.svg slide_03.svg
+python3 tools/fix_image_aspect.py 01_cover.svg 02_toc.svg 03_content.svg
# 预览模式(不修改文件)
python3 tools/fix_image_aspect.py --dry-run path/to/slide.svg