Рендеры – Рендеринг 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 with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source HTML file
document_path = os.path.join(data_dir, "document.html")

# Initialize an HTML document from the file
doc = ah.HTMLDocument(document_path)

# Create an instance of the HTML Renderer
renderer = rn.HtmlRenderer()

# Prepare path to save the converted PDF
save_path = os.path.join(output_dir, "render-html-with-options.pdf")

# Create PDF rendering options and set custom page size
options = rp.PdfRenderingOptions()
options.page_setup.any_page = dr.Page(dr.Size(600, 200))

# Setup PDF encryption
options.encryption = rpe.PdfEncryptionInfo(
    user_password="user_pwd",
    owner_password="owner_pwd",
    permissions=rpe.PdfPermissions.PRINT_DOCUMENT,
    encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
)

# Create the PDF device with options and output path
device = rp.PdfDevice(options, save_path)

# Render HTML to PDF
renderer.render(device, doc)

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

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 with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source SVG file
doc_path = os.path.join(data_dir, "flower.svg")
save_path = os.path.join(output_dir, "render-svg-with-options.png")

# Initialize an SVG document from the file
doc = ah.dom.svg.SVGDocument(doc_path)

# Create an instance of the SVG Renderer
renderer = rn.SvgRenderer()

# Create the instance of Rendering Options and set a custom page-size
options = ri.ImageRenderingOptions()
options.page_setup.any_page = dr.Page(dr.Size(400, 300))

# Create the PNG device with options and output path
device = ri.ImageDevice(options, save_path)

# Render SVG to PNG
renderer.render(device, doc)

MhtmlRenderer

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

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

# Render MHTML to PDF with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source MHTML file
epub_path = os.path.join(data_dir, "document.mht")
save_path = os.path.join(output_dir, "render-mhtml-with-options.pdf")

# Open the MHTML file in binary mode
with open("document.mht", 'rb') as stream:

    # Create an instance of MHTML Renderer
    renderer = rn.MhtmlRenderer()

    # Create PDF rendering options and set a custom page size and background color
    options = rp.PdfRenderingOptions()
    options.page_setup.any_page = dr.Page(dr.Size(800, 400))
    options.background_color = pd.Color.bisque

    # Create an instance of PdfDevice for output
    device = rp.PdfDevice(options, save_path)

    # Render MHTML to PDF
    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 with custom page settings using Python

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

# Setup input and output directories
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Prepare path to the source EPUB file
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 in binary mode
with open(epub_path, "rb") as stream:

    # Create an instance of EPUB Renderer
    renderer = rn.EpubRenderer()

    # Create DOC rendering options and set a custom page size
    options = rd.DocRenderingOptions()
    options.page_setup.any_page = dr.Page(dr.Size(800, 400))

    # Create an instance of DocDevice for output
    device = rd.DocDevice(options, save_path)

    # Render EPUB to DOCX
    renderer.render(device, stream)

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