Convertir HTML en PDF en Python

Un fichier PDF est un document à structure fixe qui comprend le texte, les graphiques, les liens hypertextes, les boutons, les champs de formulaire, le multimédia et d’autres informations nécessaires à l’affichage. Les PDF sont hautement sécurisés, car ils permettent la protection par mot de passe, le cryptage et les signatures numériques pour protéger les informations sensibles. Ils sont également universellement accessibles et peuvent être facilement visualisés sur n’importe quel appareil sans logiciel spécifique. En outre, les PDF sont compacts et peuvent compresser des fichiers de haute qualité en des tailles plus petites, ce qui les rend idéaux pour le partage et le stockage.

Dans ce guide, vous trouverez des informations sur la manière de convertir un document HTML en un fichier Portable Document Format (PDF) en utilisant Aspose.HTML for Python via .NET. Nous allons voir en détail comment convertir HTML en PDF en utilisant les méthodes convert_html() de la classe Converter, et comment appliquer PdfSaveOptions. Vous pouvez également essayer un convertisseur HTML en ligne pour tester les fonctionnalités d’Aspose.HTML et convertir du HTML à la volée.

Pour continuer à suivre ce tutoriel, installez et configurez Aspose.HTML for Python via .NET dans votre projet Python. Nos exemples de code vous aident à convertir HTML en PDF et à générer des fichiers PDF à l’aide de la bibliothèque Python.

HTML vers PDF avec une ligne de code

Les méthodes de la classe Converter sont principalement utilisées comme le moyen le plus simple de convertir un code HTML dans différents formats. Vous pouvez convertir HTML en PDF dans votre application Python littéralement avec une seule ligne de code !

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

Convertisseur HTML en ligne

Vous pouvez tester la puissance d’Aspose.HTML for Python via .NET et effectuer une conversion HTML en temps réel. Il suffit de charger un fichier HTML à partir de votre système de fichiers local ou d’une URL, de sélectionner le format de sortie souhaité et d’exécuter l’exemple de code fourni. L’exemple utilise les options d’enregistrement par défaut, ce qui permet un processus de conversion simple. Une fois la conversion terminée, vous recevrez instantanément le fichier converti dans le format de votre choix.

Convertir HTML en PDF à l’aide de PdfSaveOptions

Avec Aspose.HTML for Python via .NET, vous pouvez convertir des fichiers de manière programmatique avec un contrôle total sur un large éventail de paramètres de conversion. Pour convertir HTML en PDF en spécifiant PdfSaveOptions, vous devez suivre quelques étapes :

Chargez un fichier HTML en utilisant l’un des constructeurs HTMLDocument() de la classe HTMLDocument. Dans l’exemple ci-dessus, nous initialisons un document HTML à partir d’un fichier.
Créez un nouvel objet PdfSaveOptions et spécifiez les propriétés requises. La classe PdfSaveOptions fournit de nombreuses propriétés qui vous donnent un contrôle total sur un large éventail de paramètres et améliorent le processus de conversion de HTML en PDF.
Utilisez la méthode convert_html() de la classe Converter. Dans l’exemple suivant, vous devez passer les paramètres HTMLDocument, PdfSaveOptions, et le chemin du fichier de sortie à la méthode convert_html().

L’exemple de code Python suivant montre comment utiliser PdfSaveOptions et créer un fichier PDF avec des options d’enregistrement personnalisées :

 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

Dans cet exemple, nous convertissons un document HTML en fichier PDF à l’aide d’options d’enregistrement. Le processus consiste à initialiser le document HTML, à définir des options d’enregistrement personnalisées telles que la taille de la page et encryption, puis à effectuer la conversion. Enfin, le fichier PDF converti est enregistré dans un répertoire de sortie spécifié.

Vous pouvez évaluer la qualité de la conversion en essayant notre produit. La figure suivante montre le résultat de la conversion d’un fichier aspose.html au format PDF :

Texte “La figure illustre le fichier aspose.html”

Classe PdfSaveOptions

Aspose.HTML for Python via .NET fournit la classe PdfSaveOptions, qui vous permet de mieux contrôler la manière dont les documents sont enregistrés au format PDF. Certaines propriétés de cette classe héritent de propriétés de classes de base, telles que PdfRenderingOptions ou RenderingOptions. l’utilisation de PdfSaveOptions vous permet de personnaliser le processus de rendu ; vous pouvez spécifier la taille de la page, les marges, les permissions de fichier, Css, etc. Voici une description des propriétés disponibles dans PdfSaveOptions :

page_setup – Cette propriété donne accès à un objet PageSetup utilisé pour configurer la mise en page et les paramètres des pages PDF de sortie afin de répondre à des exigences spécifiques en matière d’impression ou d’affichage.
horizontal_resolution – Cette propriété contrôle la résolution horizontale des images internes utilisées pendant le traitement et des images externes incluses dans le code HTML. Par défaut, elle est fixée à 300 dpi.
vertical_resolution – Similaire à horizontal_resolution, cette propriété gère la résolution verticale des images internes et externes lors de la génération du PDF. Comme pour la résolution horizontale, la valeur par défaut est de 300 dpi.
background_color – Cette propriété définit ou récupère la couleur d’arrière-plan qui remplit chaque page du document PDF. La valeur par défaut est transparente, mais elle peut être personnalisée en fonction des préférences de marque ou d’esthétique, afin d’assurer la cohérence entre toutes les pages.
css – Cette propriété utilise un objet CssOptions pour configurer le traitement des propriétés CSS pendant la conversion HTML vers PDF. Elle permet un contrôle précis de la façon dont les styles du HTML sont interprétés et appliqués dans le PDF résultant.
document_info – Cette propriété contient des métadonnées et des informations sur le document PDF de sortie, telles que le titre, l’auteur, le sujet et les mots-clés. Ces métadonnées facilitent la gestion, l’indexation et la recherche de documents, en rendant le PDF plus informatif et mieux organisé.
form_field_behaviour – Cette propriété spécifie le comportement des champs de formulaire interactifs dans le PDF généré.
jpeg_quality – Cette propriété détermine la qualité de compression JPEG utilisée pour les images intégrées dans un document PDF. La qualité par défaut est fixée à 95, ce qui offre un bon équilibre entre la fidélité de l’image et la taille du fichier. Le paramétrage de cette propriété vous permet d’optimiser la taille du fichier ou la qualité de l’image en fonction de vos besoins spécifiques.
encryption – Cette propriété fournit des informations détaillées sur le cryptage des documents PDF, y compris la protection par mot de passe et les paramètres d’autorisation. Si elle n’est pas configurée, aucun cryptage n’est appliqué, mais la définition de cette propriété vous permet de distribuer et de contrôler l’accès au contenu PDF sensible en toute sécurité.
is_tagged_pdf – Lorsque la valeur est fixée à true, une mise en page balisée est créée dans le document PDF, ce qui améliore l’accessibilité pour les utilisateurs handicapés. Cela permet de s’assurer que le contenu est correctement structuré et navigable à l’aide d’une technologie d’assistance et qu’il respecte les normes d’accessibilité.

Conversion de HTML en PDF et aplatissement de PDF

Aspose.HTML for Python via .NET offre la propriété form_field_behaviour de la classe PdfSaveOptions pour aplatir les documents PDF après leur conversion à partir de HTML ou MHTML. Cette propriété est utilisée pour spécifier le comportement des champs de formulaire dans un document PDF. Si la valeur est FormFieldBehaviour.FLATTENED, tous les champs de formulaire du document PDF seront aplatis.

 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

Comment convertir HTML en XPS

Aspose.HTML for Python via .NET prend en charge la conversion de HTML en XPS. Pour ce faire, vous devez utiliser XpsSaveOptions pour obtenir un objet d’options de sauvegarde qui est passé à la méthode convert_html() :

options = sav.XpsSaveOptions()

L’utilisation de XpsSaveOptions vous permet de personnaliser le processus de rendu ; vous pouvez spécifier les propriétés page_setup, background_color, css, horizontal_resolution et vertical_resolution.

Téléchargez la bibliothèque Aspose.HTML for Python via .NET pour convertir avec succès, rapidement et facilement vos documents HTML, MHTML, EPUB, SVG et Markdown vers les formats les plus populaires.

Vous pouvez télécharger les exemples complets et les fichiers de données depuis GitHub.

Aspose.HTML propose un Convertisseur HTML en PDF en ligne gratuit qui convertit HTML en PDF avec une grande qualité, facilement et rapidement. Il suffit de télécharger, de convertir vos fichiers et d’obtenir le résultat en quelques secondes !

Convertisseur HTML Convertir HTML en DOCX