# Documentation Index

[English](./README.md) | [Chinese](./zh/README.md)

---

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).

## Getting Started

| Document | Description |
|---|---|
| [Getting Started](./getting-started.md) | First deck in 3 steps, plus templates, live preview, animations, narration, voice cloning |
| [Windows Installation](./windows-installation.md) | Step-by-step setup guide for Windows users |
| [FAQ](./faq.md) | Model selection, cost, layout troubleshooting, custom templates — updated from real user reports |

## Capabilities in Depth

| Document | Description |
|---|---|
| [Audio Narration](./audio-narration.md) | Speaker notes to per-slide narration: providers, voice cloning, timing, PPTX embedding |
| [Transitions & Animations](./animations.md) | Default behavior and customization for page transitions and per-element object animations |
| [Templates Guide](./templates-guide.md) | Creating and applying brand / style / layout / deck templates |

## Architecture & Internals

| Document | Description |
|---|---|
| [Technical Design](./technical-design.md) | Architecture, design philosophy, why SVG → DrawingML |
| [PowerPoint–SVG Mapping](./powerpoint-svg-mapping.md) | Feature-by-feature mapping between PowerPoint constructs and the pipeline |
| [Templates Architecture](./templates-architecture.md) | Design of the brand / style / layout / deck template system |

## Project Direction

| Document | Description |
|---|---|
| [What Is a PPT?](./what-is-ppt.md) | The presentation medium, user jobs, delivery contexts, native object model, templates, and quality layers |
| [Why PPT Master](./why-ppt-master.md) | Why choose it, and where it's not the right fit |
| [Project Positioning](./project-positioning.md) | Long-term positioning, product promises, capability boundaries, and admission criteria |
| [Roadmap](./roadmap.md) | Delivered capabilities, current priorities, and explicitly deferred directions |

## Contributor Rules

| Document | Description |
|---|---|
| [Style Rules](./rules/README.md) | Contributor style rules for prompt references and Python scripts |