aipoch/pdf-ppt

When to Use

• Converting a research paper PDF into a literature-report PPTX with a standard academic slide structure (title → overview → results → conclusion).
• When the user requires figure-by-figure interpretation (including subpanels) and strict 1:1 mapping between each figure/table and slide content.
• When you must work offline-first (no external API calls) to extract text, figures, legends, and tables from a PDF.
• When the PPT must match a provided layout script (positions, aspect ratios, text boxes) and keep consistent styling across the deck.
• When the output narration must be professional Chinese, concise, and technically accurate.

Key Features

• Offline-first PDF parsing to extract:
  • Title, journal, publication date, section text
  • Figure images and legends grouped by figure number
  • Tables and (optionally) graphical abstract
• Full-paper summary in professional Chinese (background + key findings).
• Results interpretation aligned per figure/subfigure, avoiding vague references.
• PPTX generation with:
  • Fixed slide structure (Title / Overview / Figure slides / Final summary)
  • Layout constraints matching a v5-style deck (coordinates, font sizes)
  • Consistent panel-label styling and per-deck label color
  • Per-figure slide “Summary:” one-liner
• Integration guidance for PPTX editing via D:\\SKILL\\project\\PPTX\\SKILL.md.

Dependencies

• Local offline parsing workflow: references/offline-parsing.md (version: N/A, repository-local)
• Figure/table interpretation rules: references/figure-interpretation.md (version: N/A, repository-local)
• PPTX creation/editing skill: D:\\SKILL\\project\\PPTX\\SKILL.md (version: N/A, local path)
• Optional local mapping file: figure_titles_zh.txt (version: N/A, user/project-provided)

Example Usage

Input (user request)

Please convert this paper PDF into a literature-report PPT.
Requirements: interpret each figure, keep figure-to-text alignment, and follow the v5 layout rules.

Expected Workflow Output (offline-first → structured → PPTX)

1. Offline parse the PDF (no external APIs), following references/offline-parsing.md, and produce a local structured package:

   • Cleaned metadata text: title, journal/date, headings
   • Figure legends grouped by figure number
   • Extracted images named:
     • Figure_1.jpg, Figure_2.jpg, ...
   • Graphical abstract image (if present)
   • Draft explication.json aligned to figure order

2. Write Chinese content:

   • Full-paper summary (background + key findings)
   • Figure-by-figure Results interpretation (purpose → method → object → outcome)
   • Concise critical appraisal (core contributions + internal limitations)

3. Generate PPTX with the required slide structure and layout constraints:

   • Slide 1: Title + metadata (journal/date/presenter/report date)
   • Slide 2: Overview (two text boxes; graphical abstract if present)
   • Middle slides: one slide per figure/table in original order
   • Final slide: overall summary + critical appraisal

Minimal runnable “deck plan” (content-to-slide mapping)

{
  "deck_style": {
    "language": "zh-CN",
    "panel_label_color": "#065A82",
    "transition_preset": "fade",
    "entrance_preset": "appear"
  },
  "slides": [
    {
      "type": "title",
      "title": "<Paper Title>",
      "meta": {
        "journal": "<Journal>",
        "publication_date": "<YYYY-MM-DD>",
        "presenter": "XXX",
        "report_date": "<YYYY-MM-DD>"
      }
    },
    {
      "type": "overview",
      "background": "<Chinese background summary>",
      "findings": "<Chinese key findings summary>",
      "graphical_abstract": "Graphical_Abstract.jpg"
    },
    {
      "type": "figure",
      "figure_id": "Figure_1",
      "title": "Figure 1: <Chinese figure title if available>",
      "image": "Figure_1.jpg",
      "body_zh": [
        "**A** ...",
        "**B** ...",
        "**Summary:** ..."
      ]
    },
    {
      "type": "final_summary",
      "core_highlights": ["..."],
      "internal_limitations": ["..."]
    }
  ]
}

Implementation Details

1) Offline-first PDF collection (must not call external APIs)

Follow references/offline-parsing.md and produce a local structured output containing:

• Cleaned text fields:
  • title, journal, publication_date
  • section headings and key paragraphs (abstract/intro/results)
• Figures:
  • images exported and named Figure_1.jpg, Figure_2.jpg, ...
  • legends grouped by figure number
• Tables:
  • extracted table content and captions (as text or images, depending on the workflow)
• Graphical abstract:
  • capture image and approximate placement if present
• Draft explication.json:
  • ordered by figure appearance
  • each entry links legend → image filename → planned slide text blocks

Ignore supplementary items (e.g., Figure S1) unless explicitly requested.

2) Figure/table interpretation rules (Chinese, precise, aligned)

Use references/figure-interpretation.md and enforce:

• 1:1 mapping: every figure/table must be covered by exactly one corresponding slide section (or one slide if required).
• Each result paragraph must be complete:
  • experimental purpose → method → object → concrete outcome (increase/decrease, up/down, etc.)
• Avoid vague phrases like “as shown in the figure”.
• Remove any leading # markers from figure body lines.
• Bold leading panel labels and ranges:
  • A, A, B, A-C → **A**, **A, B**, **A-C**
• Add a one-sentence line at the end of each figure slide:
  • **Summary:** <one-sentence key result>
  • Style “Summary” like panel labels (bold + label color)

3) Figure titles and localization

• Slide titles should use: Figure X: <figure title> when a title can be extracted (e.g., from “Figure 1. ...”).
• Convert figure titles to Chinese when possible.
• Prefer a local mapping file figure_titles_zh.txt if available:
  • Format: Figure_1<TAB>Chinese Title

4) Consistent per-deck styling parameters

• Panel label color: randomly choose one per deck from:
  • #2C5F2D, #F96167, #065A82, #990011
• Apply the same chosen color across all slides.
• Animations:
  • Randomly choose one slide transition preset and one entrance preset per deck
  • Keep them consistent across all slides
  • Reveal order: title → text → image

5) PPT layout constraints (Match v5 slides)

If a user-provided layout script is accessible, follow it. Otherwise, use the following fixed coordinates (inches) and typography:

• Title slide
  • Title box: (2.0825, 1.796, 9.1683, 1.2), 32pt bold, centered
  • Metadata block (left = 4.8673, width = 6.0, height = 0.6):
    • Journal: top 4.5049, 18pt
    • Presenter/date: top 5.2327 and 5.9049, 16pt
• Overview slide
  • Background box: (0.6, 0.6, 5.8, 6.2)
  • Findings box: (0.6, 3.4, 5.8, 3.4)
  • Image: (7.0, 0.8, 5.8, 5.6)
• Figure slides
  • Title: (0.6, 0.2, 12.0, 0.6), 22pt bold
  • Text box: (0.7749, 1.5102, 4.7498, 2.861), 14pt
  • Image: (7.0, 1.0, 5.8, 5.8)
• Summary slide
  • Add borders
  • “Core Highlights” box: (0.6, 0.6, 5.8, 3.0)
  • “Internal Limitations” box: (6.7, 3.9, 6.0, 3.0)

6) PPTX editing integration

When creating or editing a .pptx, also follow the PPTX editing guidelines in:

• D:\\SKILL\\project\\PPTX\\SKILL.md