wehub-resource-sync
51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
# User Project Workspace
|
|
|
|
This directory is used for storing in-progress projects.
|
|
|
|
## Create a New Project
|
|
|
|
```bash
|
|
python3 skills/ppt-master/scripts/project_manager.py init my_project --format ppt169
|
|
```
|
|
|
|
## Directory Structure
|
|
|
|
A typical project usually contains the following:
|
|
|
|
```
|
|
project_name_format_YYYYMMDD/
|
|
├── README.md
|
|
├── design_spec.md
|
|
├── sources/
|
|
│ ├── Raw files / URL archives / Converted Markdown
|
|
│ └── *_files/ # Markdown companion resource directory (e.g., images)
|
|
├── images/ # Image assets used by the project
|
|
├── analysis/ # Extracted source facts (PPTX intake bundle, image_analysis.csv)
|
|
├── notes/
|
|
│ ├── 01_xxx.md
|
|
│ ├── 02_xxx.md
|
|
│ └── total.md
|
|
├── svg_output/
|
|
│ ├── 01_xxx.svg
|
|
│ └── ...
|
|
├── svg_final/
|
|
│ ├── 01_xxx.svg
|
|
│ └── ...
|
|
├── templates/ # Project-level templates (if any)
|
|
└── exports/
|
|
└── *.pptx # Native DrawingML deliverables
|
|
```
|
|
|
|
Projects can remain at different stages and do not necessarily have all artifacts at once. For example:
|
|
|
|
- Only `sources/` archiving and the Design Specification & Content Outline (design_spec) are complete
|
|
- `svg_output/` has been generated, but post-processing has not yet been executed
|
|
- `svg_final/` is a self-contained visual preview, and `exports/*.pptx` is complete
|
|
|
|
## Notes
|
|
|
|
- Contents under this directory are excluded by `.gitignore`
|
|
- `svg_final/` may be opened directly or inserted manually as an SVG image; PowerPoint's manual Convert to Shape behavior is not supported
|
|
- Completed projects can be moved to the `examples/` directory for sharing
|
|
- Files outside the workspace are copied by default; files within the workspace are moved directly to the project's `sources/`
|