pptx-html-generator 0.1.0

Generate PowerPoint files from JSON with progressive HTML support.

PPTX HTML Generator

Python library for rendering rich HTML text into python-pptx text frames.

Primary API

Most users should use this directly in their existing python-pptx pipeline:

from pptx_html_generator import render_html_to_text_frame

render_html_to_text_frame(shape.text_frame, html_string, base_styles={...})

This plugs in exactly where your app converts string content into text-frame content.

See:

• API contract: docs/API.md

Features

• JSON schema validation with useful error messages
• Unit parsing for in, cm, pt, emu
• Presentation generation with text box elements
• HTML rich-text support:
  • Inline formatting: <b>, <strong>, <i>, <em>, <u>, <s>, <del>, <strike>, <code>, <sup>, <sub>
  • Links and styled spans: <a>, <span style>
  • Block structure: <p>, <br>, <ul>, <ol>, <li>, <h1>-<h6>
• JSON style/default support:
  • font_name, font_size, font_color
  • alignment, vertical_anchor, word_wrap
• CLI: json_in -> pptx_out

Quick start

python -m pip install pptx-html-generator

Drop-in usage in an existing python-pptx workflow:

from pptx import Presentation
from pptx_html_generator import render_html_to_text_frame

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])  # blank
shape = slide.shapes.add_textbox(914400, 914400, 7315200, 1828800)
html = "<p><strong>Hello</strong> <em>world</em> with <a href='https://example.com'>a link</a>.</p>"

render_html_to_text_frame(shape.text_frame, html)
prs.save("example.pptx")

Forward generation CLI (optional helper for JSON-driven generation):

pptx-html-generator generate examples/full_implementation.json output/full_implementation_demo.pptx

Development setup:

python -m pip install -e ".[dev]"
pytest

CLI

Generate PPTX:

pptx-html-generator generate examples/full_implementation.json output/full_implementation_demo.pptx

List selectable elements on a slide (uses PowerPoint Selection Pane names):

pptx-html-generator list-elements output/full_implementation_demo.pptx --slide 1

Extract HTML from a selected shape by Selection Pane name:

pptx-html-generator extract-html output/full_implementation_demo.pptx --slide 1 --shape-name "BodyContent"

JSON shape (optional high-level API)

{
  "presentation": {
    "width": "13.333in",
    "height": "7.5in"
  },
  "slides": [
    {
      "layout": "blank",
      "elements": [
        {
          "type": "textbox",
          "position": {
            "left": "1in",
            "top": "1in",
            "width": "8in",
            "height": "2in"
          },
          "content": "Plain text content"
        }
      ]
    }
  ]
}