Export

Overview#

Present supports two export formats: PPTX (PowerPoint) for further editing and collaboration, and PDF for distribution and archival. Both formats preserve the full presentation structure including Arabic right-to-left content, branded templates, and chart layouts.

PPTX Export#

Export a presentation as a native PowerPoint file:

curl -X POST http://localhost:8011/api/v1/presentations/{pres_id}/export/pptx \
  -H "Authorization: Bearer $TOKEN" \
  --output presentation.pptx

The PPTX file is a standard Office Open XML document that opens in Microsoft PowerPoint, LibreOffice Impress, and Google Slides. It includes:

• Slide content with proper formatting
• Template branding (if a template was used)
• Midnight Gold theme styling (for unbranded presentations)
• Arabic RTL text alignment for Arabic content
• Speaker notes (if generated)

When to Use PPTX#

• Further editing is needed before presenting
• The presentation will be modified by multiple team members
• Custom animations or transitions will be added
• The file needs to be uploaded to a collaboration platform

PDF Export#

Export a presentation as a PDF document:

curl -X POST http://localhost:8011/api/v1/presentations/{pres_id}/export/pdf \
  -H "Authorization: Bearer $TOKEN" \
  --output presentation.pdf

PDF export renders each slide as a page in a read-only document. This is the preferred format for:

• Final distribution to stakeholders
• Archival and record-keeping
• Email attachments
• Printing

Arabic RTL Support#

Both PPTX and PDF exports handle Arabic content correctly:

• Text direction -- Arabic text flows right-to-left
• Paragraph alignment -- Text is right-aligned by default in Arabic slides
• Mixed content -- Slides with both Arabic and English content maintain correct directionality for each language
• Numbers -- Numeric values within Arabic text use Eastern Arabic numerals where appropriate

# Generate an Arabic presentation and export to PDF
curl -X POST http://localhost:8011/api/v1/presentations/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "prompt": "استراتيجية التحول الرقمي للوزارة ٢٠٢٥",
    "language": "ar",
    "slide_count": 10
  }'

# Export to PDF
curl -X POST http://localhost:8011/api/v1/presentations/{pres_id}/export/pdf \
  -H "Authorization: Bearer $TOKEN" \
  --output strategy_2025.pdf

Comments and Review#

Before exporting, teams can add comments to review slides:

Add a Comment#

curl -X POST http://localhost:8011/api/v1/presentations/{pres_id}/comments \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "slide_index": 3,
    "text": "Please update the budget figures with Q4 actuals",
    "author": "Ahmed Al Mansoori"
  }'

View Comments#

curl "http://localhost:8011/api/v1/presentations/{pres_id}/comments?slide_index=3" \
  -H "Authorization: Bearer $TOKEN"

Response:

[
  {
    "comment_id": "cmt-001",
    "presentation_id": "pres-a1b2c3",
    "slide_index": 3,
    "element_id": "",
    "text": "Please update the budget figures with Q4 actuals",
    "author": "Ahmed Al Mansoori",
    "created_at": "2024-01-15T14:30:00Z"
  }
]

Comments are available through the API and dashboard. They serve as a review mechanism before final export and distribution.

Export Workflow#

A typical workflow:

1. Generate the presentation from a prompt
2. Review slides in the dashboard
3. Edit individual slides with AI-powered refinement
4. Comment for team review
5. Export to PPTX for final formatting, or PDF for distribution