Ajouter un élément de structure dans un élément

Introduction

Dans le monde numérique d’aujourd’hui, l’accessibilité est essentielle. Tout le monde doit avoir un accès égal aux informations, et il est essentiel de les fournir dans un format que tous les individus peuvent facilement parcourir. Dans ce tutoriel, nous abordons la façon d’améliorer l’accessibilité des PDF en ajoutant des éléments de structure à l’aide d’Aspose.PDF pour .NET. Cette puissante bibliothèque permet aux développeurs de travailler de manière transparente avec des documents PDF, leur permettant de créer des PDF balisés conformes aux normes d’accessibilité.

Prérequis

Avant de commencer notre voyage dans le monde des éléments de structure PDF, assurons-nous que vous disposez de tout ce dont vous avez besoin :

  1. Visual Studio : il s’agit de votre IDE dans lequel vous écrirez et exécuterez votre code C#. Vous pouvez le télécharger à partir deVisual Studio si vous ne l’avez pas déjà fait.
  2. Bibliothèque Aspose.PDF pour .NET : vous aurez besoin de la bibliothèque pour manipuler les fichiers PDF. Téléchargez la dernière version à partir duSite Web d’Aspose. Cette bibliothèque est essentielle pour notre projet.
  3. Connaissances de base de C# : une connaissance de la syntaxe C# et de la programmation orientée objet sera bénéfique. Si vous pouvez écrire quelques lignes de C# sans problème, vous êtes prêt à vous lancer !
  4. Un répertoire de documents PDF : créez un répertoire sur votre système dans lequel vous conserverez les fichiers PDF d’entrée et de sortie pour ce didacticiel.

Maintenant que nous avons nos outils et nos connaissances en main, mettons en place les packages nécessaires pour démarrer les choses !

Paquets d’importation

Tout d’abord, importons les espaces de noms nécessaires. Assurez-vous que les éléments suivants se trouvent en haut de votre fichier C# :

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using System;

Ces espaces de noms vous donnent accès aux classes et méthodes nécessaires pour travailler avec vos documents PDF et créer du contenu balisé. Maintenant, entrons dans le vif du sujet et commençons à coder !

Étape 1 : Configurez votre répertoire de documents

Avant de commencer à coder, nous devons déterminer où nous allons enregistrer nos fichiers. Cela est essentiel pour que notre script fonctionne correctement.

// Définissez le chemin vers le répertoire des documents.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Remplacer"YOUR DOCUMENT DIRECTORY" avec le chemin réel où vous souhaitez conserver vos fichiers PDF. Cela pourrait être quelque chose commeC:\\PDFs\\.

Étape 2 : Créer un nouveau document PDF

Maintenant que nous avons défini notre répertoire, créons un document PDF dans lequel nous ajouterons nos éléments de structure.

Document document = new Document();

Cette ligne initialise une nouvelle instance duDocument classe, nous permettant de commencer à travailler avec notre contenu PDF.

Étape 3 : Accéder au contenu balisé et le configurer

Une fois votre document prêt, il est temps de configurer le contenu balisé, essentiel pour l’accessibilité.

Initialiser le contenu balisé

ITaggedContent taggedContent = document.TaggedContent;

Cette ligne permet d’accéder au contenu balisé de votre PDF. Le contenu balisé est nécessaire pour que les lecteurs d’écran puissent interpréter votre document avec précision.

Définir les métadonnées du document

Vous souhaiterez donner à votre document un titre approprié et définir la langue.

taggedContent.SetTitle("Text Elements Example");
taggedContent.SetLanguage("en-US");

Cela améliore les métadonnées du document et améliore son accessibilité.

Étape 4 : Créer et ajouter des éléments de structure

Ajoutons un peu de structure ! Cela implique la création de paragraphes et d’éléments span afin de créer un document correctement formaté et balisé.

Créer un élément de structure racine

StructureElement rootElement = taggedContent.RootElement;

Nous allons maintenant créer notre premier ensemble de paragraphes et d’éléments span.

Créer le premier élément de paragraphe

ParagraphElement p1 = taggedContent.CreateParagraphElement();
rootElement.AppendChild(p1);

Ici, nous initialisons un nouvel élément de paragraphe et l’ajoutons à l’élément de structure racine. C’est le point de départ de votre contenu !

Ajouter des éléments Span au paragraphe

SpanElement span11 = taggedContent.CreateSpanElement();
span11.SetText("Span_11");
SpanElement span12 = taggedContent.CreateSpanElement();
span12.SetText(" and Span_12.");

Lespan Les éléments sont comme des mini-paragraphes au sein de notre paragraphe plus grand. Ils permettent un contrôle plus précis de la mise en forme du texte.

Combinez le tout

Construisons maintenant le paragraphe complet avec tous les éléments ensemble :

p1.SetText("Paragraph with ");
p1.AppendChild(span11);
p1.AppendChild(span12);

Répéter pour les paragraphes supplémentaires

Vous répéterez ce processus pour des paragraphes supplémentaires :

ParagraphElement p2 = taggedContent.CreateParagraphElement();
rootElement.AppendChild(p2);
SpanElement span21 = taggedContent.CreateSpanElement();
span21.SetText("Span_21");
SpanElement span22 = taggedContent.CreateSpanElement();
span22.SetText("Span_22.");
p2.AppendChild(span21);
p2.SetText(" and ");
p2.AppendChild(span22);

Continuez simplement à créerParagraphElement sableSpanElement s, en les ajoutant à larootElement de la même manière que montré ci-dessus pourp1.

Étape 5 : Enregistrez votre document

Une fois tous vos éléments de structure en place, il est temps d’enregistrer votre document PDF.

Spécifier le chemin du fichier de sortie

string outFile = dataDir + "AddStructureElementIntoElement_Output.pdf";

Enregistrer le document

document.Save(outFile);

C’est ici que la magie opère ! Votre document est enregistré dans le chemin de fichier de sortie spécifié.

Étape 6 : Valider la conformité PDF/UA

La dernière étape consiste à vérifier si votre document est conforme aux normes PDF/UA en matière d’accessibilité.

Pour vérifier la conformité, utilisez le code suivant :

document = new Document(outFile);
string logFile = dataDir + "46144_log.xml";
bool isPdfUaCompliance = document.Validate(logFile, PdfFormat.PDF_UA_1);
Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));

Cela indiquera si votre document est conforme aux normes PDF/UA, ce qui est essentiel pour l’accessibilité.

Conclusion

Et voilà ! Vous venez d’apprendre à ajouter des éléments de structure dans un document PDF à l’aide d’Aspose.PDF pour .NET. En suivant ces étapes, vous pouvez transformer n’importe quel PDF en un format accessible qui respecte les normes, garantissant ainsi à chacun un accès égal aux informations.

FAQ

Qu’est-ce qu’Aspose.PDF pour .NET ?

Aspose.PDF pour .NET est une bibliothèque qui permet aux développeurs de créer, manipuler et convertir des documents PDF par programmation.

Comment vérifier si mon PDF est accessible ?

Vous pouvez valider votre PDF par rapport aux normes PDF/UA à l’aide de la bibliothèque Aspose.PDF pour vous assurer qu’il répond aux directives d’accessibilité.

Puis-je utiliser Aspose.PDF gratuitement ?

Oui, Aspose propose une version d’essai gratuite, vous permettant d’explorer ses fonctionnalités sans aucun coût. Vous pouvez la téléchargerici.

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

Vous trouverez une documentation complète sur Aspose.PDFici.

Comment acheter une licence pour Aspose.PDF ?

Vous pouvez acheter une licence directement sur le site Web d’Asposeici.

Accéder aux éléments enfants Créer un élément de structure de note