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

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

Aspose.Slides FOSS for Python дозволяє створювати презентації PowerPoint повністю на Python без залежності від Microsoft Office. У цьому посібнику показано, як створити нову презентацію, додати слайди та форми, форматувати текст і зберегти результат.

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

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

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

pip install aspose-slides-foss

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

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

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

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

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

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 пунктів).

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 або зображення недоступний у цій редакції.

Дивіться також

 Українська