En tant que développeur Python, vous pouvez facilement convertir vos fichiers HTML en documents PDF par programmation sur le cloud. Une telle conversion peut être utile pour conserver des enregistrements ou partager des fichiers HTML sous une forme portable. Dans cet article, vous apprendrez à convertir des documents HTML en PDF à l’aide d’une API REST en Python.
Les sujets suivants seront traités dans cet article :
- API REST de conversion HTML vers PDF et SDK Python
- Convertir HTML en PDF à l’aide de l’API REST en Python
- Convertir HTML en PDF et ajouter un filigrane
- Conversion HTML en PDF sans utiliser Cloud Storage
- Convertir HTML en PDF et télécharger directement
API REST de conversion HTML vers PDF et SDK Python
Pour convertir des fichiers HTML en PDF, j’utiliserai l’API Python SDK of GroupDocs.Conversion Cloud. Il vous permet de convertir vos documents et images de n’importe quel format de fichier pris en charge vers n’importe quel format dont vous avez besoin. Vous pouvez facilement convertir plus de 50 types de documents et d’images tels que Word, PowerPoint, Excel, PDF, HTML, CAO, images raster, etc.
Vous pouvez installer GroupDocs.Conversion Cloud dans votre projet Python à l’aide de la commande suivante dans la console :
pip install groupdocs_conversion_cloud
Veuillez obtenir votre ID client et votre secret client à partir du tableau de bord avant de commencer à suivre les étapes et les exemples de code disponibles. Une fois que vous avez votre identifiant et votre secret, veuillez ajouter le code comme indiqué ci-dessous :
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 = ""
Convertir HTML en PDF à l’aide de l’API REST en Python
Vous pouvez convertir votre fichier HTML en documents PDF en suivant les étapes simples mentionnées ci-dessous :
- Télécharger le fichier HTML dans le Cloud
- Convertir HTML en PDF en Python
- Télécharger le fichier converti
Télécharger le document
Tout d’abord, chargez le fichier HTML dans le cloud à l’aide de l’exemple de code ci-dessous :
# créer une instance de l'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# demande de téléchargement de fichier
request = groupdocs_conversion_cloud.UploadFileRequest("sample.html", "C:\\Files\\sample.html", my_storage)
# télécharger un exemple de fichier
response = file_api.upload_file(request)
Par conséquent, le fichier HTML téléchargé sera disponible dans la section fichiers de votre tableau de bord sur le cloud.
Convertir HTML en PDF en Python
Vous pouvez facilement convertir des documents HTML en PDF par programmation en suivant les étapes ci-dessous :
- Créer une instance de ConvertApi
- Créer une instance de ConvertSettings
- Définir le chemin du fichier HTML
- Attribuez “pdf” au format
- Indiquez le chemin du fichier de sortie
- Définissez PdfConvertOptions si nécessaire
- Définissez éventuellement diverses propriétés telles que dpi, margin\top, margin\left, fit\window, etc.
- Créer ConvertDocumentRequest avec ConvertSettings
- Obtenez des résultats en appelant la méthode convert\document() avec ConvertDocumentRequest
L’exemple de code suivant montre comment convertir votre fichier HTML en document PDF à l’aide d’une API REST.
# Créer les instances d'API nécessaires
convertir_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# Préparer les paramètres de conversion
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "convertired"
# Options de conversion PDF
convertirOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertirOptions.center_window = True # Set position of the document's window on the screen
convertirOptions.display_doc_title = True
convertirOptions.dpi = 1024.0
convertirOptions.fit_window = False
convertirOptions.from_page = 1 # Start conversion from FromPage page
convertirOptions.linearize = False # Linearize PDF Document for the Web
convertirOptions.margin_top = 5
convertirOptions.margin_left = 5
convertirOptions.unembed_fonts = True # Make fonts not embedded
convertirOptions.remove_pdfa_compliance = False # Remove Pdf-A Compliance
settings.convertir_options = convertirOptions
# Convertir la demande de document
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# convertir
result = convertir_api.convertir_document(request)
# Fait
print("Document convertired: " + result[0].path)
Convertir HTML en PDF à l’aide de l’API REST en Python
Télécharger le fichier converti
L’exemple de code ci-dessus enregistrera le fichier PDF converti sur le cloud. Vous pouvez le télécharger à l’aide de l’exemple de code suivant :
# Initialisation de l'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# créer une demande de fichier de téléchargement
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)
# télécharger un fichier
response = file_api.download_file(request)
# Déplacez le fichier téléchargé dans votre répertoire de travail
shutil.move(response, "C:\\Files\\")
Convertir HTML en PDF et ajouter un filigrane
Vous pouvez convertir des documents HTML en PDF et ajouter des filigranes aux documents convertis par programmation en suivant les étapes ci-dessous :
- Créer une instance de ConvertApi
- Créer une instance de ConvertSettings
- Définir le chemin du fichier HTML
- Attribuez “pdf” au format
- Indiquez le chemin du fichier de sortie
- Créer une instance de WatermarkOptions
- Définissez le texte du filigrane, la couleur, la largeur, la hauteur, etc.
- Définissez les PdfConvertOptions et attribuez WatermarkOptions
- Créer ConvertDocumentRequest avec ConvertSettings
- Convertir en appelant la méthode convert\document() avec ConvertDocumentRequest
L’exemple de code suivant montre comment convertir un fichier HTML en document PDF et ajouter un filigrane au document PDF converti à l’aide d’une API REST en Python. Veuillez suivre les étapes mentionnées précédemment pour charger et télécharger des fichiers.
# initialisation de l'API
convertir_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# définir les paramètres de conversion
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "convertired"
# définir les options de filigrane
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;
# définir les options de conversion PDF
convertirOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertirOptions.watermark_options = watermark
settings.convertir_options = convertirOptions
# créer une demande de conversion de document
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# convertir
result = convertir_api.convertir_document(request)
print("Document convertired successfully: " + result[0].url)
Convertir HTML en PDF et ajouter un filigrane
Conversion HTML en PDF sans utiliser Cloud Storage
Vous pouvez convertir des documents HTML en PDF sans utiliser le stockage en nuage en suivant les étapes ci-dessous :
- Créer une instance de ConvertApi
- Créer ConvertDocumentDirectRequest et transmettre le format de document demandé et le chemin du fichier d’entrée
- Obtenez des résultats en appelant la méthode convert\document\direct() avec ConvertDocumentDirectRequest
- En option, enregistrez le fichier de sortie dans le chemin local à l’aide de la méthode shutdown.move ()
L’exemple de code suivant montre comment convertir un fichier HTML en document PDF sans utiliser le stockage cloud. Vous passerez le fichier d’entrée dans le corps de la requête et recevrez le fichier de sortie dans la réponse de l’API.
# Créer les instances d'API nécessaires
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)
# Préparer la demande
request = groupdocs_conversion_cloud.ConvertirDocumentDirectRequest("pdf", "C:\\Files\\sample.html")
# Convertir
result = convert_api.convert_document_direct(request)
# Déplacez le fichier téléchargé dans votre répertoire de travail
shutil.move(result, "C:\\Files\\")
Convertir HTML en PDF et télécharger directement
Vous pouvez facilement convertir des documents HTML en PDF par programmation en suivant les étapes ci-dessous :
- Créer une instance de ConvertApi
- Créer une instance de ConvertSettings
- Définir le chemin du fichier HTML
- Attribuez “pdf” au format
- Définissez “Aucun” sur le chemin de sortie
- Créer ConvertDocumentRequest avec ConvertSettings
- Obtenez des résultats en appelant la méthode convert\document\download()
- En option, enregistrez le fichier de sortie dans le chemin local à l’aide de la méthode shutdown.move ()
L’exemple de code suivant montre comment convertir un fichier HTML en document PDF et le télécharger directement à l’aide d’une API REST en Python. L’API doit renvoyer le fichier PDF converti en réponse. Veuillez suivre les étapes mentionnées précédemment pour télécharger un fichier.
# Créer les instances d'API nécessaires
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)
# Préparer les paramètres de conversion
settings = groupdocs_conversion_cloud.ConvertirSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = None # leave OutputPath will result the output as document IOStream
# Préparer la demande
request = groupdocs_conversion_cloud.ConvertirDocumentRequest(settings)
# Convertir
response = convert_api.convert_document_download(request)
# Déplacez le fichier téléchargé dans votre répertoire de travail
shutil.move(response, "C:\\Files\\")
Essayez en ligne
Veuillez essayer l’outil de conversion HTML en PDF en ligne gratuit suivant, qui est développé à l’aide de l’API ci-dessus. https://products.groupdocs.app/conversion/html-to-pdf
Conclusion
Dans cet article, vous avez appris à convertir des fichiers HTML en documents PDF à l’aide de Python sur le cloud. Vous avez également appris à convertir des fichiers HTML en documents PDF sans utiliser le stockage en nuage par programmation. De plus, vous avez appris à ajouter un filigrane aux documents PDF convertis à l’aide de Python. Cet article a également expliqué comment télécharger par programmation le fichier HTML dans le cloud, puis télécharger le fichier PDF converti à partir du cloud. Vous pouvez en savoir plus sur l’API GroupDocs.Conversion Cloud à l’aide de la documentation. Nous fournissons également une section API Reference qui vous permet de visualiser et d’interagir avec nos API directement via le navigateur. En cas d’ambiguïté, n’hésitez pas à nous contacter sur le forum.