Как разработчик Python, вы можете легко программно преобразовывать свои HTML-файлы в PDF-документы в облаке. Такое преобразование может быть полезно при ведении записей или совместном использовании HTML-файлов в переносимой форме. В этой статье вы узнаете, как конвертировать документы HTML в PDF с помощью REST API в Python.
В этой статье должны быть раскрыты следующие темы:
- Преобразование HTML в PDF REST API и Python SDK
- Преобразование HTML в PDF с помощью REST API в Python
- Преобразование HTML в PDF и добавление водяного знака
- Преобразование HTML в PDF без использования облачного хранилища
- Преобразование HTML в PDF и загрузка напрямую
Преобразование HTML в PDF REST API и Python SDK
Для преобразования файлов HTML в PDF я буду использовать API Python SDK of GroupDocs.Conversion Cloud. Он позволяет конвертировать ваши документы и изображения любого поддерживаемого формата файлов в любой нужный вам формат. Вы можете легко конвертировать более 50 типов документов и изображений, таких как Word, PowerPoint, Excel, PDF, HTML, CAD, растровые изображения и т. д.
Вы можете установить GroupDocs.Conversion Cloud в свой проект Python с помощью следующей команды в консоли:
pip install groupdocs_conversion_cloud
Пожалуйста, получите свой идентификатор клиента и секрет клиента из панели управления, прежде чем приступить к выполнению шагов и доступных примеров кода. Получив свой идентификатор и секрет, добавьте код, как показано ниже:
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
Преобразование HTML в PDF с помощью REST API в Python
Вы можете преобразовать свой файл HTML в документы PDF, выполнив простые шаги, указанные ниже:
- Загрузить файл HTML в облако
- Конвертировать HTML в PDF в Python
- Скачать преобразованный файл
Загрузить документ
Во-первых, загрузите файл HTML в облако, используя приведенный ниже пример кода:
# создать экземпляр API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# запрос на загрузку файла
request = groupdocs_conversion_cloud.UploadFileRequest("sample.html", "C:\\Files\\sample.html", my_storage)
# загрузить образец файла
response = file_api.upload_file(request)
В результате загруженный HTML-файл будет доступен в разделе файлов вашей панели инструментов в облаке.
Преобразование HTML в PDF в Python
Вы можете легко преобразовать документы HTML в PDF программно, выполнив следующие действия:
- Создайте экземпляр ConvertApi
- Создайте экземпляр ConvertSettings
- Задайте путь к файлу HTML
- Назначьте «pdf» формату
- Укажите путь к выходному файлу
- Определите PdfConvertOptions, если требуется
- При желании задайте различные свойства, такие как dpi, margin\top, margin\left, fit\window и т. д.
- Создайте ConvertDocumentRequest с ConvertSettings
- Получите результаты, вызвав метод convert\document() с ConvertDocumentRequest.
В следующем примере кода показано, как преобразовать файл HTML в документ PDF с помощью REST API.
# Создайте необходимые экземпляры API
конвертировать_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# Подготовьте настройки конвертации
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "конвертироватьed"
# Варианты преобразования PDF
конвертироватьOptions = groupdocs_conversion_cloud.PdfConvertOptions()
конвертироватьOptions.center_window = True # Set position of the document's window on the screen
конвертироватьOptions.display_doc_title = True
конвертироватьOptions.dpi = 1024.0
конвертироватьOptions.fit_window = False
конвертироватьOptions.from_page = 1 # Start conversion from FromPage page
конвертироватьOptions.linearize = False # Linearize PDF Document for the Web
конвертироватьOptions.margin_top = 5
конвертироватьOptions.margin_left = 5
конвертироватьOptions.unembed_fonts = True # Make fonts not embedded
конвертироватьOptions.remove_pdfa_compliance = False # Remove Pdf-A Compliance
settings.конвертировать_options = конвертироватьOptions
# Преобразовать запрос документа
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# конвертировать
result = конвертировать_api.конвертировать_document(request)
# Сделанный
print("Document конвертироватьed: " + result[0].path)
Преобразование HTML в PDF с помощью REST API в Python
Загрузите преобразованный файл
Приведенный выше пример кода сохранит преобразованный PDF-файл в облаке. Вы можете загрузить его, используя следующий пример кода:
# Инициализация API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# создать запрос на скачивание файла
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)
# Загрузка файла
response = file_api.download_file(request)
# Переместите загруженный файл в свой рабочий каталог
shutil.move(response, "C:\\Files\\")
Преобразование HTML в PDF и добавление водяного знака
Вы можете программно конвертировать документы HTML в PDF и добавлять водяные знаки в преобразованные документы, выполнив следующие действия:
- Создайте экземпляр ConvertApi
- Создайте экземпляр ConvertSettings
- Задайте путь к файлу HTML
- Назначьте «pdf» формату
- Укажите путь к выходному файлу
- Создайте экземпляр WatermarkOptions
- Установите текст водяного знака, цвет, ширину, высоту и т. д.
- Определите PdfConvertOptions и назначьте WatermarkOptions
- Создайте ConvertDocumentRequest с ConvertSettings
- Преобразуйте, вызвав метод convert\document() с ConvertDocumentRequest.
В следующем примере кода показано, как преобразовать файл HTML в документ PDF и добавить водяной знак в преобразованный документ PDF с помощью REST API в Python. Пожалуйста, следуйте шагам, упомянутым ранее, чтобы загружать и скачивать файлы.
# инициализация API
конвертировать_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# определить настройки преобразования
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "конвертироватьed"
# определить параметры водяного знака
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Gray";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;
# определить параметры преобразования PDF
конвертироватьOptions = groupdocs_conversion_cloud.PdfConvertOptions()
конвертироватьOptions.watermark_options = watermark
settings.конвертировать_options = конвертироватьOptions
# создать запрос на преобразование документа
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# конвертировать
result = конвертировать_api.конвертировать_document(request)
print("Document конвертироватьed successfully: " + result[0].url)
Преобразование HTML в PDF и добавление водяного знака
Преобразование HTML в PDF без использования облачного хранилища
Вы можете конвертировать документы HTML в PDF без использования облачного хранилища, выполнив следующие действия:
- Создайте экземпляр ConvertApi
- Создайте ConvertDocumentDirectRequest и передайте запрошенный формат документа и путь к входному файлу.
- Получите результаты, вызвав метод convert\document\direct() с ConvertDocumentDirectRequest.
- При желании сохраните выходной файл по локальному пути, используя метод Shutil.move()
В следующем примере кода показано, как преобразовать файл HTML в документ PDF без использования облачного хранилища. Вы передадите входной файл в теле запроса и получите выходной файл в ответе API.
# Создайте необходимые экземпляры API
convert_api = groupdocs_conversion_cloud.КонвертироватьApi.from_keys(client_id, client_secret)
# Подготовить запрос
request = groupdocs_conversion_cloud.КонвертироватьDocumentDirectRequest("pdf", "C:\\Files\\sample.html")
# Конвертировать
result = convert_api.convert_document_direct(request)
# Переместите загруженный файл в свой рабочий каталог
shutil.move(result, "C:\\Files\\")
Преобразование HTML в PDF и загрузка напрямую
Вы можете легко преобразовать документы HTML в PDF программно, выполнив следующие действия:
- Создайте экземпляр ConvertApi
- Создайте экземпляр ConvertSettings
- Задайте путь к файлу HTML
- Назначьте «pdf» формату
- Установите «Нет» в выходной путь
- Создайте ConvertDocumentRequest с ConvertSettings
- Получите результаты, вызвав метод convert\document\download().
- При желании сохраните выходной файл по локальному пути, используя метод Shutil.move()
В следующем примере кода показано, как преобразовать HTML-файл в документ PDF и напрямую загрузить его с помощью REST API в Python. В ответ API должен вернуть преобразованный PDF-файл. Чтобы загрузить файл, выполните указанные выше действия.
# Создайте необходимые экземпляры API
convert_api = groupdocs_conversion_cloud.КонвертироватьApi.from_keys(client_id, client_secret)
# Подготовьте настройки конвертации
settings = groupdocs_conversion_cloud.КонвертироватьSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = None # leave OutputPath will result the output as document IOStream
# Подготовить запрос
request = groupdocs_conversion_cloud.КонвертироватьDocumentRequest(settings)
# Конвертировать
response = convert_api.convert_document_download(request)
# Переместите загруженный файл в свой рабочий каталог
shutil.move(response, "C:\\Files\\")
Попробуйте онлайн
Пожалуйста, попробуйте следующий бесплатный онлайн-инструмент преобразования HTML в PDF, разработанный с использованием вышеуказанного API. https://products.groupdocs.app/conversion/html-to-pdf
Заключение
В этой статье вы узнали, как конвертировать HTML-файлы в PDF-документы с помощью Python в облаке. Вы также узнали, как программно конвертировать файлы HTML в документы PDF без использования облачного хранилища. Кроме того, вы узнали, как добавить водяной знак в конвертированные PDF-документы с помощью Python. В этой статье также объясняется, как программно загрузить файл HTML в облако, а затем загрузить преобразованный файл PDF из облака. Вы можете узнать больше о GroupDocs.Conversion Cloud API, используя документацию. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на форуме.