.. _auto_pptx_template_extract:

*PPTX TEMPLATE EXTRACTOR*
=========================

Extracts a Reporter theme + slide master + slide layouts from a .pptx or .potx file. Writes the result to REPORTER_THEMES_PATH and updates the Reporter templates manifest.

When to use
-----------

Tagged: ``reporter``, ``pptx``, ``powerpoint``, ``template``, ``theme``, ``layout``, ``import``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - PPTX or PPTX Template
     - pptx_file
     - file
     - —
     - ✓
     - A .pptx or .potx file from which theme atoms, slide master, and layouts will be extracted.
   * - Theme ID (slug)
     - theme_id
     - string
     - —
     - 
     - Output folder name. Defaults to a slug of the PPTX clrScheme name.
   * - Display Name
     - display_name
     - string
     - —
     - 
     - Label shown in the Reporter theme picker. Defaults to the PPTX clrScheme name.
   * - Overwrite if exists
     - overwrite
     - string
     - no
     - 
     - When yes, replaces an existing theme folder with the same id; otherwise the worker errors if it already exists.
   * - Picker Category
     - category
     - string
     - pptxImport
     - 
     - Layout picker group label.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Theme
     - theme
     - text
     - Slug of the extracted theme; wire this into the Reporter worker theme input.
   * - Theme Filesystem Path
     - theme_path
     - text
     - Absolute path under REPORTER_THEMES_PATH where the envelope and media were written.
   * - Theme API URL
     - theme_url
     - text
     - Public URL for the envelope via the Reporter templates API.
   * - Layouts Extracted
     - layout_count
     - number
     - How many slide layouts were extracted from the PPTX.
   * - Media Files Extracted
     - media_count
     - number
     - How many media assets (images) were extracted from ppt/media/.
   * - Warnings
     - warnings
     - dataset
     - Per-layout fidelity warnings (unresolved schemeClr tokens, oversized media, unsupported placeholder types).

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>pptx_template_extract</code>. Schema hash: <code>f24ed326be99</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>