Aspose.Slides FOSS
Python
Як створювати презентації в Python

Як створювати презентації в Python

Aspose.Slides FOSS for Python lets you create PowerPoint presentations entirely in Python with no dependency on Microsoft Office. This guide shows how to create a new presentation, add slides and shapes, format text, and save the result.

Покроковий посібник

Крок 1: Встановіть пакет

Встановіть Aspose.Slides FOSS з PyPI. Потрібен Python 3.10 або новіший.

pip install aspose-slides-foss

Перевірте встановлення:

import aspose.slides_foss as slides
print("Aspose.Slides FOSS ready")

The lxml залежність встановлюється автоматично. Інші системні пакети не потрібні.

Крок 2: Імпорт необхідних модулів

Імпортуйте пакет і SaveFormat enum, необхідний для збереження.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
from aspose.slides_foss import ShapeType

Усі константи типу форми розташовані в aspose.slides_foss.ShapeType. Усі типи форматування (FillType, NullableBool) також знаходяться в aspose.slides_foss.

Крок 3: Створіть презентацію

Використовуйте slides.Presentation() як менеджер контексту. Нова презентація починається з одного порожнього слайду.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    print(f"Slides in new presentation: {len(prs.slides)}")
    # work with prs inside this block
    prs.save("output.pptx", SaveFormat.PPTX)

Важливо: Завжди відкривайте та використовуйте Presentation всередині with блоку. Не зберігайте посилання поза with оператором; ресурси не будуть вивільнені коректно.

Крок 4: Доступ до слайду

Перший слайд має індекс 0. Порожня презентація містить саме один слайд.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]  # zero-based index
    print(f"Slide at index 0: {slide}")
    prs.save("output.pptx", SaveFormat.PPTX)

Крок 5: Додайте форму

Використовуйте slide.shapes.add_auto_shape() для додавання AutoShape. Параметри такі (shape_type, x, y, width, height) все в пунктах (1 пункт = 1/72 дюйма; стандартний слайд — 720 × 540 pt).

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Rectangle at (50, 50) with 400 wide and 120 tall
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 120)

    # Attach a text frame
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")

    prs.save("with-shape.pptx", SaveFormat.PPTX)

Крок 6: Збережіть презентацію

Виклик prs.save(path, SaveFormat.PPTX) перед with блок виходить. PPTX — єдиний підтримуваний формат виводу.

prs.save("result.pptx", SaveFormat.PPTX)

Файл записується атомарно; якщо під час виклику виникне помилка, файл виводу не буде створено.

Повний робочий приклад

Наступний скрипт створює презентацію з двома слайдами: форму заголовка на першому слайді та таблицю на другому.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    # --- Slide 1: title shape ---
    slide1 = prs.slides[0]
    title = slide1.shapes.add_auto_shape(ShapeType.RECTANGLE, 40, 40, 640, 80)
    tf = title.add_text_frame("Q1 Results: Executive Summary")
    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 32
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)

    # --- Slide 2: table ---
    prs.slides.add_empty_slide(prs.layout_slides[0])
    slide2 = prs.slides[1]
    table = slide2.shapes.add_table(40, 40, [200.0, 120.0, 120.0], [40.0, 40.0, 40.0])
    headers = ["Region", "Revenue", "Growth"]
    data = [
        ["North", "$1.2M", "+8%"],
        ["South", "$0.9M", "+4%"],
    ]
    for col, header in enumerate(headers):
        table.rows[0][col].text_frame.text = header
    for row_idx, row_data in enumerate(data):
        for col, cell_text in enumerate(row_data):
            table.rows[row_idx + 1][col].text_frame.text = cell_text

    prs.save("q1-results.pptx", SaveFormat.PPTX)

print("Saved q1-results.pptx")

Типові проблеми та їх вирішення

ResourceWarning: unclosed Presentation

Ви створюєте екземпляр Presentation без with блок. Завжди використовуйте:

with slides.Presentation() as prs:
    ...

AttributeError: __enter__

Якщо ви бачите цю помилку, перевірте, чи ви імпортували aspose.slides_foss (не aspose.slides). Ім’я пакету на PyPI — aspose-slides-foss і імпорт під час виконання — aspose.slides_foss.

TypeError: SaveFormat.PPTX is not callable

SaveFormat.PPTX — це член enum, а не функція. Використовуйте його як prs.save("file.pptx", SaveFormat.PPTX).

Часті запитання

Який розмір слайду за замовчуванням?

Новий Presentation() створює слайди стандартного розміру 10 × 7,5 дюйма (720 × 540 пунктів). Змінення розміру слайдів ще не підтримується в цьому випуску.

Чи можу я додати більше одного слайду?

Так. Викличте prs.slides.add_empty_slide(prs.layout_slides[0]) щоб додати порожній слайд і отримати його за індексом:

prs.slides.add_empty_slide(prs.layout_slides[0])
slide2 = prs.slides[1]

Чи можу я відкрити існуючий файл і додати слайди?

Так:

with slides.Presentation("existing.pptx") as prs:
    prs.slides.add_empty_slide(prs.layout_slides[0])
    prs.save("existing.pptx", SaveFormat.PPTX)

У які формати я можу зберігати?

Тільки SaveFormat.PPTX підтримується. Експорт у PDF, HTML, SVG або зображення не доступний у цьому випуску.

Див. також

 Українська