| 1 | # Documentation Index |
| 2 | |
| 3 | [English](./README.md) | [Chinese](./zh/README.md) |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | User-facing documentation lives in this directory: English files are the canonical source, with synchronized Chinese translations in [`zh/`](./zh/README.md). Workflow and technical references consumed by the AI itself live under [`skills/ppt-master/`](../skills/ppt-master/SKILL.md). |
| 8 | |
| 9 | ## Getting Started |
| 10 | |
| 11 | | Document | Description | |
| 12 | |---|---| |
| 13 | | [Getting Started](./getting-started.md) | First deck in 3 steps, plus templates, live preview, animations, narration, voice cloning | |
| 14 | | [Windows Installation](./windows-installation.md) | Step-by-step setup guide for Windows users | |
| 15 | | [FAQ](./faq.md) | Model selection, cost, layout troubleshooting, custom templates — updated from real user reports | |
| 16 | |
| 17 | ## Capabilities in Depth |
| 18 | |
| 19 | | Document | Description | |
| 20 | |---|---| |
| 21 | | [Audio Narration](./audio-narration.md) | Speaker notes to per-slide narration: providers, voice cloning, timing, PPTX embedding | |
| 22 | | [Transitions & Animations](./animations.md) | Default behavior and customization for page transitions and per-element object animations | |
| 23 | | [Templates Guide](./templates-guide.md) | Creating and applying brand / style / layout / deck templates | |
| 24 | |
| 25 | ## Architecture & Internals |
| 26 | |
| 27 | | Document | Description | |
| 28 | |---|---| |
| 29 | | [Technical Design](./technical-design.md) | Architecture, design philosophy, why SVG → DrawingML | |
| 30 | | [PowerPoint–SVG Mapping](./powerpoint-svg-mapping.md) | Feature-by-feature mapping between PowerPoint constructs and the pipeline | |
| 31 | | [Templates Architecture](./templates-architecture.md) | Design of the brand / style / layout / deck template system | |
| 32 | |
| 33 | ## Project Direction |
| 34 | |
| 35 | | Document | Description | |
| 36 | |---|---| |
| 37 | | [What Is a PPT?](./what-is-ppt.md) | The presentation medium, user jobs, delivery contexts, native object model, templates, and quality layers | |
| 38 | | [Why PPT Master](./why-ppt-master.md) | Why choose it, and where it's not the right fit | |
| 39 | | [Project Positioning](./project-positioning.md) | Long-term positioning, product promises, capability boundaries, and admission criteria | |
| 40 | | [Roadmap](./roadmap.md) | Delivered capabilities, current priorities, and explicitly deferred directions | |
| 41 | |
| 42 | ## Contributor Rules |
| 43 | |
| 44 | | Document | Description | |
| 45 | |---|---| |
| 46 | | [Style Rules](./rules/README.md) | Contributor style rules for prompt references and Python scripts | |
| 47 |