tiwater.pptx.cli 0.1.2

tiwater-pptx

OpenXML-based command-line utility for PPTX inspection, text export, and placeholder filling.

Usage

tiwater-pptx inspect <input.pptx> --json
tiwater-pptx inspect <input.pptx> --json --detail
tiwater-pptx export-json <input.pptx> [output.json]
tiwater-pptx fill-template <template.pptx> <data.json> <output.pptx>
tiwater-pptx apply-format-edits <input.pptx> <plan.json> <output.pptx>

For local development fallback:

dotnet run --project packages/pptx-cli/pptx.csproj -- inspect <input.pptx> --json

Fill Data

fill-template accepts either a flat JSON object or { "textValues": { ... } }. Placeholders are matched as exact inline tokens like {{title}}.

Detailed Inspect

inspect --json --detail emits slide size, slide paths, shape ids/names/kinds, shape transforms, paragraph alignment, and direct run formatting. Font size is reported in points. Shape coordinates remain in EMU so callers can compare native PPTX positions without lossy conversion.

Format Edit Plan

apply-format-edits copies the input PPTX to the output path, then applies only the targeted run-format operations listed in the plan. Operations are addressed by slide number, shape id, and run index from inspect --detail.

{
  "operations": [
    {
      "slideNumber": 1,
      "shapeId": 2,
      "runIndex": 0,
      "fontFamily": "微软雅黑",
      "fontSize": 16,
      "color": "287341",
      "bold": true,
      "paragraphAlignment": "center"
    }
  ]
}

Supported paragraphAlignment values are left, center, right, justified, and distributed. Missing targets are reported in issues; they are not silently ignored.