Конвертировать HTML в PDF на Python

PDF-файл – это документ с фиксированным макетом, который включает в себя текст, графику, гиперссылки, кнопки, поля формы, мультимедиа и другую информацию, необходимую для отображения. PDF-файлы имеют высокий уровень безопасности, что обеспечивает защиту паролем, шифрование и цифровые подписи для защиты конфиденциальной информации. Они также универсально доступны и легко просматриваются на любом устройстве без специального программного обеспечения. Кроме того, PDF-файлы компактны и позволяют сжимать файлы высокого качества в меньшие размеры, что делает их идеальными для совместного использования и хранения.

В этом руководстве вы найдете информацию о том, как преобразовать HTML-документ в формат файла переносимого формата документа (PDF) с помощью Aspose.HTML for Python via .NET. Мы подробно рассмотрим, как конвертировать HTML в PDF с помощью методов convert_html() класса Converter и как применять PdfSaveOptions. Кроме того, вы можете попробовать онлайн-конвертер HTML, чтобы протестировать функциональность Aspose.HTML и конвертировать HTML на лету.

Чтобы продолжить работу с этим руководством, установите и настройте Aspose.HTML for Python via .NET в своем проекте Python. Наши примеры кода помогут вам конвертировать HTML в PDF и создавать PDF-файлы с помощью библиотеки Python.

HTML в PDF с помощью одной строки кода

Методы класса Converter в основном используются как самый простой способ конвертировать HTML-код в различные форматы. Вы можете конвертировать HTML в PDF в своем приложении Python буквально с помощью одной строки кода!

1# Convert HTML to PDF in Python
2
3import aspose.html.converters as conv
4import aspose.html.saving as sav
5
6# Convert HTML to PDF
7conv.Converter.convert_html("document.html", sav.PdfSaveOptions(), "output.pdf")

Example-ConvertHtmlToPdfInOneLine.py hosted with ❤ by GitHub

Онлайн HTML Конвертер

Вы можете протестировать возможности Aspose.HTML for Python via .NET и выполнить преобразование HTML в реальном времени. Просто загрузите файл HTML из локальной файловой системы или URL, выберите нужный формат вывода и запустите предоставленный пример кода. В примере используются параметры сохранения по умолчанию. После завершения вы мгновенно получите преобразованный файл в выбранном вами формате.

Конвертировать HTML в PDF с указанием PdfSaveOptions

С помощью Aspose.HTML for Python via .NET вы можете конвертировать файлы программным способом с полным контролем над широким диапазоном параметров преобразования. Чтобы преобразовать HTML в PDF с указанием PdfSaveOptions, вам необходимо выполнить несколько шагов:

Загрузите HTML-файл, используя один из конструкторов HTMLDocument() класса HTMLDocument. В приведенном выше примере мы инициализируем HTML-документ из файла.
Создайте новый объект PdfSaveOptions и укажите необходимые свойства. Класс PdfSaveOptions предоставляет множество свойств, которые дают вам полный контроль над широким диапазоном параметров и улучшают процесс преобразования HTML в PDF.
Используйте метод convert_html() класса Converter. В следующем примере вам необходимо передать HTMLDocument, PdfSaveOptions и путь к выходному файлу методу Convert_html().

В следующем примере кода Python показано, как использовать PdfSaveOptions и создать PDF-файл с настраиваемыми параметрами сохранения:

 1# Convert HTML to PDF in Python with custom settings
 2
 3import os
 4import aspose.html as ah
 5import aspose.html.converters as conv
 6import aspose.html.drawing as dr
 7import aspose.html.saving as sav
 8import aspose.pydrawing as pd
 9import aspose.html.rendering.pdf.encryption as rpe
10
11# Prepare input and output paths
12input_dir = "data"
13output_dir = "output"
14os.makedirs(output_dir, exist_ok=True)
15
16input_path = os.path.join(input_dir, "document.html")
17output_path = os.path.join(output_dir, "document-options.pdf")
18
19# Load the HTML document
20with ah.HTMLDocument(input_path) as document:
21    # Configure PDF output
22    options = sav.PdfSaveOptions()
23    options.page_setup.any_page = dr.Page(
24        dr.Size(800, 600),
25        dr.Margin(10, 10, 10, 10)
26    )
27    options.background_color = pd.Color.bisque
28
29    document_info = options.document_info
30    document_info.title = "Aspose HTML Example"
31    document_info.author = "Your Name"
32    document_info.subject = "PDF Conversion"
33    document_info.keywords = "Aspose, HTML, PDF"
34
35    options.encryption = rpe.PdfEncryptionInfo(
36        user_password="user123",
37        owner_password="owner123",
38        permissions=(
39            rpe.PdfPermissions.PRINT_DOCUMENT
40            | rpe.PdfPermissions.EXTRACT_CONTENT
41        ),
42        encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
43    )
44
45    # Convert HTML to PDF
46    conv.Converter.convert_html(document, options, output_path)

Example-ConvertHtmlToPdfWithSaveOptions.py hosted with ❤ by GitHub

В этом примере мы преобразуем документ HTML в файл PDF, используя параметры сохранения. Этот процесс включает в себя инициализацию HTML-документа, настройку пользовательских параметров сохранения, таких как размер страницы, encryption и document_info, а затем выполнение преобразования. Наконец, преобразованный PDF-файл сохраняется в указанном выходном каталоге.

Оценить качество конвертации вы можете, попробовав наш продукт. На следующем рисунке показан результат преобразования файла aspose.html в формат PDF:

Текст «На рисунке показан файл aspose.html»

Класс PDFSaveOptions

Aspose.HTML for Python via .NET предоставляет класс PdfSaveOptions, который дает вам больше контроля над сохранением документов в формате PDF. Некоторые свойства этого класса наследуют свойства базовых классов, например PdfRenderingOptions или RenderingOptions. Использование PdfSaveOptions позволяет настроить процесс рендеринга; вы можете указать размер страницы, поля, права доступа к файлу, Css и т. д. Вот описание свойств, доступных в PdfSaveOptions:

page_setup – это свойство обеспечивает доступ к объекту PageSetup, используемому для настройки макета и настроек выходных страниц PDF в соответствии с конкретными требованиями к печати или отображению.
horizontal_resolution – это свойство контролирует горизонтальное разрешение как для внутренних изображений, используемых во время обработки, так и для любых внешних изображений, включенных в HTML. По умолчанию установлено значение 300 dpi.
vertical_resolution – аналогично свойству horizontal_resolution, это свойство управляет вертикальным разрешением внутренних и внешних изображений во время создания PDF-файла. Как и его горизонтальный аналог, по умолчанию оно составляет 300 точек на дюйм.
background_color – это свойство устанавливает или извлекает цвет фона, который заполняет каждую страницу PDF-документа. Значение по умолчанию – transparent, но его можно настроить в соответствии с брендингом или эстетическими предпочтениями, обеспечивая единообразие на всех страницах.
css – это свойство использует объект CssOptions для настройки обработки свойств CSS во время преобразования HTML в PDF. Это позволяет точно контролировать, как стили HTML интерпретируются и применяются в конечном PDF-файле.
document_info – это свойство содержит метаданные и информацию о выходном PDF-документе, такую как название, автор, тема и ключевые слова. Эти метаданные помогают управлять документами, индексировать их и обеспечивать возможность поиска, делая PDF-файл более информативным и организованным.
form_field_behaviour – это свойство определяет поведение полей интерактивной формы в сгенерированном PDF-файле.
jpeg_quality – это свойство определяет качество сжатия JPEG, используемое для изображений, встроенных в документ PDF. Качество по умолчанию установлено на 95, что обеспечивает хороший баланс между точностью изображения и размером файла. Установка этого свойства позволяет оптимизировать размер файла или качество изображения в соответствии с вашими конкретными потребностями.
encryption – это свойство предоставляет подробную информацию о шифровании PDF-документа, включая защиту паролем и настройки разрешений. Если оно не настроено, шифрование не применяется, но установка этого свойства позволяет безопасно распространять и контролировать доступ к конфиденциальному содержимому PDF.
is_tagged_pdf – если установлено значение true, в PDF-документе создается макет с тегами, что повышает доступность для пользователей с ограниченными возможностями. Это гарантирует, что контент правильно структурирован и доступен для навигации с использованием вспомогательных технологий, а также соответствует стандартам доступности.

Преобразование HTML в PDF с использованием свойства `form_field_behaviour`

Aspose.HTML for Python via .NET предлагает свойство form_field_behaviour класса PdfSaveOptions для выравнивания PDF-документов после их преобразования из HTML или MHTML. Это свойство используется для указания поведения полей формы в документе PDF. Если для параметра установлено значение FormFieldBehaviour.FLATTENED, все поля формы в PDF-документе будут сведены.

 1# Convert HTML to PDF and flatten form fields in Python
 2
 3import os
 4import aspose.html as ah
 5import aspose.html.converters as conv
 6import aspose.html.saving as sav
 7import aspose.html.rendering.pdf as rp
 8
 9# Prepare input and output paths
10data_dir = "data"
11output_dir = "output"
12os.makedirs(output_dir, exist_ok=True)
13
14source_path = os.path.join(data_dir, "SampleHtmlForm.html")
15result_path = os.path.join(output_dir, "form-flattened.pdf")
16
17# Load the HTML form
18with ah.HTMLDocument(source_path) as doc:
19
20    # Flatten form fields in the output PDF
21    options = sav.PdfSaveOptions()
22    options.form_field_behaviour = rp.FormFieldBehaviour.FLATTENED
23
24    # Convert the HTML form to PDF
25    conv.Converter.convert_html(doc, options, result_path)

Example-ConvertHtmlToPdfAndFlattenPdf.py hosted with ❤ by GitHub

Как конвертировать HTML в XPS

Aspose.HTML for Python via .NET поддерживает преобразование HTML в XPS. Для этого вам следует использовать XpsSaveOptions для получения объекта параметров сохранения, который передается методу convert_html():

options = sav.XpsSaveOptions()

Использование XpsSaveOptions позволяет настроить процесс рендеринга; вы можете указать свойства page_setup, background_color, css, horizontal_resolution и vertical_resolution.

Загрузите библиотеку Aspose.HTML for Python via .NET, чтобы успешно, быстро и легко конвертировать документы HTML, MHTML, EPUB, SVG и Markdown в самые популярные форматы.

Вы можете загрузить полные примеры и файлы данных с GitHub.

Aspose.HTML предлагает бесплатный онлайн Конвертер HTML в PDF, который конвертирует HTML в PDF с высоким качеством, просто и быстро. Просто загрузите, конвертируйте файлы и получите результат через несколько секунд!

Конвертер HTML Конвертировать HTML в DOCX