Layouts and styling overview

PraisonAI PPT builds slides from YAML (or JSON). Layout behaviour is controlled by three layers:

slide_type — which renderer draws the slide (verse, table, avatar_*, deck_*, …).
slide_style — colours, typography, and inch/ratio tokens under layouts.<kind>.
video_export — compositor timing, avatar timeline, and FFmpeg options for MP4 export.

Choose a layout family

Family	Doc page	When to use
Standard	Standard slide layouts	Sermons, articles, bullets, tables, quotes — `list`, `table`, `verse`, `two_column`, …
Avatar / HeyGen	Avatar layouts & PiP	Speaking-head regions, split media, floating PiP on content slides
Sales deck	Deck layouts	HeyGen-style `deck_*` templates (title split, exec summary, region grid, …)

Topic	Doc page
All `slide_style` keys, `typography.`, `layouts.` defaults	Slide style reference
Highlights, alignment, list types	Rich text formatting
Reusable themes (`template: sermon-dark`)	Theme templates

Topic	Doc page
MP4 export, narration modes, `avatar_timeline`	Video export
HeyGen 50590 workflow and five media variants	HeyGen article examples
Auto `crop_x`, hybrid face detection	Avatar PiP calibration
`slide_images_dir`, JPEG previews	Slide JPEG export
Golden MD5, MP4 frames, manifest QA	Slide QA
Top-level deck keys, per-verse timing	YAML deck reference

python examples/build_showcase_examples.py

Gallery	YAML
All avatar `slide_type`s	`examples/avatar_layouts.yaml`
All `deck_*` layouts	`examples/deck_template_gallery.yaml`
HeyGen 50590 article (content + PiP)	`examples/heygen-50590-content.yaml` — see HeyGen examples
HeyGen 50590 images (full-bleed heroes)	`examples/heygen-50590-video-audio-heygen-images.yaml`

pip install -r requirements-docs.txt
mkdocs serve

The site also publishes via Jekyll (docs/_config.yml) at ppt.praison.ai; MkDocs is the recommended local preview with the full layout nav above.