| 1 | # User Project Workspace |
| 2 | |
| 3 | This directory is used for storing in-progress projects. |
| 4 | |
| 5 | ## Create a New Project |
| 6 | |
| 7 | ```bash |
| 8 | python3 skills/ppt-master/scripts/project_manager.py init my_project --format ppt169 |
| 9 | ``` |
| 10 | |
| 11 | ## Directory Structure |
| 12 | |
| 13 | A typical project usually contains the following: |
| 14 | |
| 15 | ``` |
| 16 | project_name_format_YYYYMMDD/ |
| 17 | ├── README.md |
| 18 | ├── design_spec.md |
| 19 | ├── sources/ |
| 20 | │ ├── Raw files / URL archives / Converted Markdown |
| 21 | │ └── *_files/ # Markdown companion resource directory (e.g., images) |
| 22 | ├── images/ # Image assets used by the project |
| 23 | ├── analysis/ # Extracted source facts (PPTX intake bundle, image_analysis.csv) |
| 24 | ├── notes/ |
| 25 | │ ├── 01_xxx.md |
| 26 | │ ├── 02_xxx.md |
| 27 | │ └── total.md |
| 28 | ├── svg_output/ |
| 29 | │ ├── 01_xxx.svg |
| 30 | │ └── ... |
| 31 | ├── svg_final/ |
| 32 | │ ├── 01_xxx.svg |
| 33 | │ └── ... |
| 34 | ├── templates/ # Project-level templates (if any) |
| 35 | └── exports/ |
| 36 | └── *.pptx # Native DrawingML deliverables |
| 37 | ``` |
| 38 | |
| 39 | Projects can remain at different stages and do not necessarily have all artifacts at once. For example: |
| 40 | |
| 41 | - Only `sources/` archiving and the Design Specification & Content Outline (design_spec) are complete |
| 42 | - `svg_output/` has been generated, but post-processing has not yet been executed |
| 43 | - `svg_final/` is a self-contained visual preview, and `exports/*.pptx` is complete |
| 44 | |
| 45 | ## Notes |
| 46 | |
| 47 | - Contents under this directory are excluded by `.gitignore` |
| 48 | - `svg_final/` may be opened directly or inserted manually as an SVG image; PowerPoint's manual Convert to Shape behavior is not supported |
| 49 | - Completed projects can be moved to the `examples/` directory for sharing |
| 50 | - Files outside the workspace are copied by default; files within the workspace are moved directly to the project's `sources/` |
| 51 |