pptx

PPTX

Create an editable .pptx in /workspace with the preinstalled python-pptx package. Never install or download dependencies. For a new deck, set output_path to a descriptive /workspace/<name>.pptx path.

Use this order:

1. Plan the slide purposes and visual system.
2. Build the complete deck.
3. Run the local checks below.
4. Verify the complete deck once.
5. If verification fails, repair it once and reverify.
6. Save the artifact only after the latest verification passes.

Authoring rules

• Use a 16:9 presentation unless the user requests another aspect ratio. Set prs.slide_width and prs.slide_height once; slide size is deck-wide.
• Use a consistent layout, palette, type scale, spacing system, and placement grid across the deck.
• Prefer a suitable built-in PowerPoint layout and its native placeholders over unrelated free-positioned text boxes. A native placeholder is a layout container, not permission to leave filler copy visible: populate every visible placeholder with final content unless the user explicitly requests a reusable template.
• Treat requests for "image placeholders", "visual suggestions", or "design concepts" as design direction for a finished deck. Add the real visual or a finished graphic treatment; do not display those instructions as slide text.
• Keep at least 0.5 inches of outer margin and 0.3 inches between unrelated content regions. Define title, subtitle, body, and footer regions once and reuse them; title and subtitle regions must not overlap.
• Give every slide one clear purpose. Keep body copy concise: normally no more than six bullets, with short phrases rather than paragraphs.
• Set fonts in the deck by family name. Default to Arial for fit-sensitive text; LibreOffice substitutes the metric-compatible Liberation Sans installed in the sandbox. Use Times New Roman/Liberation Serif when a serif is appropriate, and Noto for scripts they do not cover. If the user requires another font, leave about 10% extra width and height because LibreOffice and PowerPoint may use different metrics.
• Never guess or hardcode a font-file path. A path is needed only when calling text_frame.fit_text(...); resolve it at runtime with fc-match, for example fc-match -f '%{file}\n' Arial, and use the first non-empty line. If no file is returned, do not call fit_text; shorten the text or enlarge its region.
• Use 32–40 pt titles, 18–24 pt subtitles, and body text of at least 18 pt. Set text_frame.word_wrap = True and explicit text-frame margins; use zero margins where text must align exactly with a nearby shape.
• Do not use PowerPoint runtime autofit (text_frame.auto_size) because PowerPoint and LibreOffice can resolve it differently. For a single-style title or subtitle, text_frame.fit_text(...) may be used with the font file resolved above so the fitted size is written into the PPTX. If a title must shrink below 28 pt or a subtitle below 16 pt, shorten it, enlarge its region, or split the content across slides instead.
• Keep every shape on the slide canvas. Intentional edge bleed may cross a slide boundary, but do not park unused shapes off-canvas or hide backup slides.
• Preserve image aspect ratios. When calling add_picture, derive the missing dimension from the source image instead of setting both width and height to unrelated values. Extended crop values are legal, but the left and right crop fractions must sum to less than 1, as must the top and bottom fractions, so some of the image remains visible.
• Prefer editable native text, shapes, tables, and charts. Avoid SmartArt and elaborate gradients whose LibreOffice conversion is unreliable.