Jako vývojář Pythonu můžete snadno převádět soubory HTML na dokumenty PDF programově v cloudu. Taková konverze může být užitečná při vedení záznamů nebo sdílení souborů HTML v přenosné podobě. V tomto článku se dozvíte, jak převést HTML do PDF dokumentů pomocí REST API v Pythonu.
V tomto článku se budou zabývat následujícími tématy:
- Převod HTML do PDF REST API a Python SDK
- Převeďte HTML do PDF pomocí REST API v Pythonu
- Převést HTML do PDF a přidat vodoznak
- Převod HTML do PDF bez použití cloudového úložiště
- Převést HTML do PDF a stáhnout přímo
Převod HTML do PDF REST API a Python SDK
Pro převod HTML souborů do PDF budu používat Python SDK of GroupDocs.Conversion Cloud API. Umožňuje vám převést dokumenty a obrázky jakéhokoli podporovaného formátu souboru do libovolného formátu, který potřebujete. Můžete snadno převádět mezi více než 50 typy dokumentů a obrázků, jako jsou Word, PowerPoint, Excel, PDF, HTML, CAD, rastrové obrázky atd.
GroupDocs.Conversion Cloud můžete nainstalovat do svého projektu Python pomocí následujícího příkazu v konzole:
pip install groupdocs_conversion_cloud
Než začnete postupovat podle kroků a dostupných příkladů kódu, získejte své ID klienta a tajný klíč klienta z dashboard. Jakmile budete mít své ID a tajemství, přidejte kód, jak je uvedeno níže:
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 = ""
Převeďte HTML do PDF pomocí REST API v Pythonu
Soubor HTML můžete převést na dokumenty PDF pomocí následujících jednoduchých kroků:
- Nahrajte soubor HTML do cloudu
- Převést HTML do PDF v Pythonu
- Stáhnout převedený soubor
Nahrajte dokument
Nejprve nahrajte soubor HTML do cloudu pomocí níže uvedeného příkladu kódu:
# vytvořit instanci API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# žádost o nahrání souboru
request = groupdocs_conversion_cloud.UploadFileRequest("sample.html", "C:\\Files\\sample.html", my_storage)
# nahrát ukázkový soubor
response = file_api.upload_file(request)
V důsledku toho bude nahraný soubor HTML dostupný v sekce souborů vašeho řídicího panelu v cloudu.
Převeďte HTML do PDF v Pythonu
Dokumenty HTML do PDF můžete snadno převést programově podle následujících kroků:
- Vytvořte instanci ConvertApi
- Vytvořte instanci ConvertSettings
- Nastavte cestu k souboru HTML
- Přiřaďte formátu „pdf“.
- Zadejte cestu k výstupnímu souboru
- V případě potřeby definujte možnosti PdfConvertOptions
- Volitelně nastavte různé vlastnosti, jako je dpi, margin\top, margin\left, fit\window atd.
- Vytvořte ConvertDocumentRequest pomocí ConvertSettings
- Získejte výsledky voláním metody convert\document() pomocí ConvertDocumentRequest
Následující příklad kódu ukazuje, jak převést soubor HTML na dokument PDF pomocí rozhraní REST API.
# Vytvořte potřebné instance API
konvertovat_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# Připravte nastavení převodu
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "konvertovated"
# Možnosti převodu PDF
konvertovatOptions = groupdocs_conversion_cloud.PdfConvertOptions()
konvertovatOptions.center_window = True # Set position of the document's window on the screen
konvertovatOptions.display_doc_title = True
konvertovatOptions.dpi = 1024.0
konvertovatOptions.fit_window = False
konvertovatOptions.from_page = 1 # Start conversion from FromPage page
konvertovatOptions.linearize = False # Linearize PDF Document for the Web
konvertovatOptions.margin_top = 5
konvertovatOptions.margin_left = 5
konvertovatOptions.unembed_fonts = True # Make fonts not embedded
konvertovatOptions.remove_pdfa_compliance = False # Remove Pdf-A Compliance
settings.konvertovat_options = konvertovatOptions
# Žádost o převod dokumentu
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# konvertovat
result = konvertovat_api.konvertovat_document(request)
# Hotovo
print("Document konvertovated: " + result[0].path)
Převeďte HTML do PDF pomocí REST API v Pythonu
Stáhněte si převedený soubor
Výše uvedená ukázka kódu uloží převedený soubor PDF do cloudu. Můžete si jej stáhnout pomocí následující ukázky kódu:
# Inicializace API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# vytvořit žádost o stažení souboru
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)
# stáhnout soubor
response = file_api.download_file(request)
# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(response, "C:\\Files\\")
Převést HTML do PDF a přidat vodoznak
Dokumenty HTML můžete převést na dokumenty PDF a přidat vodoznaky do převedených dokumentů programově podle následujících kroků:
- Vytvořte instanci ConvertApi
- Vytvořte instanci ConvertSettings
- Nastavte cestu k souboru HTML
- Přiřaďte formátu „pdf“.
- Zadejte cestu k výstupnímu souboru
- Vytvořte instanci WatermarkOptions
- Nastavte text vodoznaku, barvu, šířku, výšku atd.
- Definujte PdfConvertOptions a přiřaďte WatermarkOptions
- Vytvořte ConvertDocumentRequest pomocí ConvertSettings
- Převeďte voláním metody convert\document() pomocí ConvertDocumentRequest
Následující příklad kódu ukazuje, jak převést soubor HTML na dokument PDF a přidat vodoznak do převedeného dokumentu PDF pomocí rozhraní REST API v Pythonu. Při nahrávání a stahování souborů postupujte podle výše uvedených kroků.
# inicializace api
konvertovat_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# definovat nastavení převodu
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "konvertovated"
# definovat možnosti vodoznaku
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;
# definovat možnosti převodu PDF
konvertovatOptions = groupdocs_conversion_cloud.PdfConvertOptions()
konvertovatOptions.watermark_options = watermark
settings.konvertovat_options = konvertovatOptions
# vytvořit žádost o převod dokumentu
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# konvertovat
result = konvertovat_api.konvertovat_document(request)
print("Document konvertovated successfully: " + result[0].url)
Převést HTML do PDF a přidat vodoznak
Převod HTML do PDF bez použití cloudového úložiště
Dokumenty HTML můžete převést na PDF bez použití cloudového úložiště podle následujících kroků:
- Vytvořte instanci ConvertApi
- Vytvořte ConvertDocumentDirectRequest a předejte požadovaný formát dokumentu a cestu k vstupnímu souboru
- Získejte výsledky voláním metody convert\document\direct() pomocí ConvertDocumentDirectRequest
- Volitelně uložte výstupní soubor do místní cesty pomocí metody shutil.move().
Následující příklad kódu ukazuje, jak převést soubor HTML na dokument PDF bez použití cloudového úložiště. Vstupní soubor předáte v těle požadavku a výstupní soubor obdržíte v odpovědi API.
# Vytvořte potřebné instance API
convert_api = groupdocs_conversion_cloud.KonvertovatApi.from_keys(client_id, client_secret)
# Připravte žádost
request = groupdocs_conversion_cloud.KonvertovatDocumentDirectRequest("pdf", "C:\\Files\\sample.html")
# Konvertovat
result = convert_api.convert_document_direct(request)
# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(result, "C:\\Files\\")
Převést HTML do PDF a stáhnout přímo
Dokumenty HTML do PDF můžete snadno převést programově podle následujících kroků:
- Vytvořte instanci ConvertApi
- Vytvořte instanci ConvertSettings
- Nastavte cestu k souboru HTML
- Přiřaďte formátu „pdf“.
- Nastavte „None“ na výstupní cestu
- Vytvořte ConvertDocumentRequest pomocí ConvertSettings
- Výsledky získáte voláním metody convert\document\download()
- Volitelně uložte výstupní soubor do místní cesty pomocí metody shutil.move().
Následující příklad kódu ukazuje, jak převést soubor HTML na dokument PDF a stáhnout jej přímo pomocí REST API v Pythonu. API jako odpověď vrátí převedený soubor PDF. Chcete-li nahrát soubor, postupujte podle výše uvedených kroků.
# Vytvořte potřebné instance API
convert_api = groupdocs_conversion_cloud.KonvertovatApi.from_keys(client_id, client_secret)
# Připravte nastavení převodu
settings = groupdocs_conversion_cloud.KonvertovatSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = None # leave OutputPath will result the output as document IOStream
# Připravte žádost
request = groupdocs_conversion_cloud.KonvertovatDocumentRequest(settings)
# Konvertovat
response = convert_api.convert_document_download(request)
# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(response, "C:\\Files\\")
Vyzkoušejte online
Vyzkoušejte prosím následující bezplatný online nástroj pro převod HTML do PDF, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/conversion/html-to-pdf
Závěr
V tomto článku jste se naučili, jak převést soubory HTML na dokumenty PDF pomocí Pythonu v cloudu. Také jste se naučili, jak převádět soubory HTML na dokumenty PDF bez programového použití cloudového úložiště. Navíc jste se naučili, jak přidat vodoznak do převedených dokumentů PDF pomocí Pythonu. Tento článek také vysvětluje, jak programově nahrát soubor HTML do cloudu a poté stáhnout převedený soubor PDF z cloudu. Další informace o GroupDocs.Conversion Cloud API se můžete dozvědět pomocí dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat a pracovat s našimi API přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností nás neváhejte kontaktovat na fóru.