Nom de balise personnalisé

Introduction

À l’ère du numérique, les PDF sont omniprésents. Des rapports aux manuels, ils remplissent une multitude d’objectifs dans divers secteurs. Cependant, il est essentiel de veiller à ce que ces documents soient accessibles à tous, y compris aux personnes handicapées. C’est là que les PDF balisés entrent en jeu. Ils permettent aux lecteurs d’écran et aux autres technologies d’assistance d’interpréter plus efficacement le contenu des documents.

Prérequis

Avant de passer au codage, il est essentiel de vous assurer que tout est prêt. Voici ce dont vous aurez besoin :

  1. Visual Studio – N’importe quelle version récente fera l’affaire, mais il est préférable d’avoir la dernière version pour une fonctionnalité optimale.
  2. Aspose.PDF pour .NET - Vous pouvez facilement télécharger la dernière version à partir dulien de téléchargement.
  3. Connaissances de base de C# - La familiarité avec les fondamentaux de la programmation C# sera bénéfique lors de la mise en œuvre du code.

Paquets d’importation

Une fois votre environnement configuré, l’étape suivante consiste à importer les packages nécessaires pour utiliser Aspose.PDF. Vous pouvez le faire en ajoutant la bibliothèque Aspose.PDF à votre projet.

Installer Aspose.PDF via NuGet

  1. Ouvrez votre projet Visual Studio : si vous n’avez pas encore créé de projet, créez-en un nouveau.
  2. Accédez au gestionnaire de packages NuGet : cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions et sélectionnez « Gérer les packages NuGet ».
  3. Rechercher Aspose.PDF : Saisissez « Aspose.PDF » dans la barre de recherche.
  4. Installer le package : Cliquez sur « Installer » pour ajouter le package à votre projet. Une fois installé, vous êtes prêt !

Ajouter une directive à l’aide de

Pour utiliser la fonctionnalité Aspose dans votre code, vous devez ajouter la directive using nécessaire en haut de votre fichier :

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Une fois ces étapes terminées, vous êtes prêt à vous attaquer à la création de votre PDF balisé !

Maintenant que tout est configuré, passons à la tâche principale : créer un document PDF balisé. Voici un guide étape par étape sur la façon de procéder à l’aide d’Aspose.PDF pour .NET.

Étape 1 : Définir le répertoire des documents

Tout d’abord, vous devez spécifier le chemin où votre PDF sera enregistré. C’est ici que vous définirez votre répertoire de données.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Explication : remplacez « VOTRE RÉPERTOIRE DE DOCUMENTS » par le chemin d’accès réel dans lequel vous souhaitez enregistrer le fichier PDF. Il est essentiel de disposer d’une autorisation d’écriture dans ce répertoire pour éviter toute exception d’exécution.

Étape 2 : Créer un nouveau document PDF

Ensuite, nous allons créer une instance deDocument classe.

Document document = new Document();

Explication : Cette ligne initialise un nouveau document PDF. Considérez cela comme la création d’une toile vierge sur laquelle vous peindrez le contenu de votre PDF.

Étape 3 : Créer du contenu balisé

Il est maintenant temps d’entrer dans le vif du sujet du balisage. Nous allons récupérer le contenu balisé du document.

ITaggedContent taggedContent = document.TaggedContent;

Explication : LeTaggedContent L’objet nous permet de manipuler la structure logique et l’accessibilité du PDF en organisant le contenu de manière hiérarchique.

Étape 4 : définir le titre et la langue

Ensuite, vous pouvez définir le titre du document et l’attribut de langue. Cela aide les lecteurs d’écran à traiter correctement le document.

taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

Explication : Ici, nous informons toute personne lisant ce PDF de son titre et de la langue, ce qui aide à la compréhension, en particulier pour les outils d’accessibilité.

Étape 5 : Créer les éléments de la structure logique

Il est maintenant temps de créer des éléments structurés dans votre PDF.

SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

Explication : Cette étape introduit un élément de section dans lequel vous pouvez commencer à ajouter du contenu.RootElement est votre base.

Étape 6 : Créer des éléments de paragraphe

Nous créons maintenant divers éléments de paragraphe et définissons leur contenu textuel.

ParagraphElement p1 = taggedContent.CreateParagraphElement();
ParagraphElement p2 = taggedContent.CreateParagraphElement();
ParagraphElement p3 = taggedContent.CreateParagraphElement();
ParagraphElement p4 = taggedContent.CreateParagraphElement();
p1.SetText("P1. ");
p2.SetText("P2. ");
p3.SetText("P3. ");
p4.SetText("P4. ");

Explication : Chaque paragraphe s’apparente à une phrase dans une histoire, plantant le décor et donnant un sens à votre document.

Étape 7 : Attribuer des balises aux paragraphes

Il est essentiel d’étiqueter chaque paragraphe de manière appropriée pour l’accessibilité de votre PDF.

p1.SetTag("P1");
p2.SetTag("Para");
p3.SetTag("Para");
p4.SetTag("Paragraph");

Explication : En étiquetant avec des balises, nous permettons aux technologies d’assistance de comprendre la structure du contenu, c’est comme si nous leur donnions une feuille de route pour naviguer sur le territoire.

Étape 8 : Ajouter des paragraphes à la section

Nous allons maintenant ajouter ces paragraphes à la section précédemment créée.

sect.AppendChild(p1);
sect.AppendChild(p2);
sect.AppendChild(p3);
sect.AppendChild(p4);

Explication : Cette action organise les paragraphes dans la section, rendant le flux logique et facile à suivre.

Étape 9 : Créer des éléments Span

Tout comme les paragraphes, les étendues ajoutent des détails précis à notre contenu textuel.

SpanElement span1 = taggedContent.CreateSpanElement();
SpanElement span2 = taggedContent.CreateSpanElement();
SpanElement span3 = taggedContent.CreateSpanElement();
SpanElement span4 = taggedContent.CreateSpanElement();
span1.SetText("Span 1.");
span2.SetText("Span 2.");
span3.SetText("Span 3.");
span4.SetText("Span 4.");

Explication : Les portées sont comme un peaufinage des détails ; elles ajoutent de la spécificité à ce que vous transmettez dans chaque paragraphe.

Étape 10 : Attribuer des balises aux éléments Span

Tout comme nous l’avons fait pour les paragraphes, nous devons étiqueter nos éléments span pour faciliter la compréhension.

span1.SetTag("SPAN");
span2.SetTag("Sp");
span3.SetTag("Sp");
span4.SetTag("TheSpan");

Explication : Un étiquetage approprié des étendues garantit que toutes les nuances sont représentées avec précision, créant ainsi un document riche pour quiconque le rencontre.

Étape 11 : ajouter des plages aux paragraphes

Maintenant, ajoutons nos éléments span à leurs paragraphes respectifs.

p1.AppendChild(span1);
p2.AppendChild(span2);
p3.AppendChild(span3);
p4.AppendChild(span4);

Explication : Cette intégration améliore vos paragraphes en superposant des informations supplémentaires, tout comme l’ajout de notes de bas de page à un livre pour une compréhension plus approfondie.

Étape 12 : Enregistrer le document PDF balisé

Enfin, il est temps de sauvegarder votre chef-d’œuvre !

document.Save(dataDir + "CustomTag.pdf");

Explication : Cette ligne enregistre votre PDF balisé dans le répertoire spécifié. Vous avez ainsi terminé la création de votre document PDF balisé !

Conclusion

Créer des documents PDF balisés à l’aide d’Aspose.PDF pour .NET ne consiste pas seulement à ajouter du contenu ; il s’agit de créer une expérience accessible à tous les utilisateurs. En quelques étapes seulement, vous pouvez vous assurer que vos documents parlent à tout le monde, en supprimant les obstacles et en améliorant la compréhension.

FAQ

Qu’est-ce qu’un PDF balisé ?

Un PDF balisé contient des métadonnées supplémentaires qui décrivent la structure et l’accessibilité du contenu du document, ce qui facilite son interprétation par les technologies d’assistance.

Pourquoi ai-je besoin d’Aspose.PDF pour .NET ?

Aspose.PDF pour .NET est une bibliothèque puissante qui permet aux développeurs de créer, modifier et manipuler des documents PDF par programmation avec des fonctionnalités étendues.

Comment puis-je obtenir une version d’essai d’Aspose.PDF ?

Vous pouvez obtenir un essai gratuit d’Aspose.PDF en visitantce lien.

Puis-je obtenir de l’aide pour Aspose.PDF ?

Oui, vous pouvez contacter l’assistance viale forum Aspose.

Où puis-je trouver la documentation détaillée d’Aspose.PDF ?

La documentation complète peut être trouvéeici.

Créer un élément de tableau Éléments de structure d'illustration