Créer un PDF avec du texte balisé
Introduction
À l’ère du numérique, les documents PDF sont devenus l’un des formats les plus populaires pour le partage et l’affichage de contenu. Qu’il s’agisse de rapports commerciaux, d’articles universitaires ou de manuels d’utilisation, les PDF sont partout ! Mais ce qui distingue un bon PDF d’un excellent PDF, c’est l’accessibilité et la structure. C’est vrai ! Les PDF balisés permettent aux lecteurs d’écran et aux technologies d’assistance de comprendre et de parcourir plus facilement le contenu. Et devinez quoi ? Dans ce tutoriel, je vais vous expliquer étape par étape le processus de création d’un PDF balisé à l’aide d’Aspose.PDF pour .NET !
Alors, prenez votre boisson préférée, installez-vous et plongeons dans le monde des PDF balisés !
Prérequis
Avant de commencer, vous devez mettre en place quelques éléments :
- Visual Studio – Assurez-vous que Visual Studio est installé sur votre ordinateur. Vous pouvez utiliser n’importe quelle version prenant en charge .NET.
- Aspose.PDF pour .NET - Téléchargez la dernière version d’Aspose.PDF pour .NET à partir dusite webVous pouvez également opter pour un essai gratuit pour découvrir ses fonctionnalités.
- .NET Framework - Ces exemples seront créés pour .NET. Assurez-vous d’avoir une version compatible installée sur votre machine.
- Connaissances de base de C# - Une familiarité avec la programmation C# sera utile lorsque nous écrirons du code !
Vous avez tout compris ? Super ! Passons au codage !
Paquets d’importation
Maintenant que nous avons réglé nos prérequis, passons à la partie amusante : importer les packages nécessaires. Pour travailler avec Aspose.PDF, vous devez absolument ajouter la bibliothèque à votre projet.
Créer un nouveau projet
Tout d’abord, lancez Visual Studio et créez un nouveau projet C#.
- Ouvrez Visual Studio.
- Cliquez sur « Créer un nouveau projet ».
- Choisissez « Application console (.NET) » et cliquez sur « Suivant ».
- Nommez votre projet (par exemple,
TaggedPdfExample
) et définissez son emplacement. - Cliquez sur « Créer ».
Ajouter une référence Aspose.PDF
Maintenant, ajoutons la bibliothèque Aspose.PDF :
- Faites un clic droit sur votre projet dans l’Explorateur de solutions.
- Sélectionnez « Gérer les packages NuGet ».
- Recherchez « Aspose.PDF » et installez la dernière version.
Importer les espaces de noms requis
En haut de votre fichier de programme principal (commeProgram.cs
), importez les espaces de noms suivants :
using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using Aspose.Pdf.Text;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
Maintenant que nous avons tout configuré, décomposons le code en parties digestes et créons un PDF balisé étape par étape !
Étape 1 : Définir le répertoire des documents
Avant de commencer à coder, définissons le répertoire du document dans lequel nous allons enregistrer notre fichier PDF :
// Le chemin vers le répertoire des documents.
string dataDir = "YOUR DOCUMENT DIRECTORY"; // Mettez à jour ceci selon votre chemin
Remplacer"YOUR DOCUMENT DIRECTORY"
avec le chemin réel où vous souhaitez enregistrer votre PDF.
Étape 2 : Créer un document PDF
Créons une nouvelle instance de document PDF. C’est comme dessiner une toile vierge sur laquelle nous ajouterons notre contenu.
// Créer un document PDF
Document document = new Document();
Étape 3 : Obtenir le contenu balisé pour le document
Ensuite, nous devons obtenir le contenu balisé de notre document. Considérez le contenu balisé comme la structure sous-jacente qui le rend accessible. Voici comment procéder :
// Obtenez du contenu pour travailler avec TaggedPdf
ITaggedContent taggedContent = document.TaggedContent;
Étape 4 : Définir le titre et la langue du document
Maintenant, définissons le titre et la langue de notre document. C’est très important pour l’accessibilité !
// Définir le titre et la langue du document
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");
Étape 5 : Créer des éléments de structure au niveau du bloc de texte
C’est ici que nous allons créer notre contenu. Nous allons créer des en-têtes et des paragraphes, comme des blocs de construction !
Étape 5.1 : Créer un élément d’en-tête
Pour commencer, créons un élément d’en-tête :
// Créer des éléments de structure au niveau du bloc de texte
HeaderElement headerElement = taggedContent.CreateHeaderElement();
headerElement.ActualText = "Heading 1";
Étape 5.2 : Créer des éléments de paragraphe
Ensuite, ajoutons quelques paragraphes. J’en ajouterai plusieurs pour vous, mais vous pouvez personnaliser cela selon vos besoins !
ParagraphElement paragraphElement1 = taggedContent.CreateParagraphElement();
paragraphElement1.ActualText = "test1";
ParagraphElement paragraphElement2 = taggedContent.CreateParagraphElement();
paragraphElement2.ActualText = "test 2";
ParagraphElement paragraphElement3 = taggedContent.CreateParagraphElement();
paragraphElement3.ActualText = "test 3";
ParagraphElement paragraphElement4 = taggedContent.CreateParagraphElement();
paragraphElement4.ActualText = "test 4";
ParagraphElement paragraphElement5 = taggedContent.CreateParagraphElement();
paragraphElement5.ActualText = "test 5";
ParagraphElement paragraphElement6 = taggedContent.CreateParagraphElement();
paragraphElement6.ActualText = "test 6";
ParagraphElement paragraphElement7 = taggedContent.CreateParagraphElement();
paragraphElement7.ActualText = "test 7";
Étape 6 : Enregistrer le document PDF
Enfin, sauvegardons ce chef-d’œuvre ! Voici comment enregistrer votre PDF balisé :
// Enregistrer le document PDF
document.Save(dataDir + "PDFwithTaggedText.pdf");
Vous venez de créer un PDF balisé !
Conclusion
Créer un PDF balisé avec Aspose.PDF pour .NET est un jeu d’enfant une fois que vous avez pris le coup de main ! Cela rend vos documents non seulement conviviaux, mais également accessibles à un public plus large. Mettre l’accent sur la structure sémantique sera certainement payant, surtout si vous travaillez dans des secteurs où l’accessibilité du contenu est essentielle.
FAQ
Qu’est-ce qu’un PDF balisé ?
Un PDF balisé contient des données structurées qui permettent aux lecteurs d’écran et aux technologies d’assistance de parcourir plus efficacement le contenu.
Dois-je acheter Aspose.PDF pour l’utiliser ?
Bien que vous puissiez commencer avec un essai gratuit, une licence sera nécessaire pour une utilisation à long terme. Vous pouvez en savoir plusici.
Puis-je personnaliser les éléments de structure dans mon PDF ?
Absolument ! Vous pouvez manipuler différents éléments et créer des structures complexes en fonction de vos besoins.
Aspose.PDF est-il compatible avec toutes les applications .NET ?
Oui, Aspose.PDF est conçu pour fonctionner sur différentes plates-formes .NET, notamment .NET Framework, .NET Core, etc.
Où puis-je trouver de l’aide pour Aspose.PDF ?
Vous pouvez visiter leForum d’assistance Aspose pour toute question ou problème que vous rencontrez.