Экспорт презентаций в HTML с внешними связанными изображениями на Python

Обзор

По умолчанию Aspose.Slides экспортирует презентацию в автономный HTML‑файл. Изображения и другие ресурсы пишутся непосредственно в HTML, обычно в виде данных Base64. Это удобно, когда нужен один переносимый файл, но не всегда является лучшим форматом для веб‑сайта, CMS или конвейера серверного преобразования.

Используйте внешние ссылки на изображения, когда нужно:

уменьшить размер HTML‑документа;
кэшировать изображения отдельно в браузере или CDN;
просматривать, заменять, сжимать или постобрабатывать сгенерированные изображения после экспорта;
сохранить структуру вывода ближе к тому, что ожидает веб‑приложение.

Для общего рабочего процесса конвертации в HTML см. Convert PowerPoint Presentations to HTML. В этой статье рассматривается только часть экспорта, связанная с ссылками на изображения.

Как работает экспорт с привязанными изображениями

В .NET и Java интерфейс ILinkEmbedController представляет обратный вызов, который экспортер использует для решения, следует ли встраивать ресурс или ссылаться на него. В Python через .NET классы Python в данный момент не могут напрямую реализовать этот .NET‑интерфейс, поэтому практический рабочий процесс выглядит так:

Экспортировать презентацию в HTML с помощью HtmlOptions.
Использовать SlideImageFormat совместно с SVGOptions, чтобы слайды представлялись в HTML как SVG.
Переместить данные изображений Base64 из URL‑ов data: в отдельные файлы.
Заменить исходные URL‑ы data: относительными ссылками, например assets/resource-1.jpg.

Путь в файловой системе и URL в браузере – это разные понятия. Например, в примере ниже файлы изображений записываются в html-output/assets на диске, тогда как в HTML используются относительные URL‑ы типа assets/resource-1.jpg. Браузер разрешает такие URL относительно HTML‑файла, содержащего ссылку.

Экспорт HTML с привязанными изображениями

Следующий пример на Python создаёт выходной каталог, сохраняет туда HTML‑файл, помещает извлечённые изображения в подпапку assets и переписывает URL‑ы изображений Base64 в относительные ссылки. Пример извлекает общие форматы изображений Base64, когда Aspose.Slides предоставляет надёжное расширение файла. URL‑ы данных, которые не распознаны, остаются встроенными.

import base64
import os
import re

import aspose.slides as slides
import aspose.slides.export as slides_export


EXTENSIONS_BY_CONTENT_TYPE = {
    "image/jpeg": ".jpg",
    "image/png": ".png",
    "image/gif": ".gif",
    "image/bmp": ".bmp",
    "image/svg+xml": ".svg",
    "image/tiff": ".tiff",
    "image/x-emf": ".emf",
    "image/x-wmf": ".wmf",
}

DATA_URI_PATTERN = re.compile(
    r"data:(?P<content_type>[-\w.+]+/[-\w.+]+);base64,(?P<data>[A-Za-z0-9+/=\r\n]+)"
)


def export_presentation_to_html_with_linked_images(
    input_file_path,
    output_directory,
    asset_directory_name="assets",
):
    asset_directory = os.path.join(output_directory, asset_directory_name)

    os.makedirs(output_directory, exist_ok=True)
    os.makedirs(asset_directory, exist_ok=True)

    html_options = slides_export.HtmlOptions()
    html_options.html_formatter = slides_export.HtmlFormatter.create_document_formatter("", False)
    html_options.slide_image_format = slides_export.SlideImageFormat.svg(
        slides_export.SVGOptions()
    )

    html_file_path = os.path.join(output_directory, "presentation.html")

    with slides.Presentation(input_file_path) as presentation:
        presentation.save(html_file_path, slides_export.SaveFormat.HTML, html_options)

    externalize_base64_images(html_file_path, asset_directory, asset_directory_name)


def externalize_base64_images(html_file_path, asset_directory, asset_directory_name):
    with open(html_file_path, "r", encoding="utf-8-sig") as html_file:
        html_content = html_file.read()

    saved_resource_names = {}
    resource_index = 1

    def replace_data_uri(match):
        nonlocal resource_index

        data_uri = match.group(0)
        if data_uri in saved_resource_names:
            return saved_resource_names[data_uri]

        content_type = match.group("content_type").lower()
        extension = EXTENSIONS_BY_CONTENT_TYPE.get(content_type)
        if extension is None:
            return data_uri

        encoded_data = match.group("data")
        image_data = base64.b64decode(encoded_data)
        if len(image_data) == 0:
            return data_uri

        file_name = f"resource-{resource_index}{extension}"
        resource_index += 1

        file_path = os.path.join(asset_directory, file_name)
        with open(file_path, "wb") as image_file:
            image_file.write(image_data)

        linked_url = f"{asset_directory_name}/{file_name}"
        saved_resource_names[data_uri] = linked_url
        return linked_url

    updated_html_content = DATA_URI_PATTERN.sub(replace_data_uri, html_content)

    with open(html_file_path, "w", encoding="utf-8", newline="\n") as html_file:
        html_file.write(updated_html_content)


input_file_path = "presentation.pptx"
output_directory = "html-output"

export_presentation_to_html_with_linked_images(input_file_path, output_directory)

После экспорта в выходной папке может получиться такая структура:

html-output/
  presentation.html
  assets/
    resource-1.jpg
    resource-2.png

Точные файлы зависят от содержимого презентации и параметров экспорта. Например, растровые изображения обычно экспортируются как JPEG или PNG. Aspose.Slides может выбрать иной кодек изображения, чем использовался в исходной презентации, если это даёт меньший размер или более подходящий файл. Изображения с прозрачностью экспортируются как PNG.

Выбор URL‑ов для развертывания

В примере используется относительный префикс URL: assets/. Если presentation.html открывается из html-output/presentation.html, браузер загружает html-output/assets/resource-1.jpg.

Используйте другое имя каталога ресурсов или перепишите сгенерированные ссылки, когда файлы размещаются в другом месте:

Используйте assets/, когда каталог ресурсов находится рядом с HTML‑файлом.
Используйте ../assets/, когда каталог ресурсов расположен на один уровень выше HTML‑файла.
Используйте https://cdn.example.com/presentations/job-123/assets/, когда файлы загружены в CDN или статический файловый сервер.

В серверных приложениях используйте уникальный выходной каталог или префикс в объектном хранилище для каждой задачи конвертации, чтобы избежать перезаписи файлов от другого экспорта.

Когда лучше встраивать

Встроенный Base64 HTML всё ещё полезен, когда вывод должен быть одним файлом, например вложением письма, офлайн‑предпросмотром или документом, который будет перемещён без сопутствующей папки ресурсов. Привязанные изображения лучше подходят, когда HTML будет обслуживаться веб‑приложением, храниться в CMS, оптимизироваться конвейером сборки или кэшироваться браузерами независимо от HTML.

FAQ

Можно ли вынести только изображения и оставить другие ресурсы встроенными?

Да. В примере извлекаются только Base64‑URL‑ы image/*, типы контента которых перечислены в EXTENSIONS_BY_CONTENT_TYPE. Остальные URL‑ы данных остаются встроенными.

Почему расширение экспортированного изображения отличается от исходного в презентации?

Aspose.Slides может перекодировать растровые изображения во время экспорта HTML, чтобы уменьшить размер или повысить совместимость с браузерами. Например, изображение из исходного файла может быть записано как JPEG или PNG в зависимости от полученного результата.

Работают ли относительные URL‑ы после перемещения HTML‑файла?

Относительные URL‑ы работают только при сохранении той же относительной структуры папок. Если HTML ссылается на assets/resource-1.png, папка assets должна оставаться рядом с HTML‑файлом, если только вы не зададите иной префикс URL.

Должны ли серверные приложения повторно использовать один и тот же выходной каталог?

Нет. Используйте уникальный выходной каталог или префикс хранилища для каждой задачи конвертации. Это предотвращает коллизии имён файлов и перезапись ресурсов, созданных другим экспортом.

Получить полный фон слайда из презентации в виде изображения Замена изображений в коллекции изображений презентации