Рендеры – Рендеринг HTML, MHTML, EPUB и SVG на Python

Рендеры – Renderers

Пространство имен aspose.html.rendering состоит из множества объектов рендереров и соответствующих низкоуровневых классов опций, которые отвечают за рендеринг документов в реализации IDevice. Aspose.HTML for Python via .NET API предоставляет следующую реализацию рендереров: HtmlRenderer, SvgRenderer, MhtmlRenderer и EpubRenderer, которые используются для рендеринга HTML, SVG, MHTML и EPUB документов, соответственно.

В данной статье описываются поддерживаемые сценарии преобразования HTML-файлов в другие популярные форматы с помощью методов render() из пространства имен aspose.html.rendering.

HtmlRenderer

Класс HtmlRenderer можно использовать для рендеринга HTML-файлов в различные популярные форматы, позволяя настраивать параметры и контролировать результаты процесса. Давайте рассмотрим использование класса HtmlRenderer для рендеринга HTML в PDF с пользовательскими настройками результата:

1. Инициализируйте HTML-документ, используя класс HTMLDocument.
2. Создайте новый объект HtmlRenderer.
3. Создайте экземпляр класса PdfRenderingOptions и настройте параметры для выходного PDF-документа. Например, вы можете установить свойство any_page класса PageSetup для создания нового объекта Page с размерами 600 пикселей на 200 пикселей. Кроме того, можно настроить свойство encryption, указав пароли пользователя и владельца, разрешенные действия и алгоритм шифрования для выходного PDF-файла.
4. Используйте конструктор PdfDevice(options, savePath), чтобы создать объект класса PdfDevice.
5. Вызовите метод render(device, document) для рендеринга HTML в PDF с указанными параметрами рендеринга.

# Render HTML to PDF in Python with custom page settings

import os
import aspose.html as ah
import aspose.html.rendering as rn
import aspose.html.rendering.pdf as rp
import aspose.html.drawing as dr
import aspose.html.rendering.pdf.encryption as rpe

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

document_path = os.path.join(data_dir, "document.html")
save_path = os.path.join(output_dir, "render-html-with-options.pdf")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    with rn.HtmlRenderer() as renderer:
        # Configure PDF output
        options = rp.PdfRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(600, 200))
        options.encryption = rpe.PdfEncryptionInfo(
            user_password="user_pwd",
            owner_password="owner_pwd",
            permissions=rpe.PdfPermissions.PRINT_DOCUMENT,
            encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
        )

        # Render HTML to PDF
        with rp.PdfDevice(options, save_path) as device:
            renderer.render(device, document)

Опции рендеринга дают вам дополнительный контроль над процессом рендеринга. Чтобы узнать о них больше, прочитайте статью Опции рендеринга. Чтобы узнать больше о процессе рендеринга, обратитесь к статье Устройство рендеринга.

SvgRenderer

Класс SvgRenderer позволяет преобразовывать файлы SVG в другие форматы, такие как PDF, XPS, DOCX и форматы изображений. Следующий пример демонстрирует использование класса SvgRenderer для рендеринга SVG в PNG с заданием размера страницы:

1. Инициализируйте документ SVG. Используйте один из конструкторов SVGDocument() для создания экземпляра SVGDocument.
2. Создайте новый объект SvgRenderer.
3. Создайте экземпляр ImageRenderingOptions и задайте пользовательские параметры для выходного PNG-изображения. В примере мы указываем свойство any_page, которое устанавливает новый объект Page с размером страницы 400x300 пикселей.
4. Используйте конструктор ImageDevice(options, savePath), чтобы создать объект класса ImageDevice.
5. Вызовите метод render(device, document) для рендеринга SVG в PNG с указанными ImageRenderingOptions.

# Render SVG to PNG in Python with custom page settings

import os
import aspose.html as ah
import aspose.html.rendering.image as ri
import aspose.html.rendering as rn
import aspose.html.drawing as dr

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

doc_path = os.path.join(data_dir, "flower.svg")
save_path = os.path.join(output_dir, "render-svg-with-options.png")

# Load the SVG document
with ah.dom.svg.SVGDocument(doc_path) as document:
    with rn.SvgRenderer() as renderer:
        # Configure PNG output
        options = ri.ImageRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(400, 300))

        # Render SVG to PNG
        with ri.ImageDevice(options, save_path) as device:
            renderer.render(device, document)

MhtmlRenderer

В этом примере показано, как преобразовать MHTML-документ в PDF с помощью класса MhtmlRenderer с заданными параметрами рендеринга:

1. Откройте существующий документ MHTML.
2. Создайте экземпляр класса MhtmlRenderer с помощью конструктора MhtmlRenderer().
3. Инициализируйте класс PdfRenderingOptions и установите параметры рендеринга.
4. Создайте экземпляр класса PdfDevice.
5. Вызовите метод render(device, stream) для рендеринга MHTML в PDF.

# Render MHTML to PDF in Python with custom page settings

import os
import aspose.html.rendering.pdf as rp
import aspose.html.rendering as rn
import aspose.html.drawing as dr
import aspose.pydrawing as pd

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

mhtml_path = os.path.join(data_dir, "document.mht")
save_path = os.path.join(output_dir, "render-mhtml-with-options.pdf")

# Open the MHTML file
with open(mhtml_path, "rb") as stream:
    with rn.MhtmlRenderer() as renderer:
        # Configure PDF output
        options = rp.PdfRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(800, 400))
        options.background_color = pd.Color.bisque

        # Render MHTML to PDF
        with rp.PdfDevice(options, save_path) as device:
            renderer.render(device, stream)

EpubRenderer

Класс EpubRenderer позволяет конвертировать файлы EPUB в другие форматы, такие как PDF, XPS, DOCX и изображения. В следующих примерах на Python показано, как конвертировать EPUB в DOCX с заданием размера страницы:

1. Откройте существующий файл EPUB.
2. Создайте экземпляр класса EpubRenderer.
3. Инициализируйте класс DocRenderingOptions и установите параметры рендеринга.
4. Создайте экземпляр класса DocDevice.
5. Вызовите метод render(device, stream) для преобразования EPUB в DOCX.

# Render EPUB to DOCX in Python with custom page settings

import os
import aspose.html.rendering.doc as rd
import aspose.html.rendering as rn
import aspose.html.drawing as dr

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

epub_path = os.path.join(data_dir, "input.epub")
save_path = os.path.join(output_dir, "render-epub-with-options.docx")

# Open the EPUB file
with open(epub_path, "rb") as stream:
    with rn.EpubRenderer() as renderer:
        # Configure DOCX output
        options = rd.DocRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(800, 400))

        # Render EPUB to DOCX
        with rd.DocDevice(options, save_path) as device:
            renderer.render(device, stream)

Aspose.HTML предлагает бесплатные онлайн Конверторы, которые позволяют преобразовать файлы HTML, XHTML, MHTML, EPUB, XML и Markdown в различные популярные форматы. Вы можете легко конвертировать HTML-документы в PDF, XPS, DOCX, JPG, PNG, GIF, TIFF и другие. Просто выберите файл, выберите формат для преобразования, и все готово.