Vytvořte PDF s tagovaným textem

Zavedení

V dnešní digitální době se dokumenty PDF staly jedním z nejoblíbenějších formátů pro sdílení a zobrazování obsahu. Ať už jde o obchodní zprávy, akademické práce nebo uživatelské příručky, soubory PDF jsou všude! Co však odlišuje dobré PDF od skvělého, je přístupnost a struktura. Přesně tak! Tagované soubory PDF usnadňují čtečkám obrazovky a asistenčním technologiím porozumění obsahu a navigaci v něm. A hádejte co? V tomto tutoriálu vás krok za krokem provedu procesem vytváření tagovaného PDF pomocí Aspose.PDF pro .NET!

Vezměte si svůj oblíbený nápoj, usaďte se a pojďme se ponořit do světa tagovaných PDF!

Předpoklady

Než začneme, je potřeba mít připraveno několik věcí:

  1. Visual Studio – Ujistěte se, že máte na svém počítači nainstalované Visual Studio. Můžete použít jakoukoli verzi, která podporuje .NET.
  2. Aspose.PDF pro .NET – Stáhněte si nejnovější verzi Aspose.PDF pro .NET zwebové stránkyMůžete se také rozhodnout pro bezplatnou zkušební verzi a prozkoumat její funkce.
  3. .NET Framework – Tyto příklady budou vytvořeny pro .NET. Ujistěte se, že máte na svém počítači nainstalovanou kompatibilní verzi.
  4. Základní znalost C# – znalost programování v C# se nám bude hodit při psaní nějakého kódu!

Máš všechno? Velký! Pojďme ke kódování!

Importujte balíčky

Nyní, když máme naše předpoklady roztříděné, přejděme k zábavnější části: importu potřebných balíčků. Chcete-li pracovat s Aspose.PDF, určitě musíte přidat knihovnu do svého projektu.

Vytvořit nový projekt

Nejprve spusťte Visual Studio a vytvořte nový projekt C#.

  1. Otevřete Visual Studio.
  2. Klikněte na „Vytvořit nový projekt“.
  3. Vyberte „Console App (.NET)“ a klikněte na „Další“.
  4. Pojmenujte svůj projekt (např.TaggedPdfExample) a nastavte jeho umístění.
  5. Klikněte na „Vytvořit“.

Přidejte odkaz Aspose.PDF

Nyní přidáme knihovnu Aspose.PDF:

  1. Klepněte pravým tlačítkem myši na svůj projekt v Průzkumníku řešení.
  2. Vyberte „Spravovat balíčky NuGet“.
  3. Vyhledejte „Aspose.PDF“ a nainstalujte nejnovější verzi.

Importujte požadované jmenné prostory

V horní části hlavního souboru programu (napřProgram.cs), importujte následující jmenné prostory:

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

Nyní, když máme vše nastaveno, pojďme rozdělit kód na stravitelné části a vytvořit tagovaný PDF krok za krokem!

Krok 1: Definujte adresář dokumentů

Než začneme kódovat, definujme adresář dokumentu, kam uložíme náš soubor PDF:

// Cesta k adresáři dokumentů.
string dataDir = "YOUR DOCUMENT DIRECTORY"; // Aktualizujte to na svou cestu

Nahradit"YOUR DOCUMENT DIRECTORY" se skutečnou cestou, kam chcete soubor PDF uložit.

Krok 2: Vytvořte dokument Pdf

Pojďme vytvořit novou instanci dokumentu PDF. Je to jako kreslení prázdného plátna, kam přidáme náš obsah.

// Vytvořit dokument Pdf
Document document = new Document();

Krok 3: Získejte tagovaný obsah pro dokument

Dále musíme získat označený obsah našeho dokumentu. Označený obsah si představte jako základní strukturu, která jej zpřístupňuje. Postup je následující:

// Získejte obsah pro práci s TaggedPdf
ITaggedContent taggedContent = document.TaggedContent;

Krok 4: Nastavte název a jazyk dokumentu

Nyní nastavíme název a jazyk našeho dokumentu. To je velmi důležité pro přístupnost!

// Nastavte název a jazyk dokumentu
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

Krok 5: Vytvořte prvky struktury na úrovni bloku textu

Zde budeme vytvářet náš obsah. Vytvoříme záhlaví a odstavce, stejně jako stavební bloky!

Krok 5.1: Vytvořte prvek záhlaví

Chcete-li začít, vytvořte prvek záhlaví:

// Vytvářejte prvky struktury na úrovni bloku textu
HeaderElement headerElement = taggedContent.CreateHeaderElement();
headerElement.ActualText = "Heading 1";

Krok 5.2: Vytvořte prvky odstavce

Dále přidáme několik odstavců. Přidám několik pro vás, ale můžete si je přizpůsobit podle svých potřeb!

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";

Krok 6: Uložte dokument PDF

Konečně zachraňme toto mistrovské dílo! Takto si uložíte označené PDF:

// Uložit dokument PDF
document.Save(dataDir + "PDFwithTaggedText.pdf");

Právě jste vytvořili tagovaný PDF!

Závěr

Vytváření tagovaného PDF pomocí Aspose.PDF for .NET je snadné jako facka, jakmile to pochopíte! Díky tomu jsou vaše dokumenty nejen uživatelsky přívětivé, ale také přístupné širšímu publiku. Zdůraznění sémantické struktury se rozhodně vyplatí, zvláště pokud se pohybujete v odvětvích, kde je dostupnost obsahu zásadní.

FAQ

Co je to tagovaný PDF?

Tagované PDF obsahuje strukturovaná data, která usnadňují čtečkám obrazovky a pomocným technologiím efektivní procházení obsahu.

Musím si koupit Aspose.PDF, abych ho mohl používat?

I když můžete začít s bezplatnou zkušební verzí, pro dlouhodobé používání bude vyžadována licence. Můžete se dozvědět vícezde.

Mohu přizpůsobit prvky struktury v mém PDF?

Absolutně! Můžete manipulovat s různými prvky a vytvářet složité struktury na základě vašich požadavků.

Je Aspose.PDF kompatibilní se všemi aplikacemi .NET?

Ano, Aspose.PDF je navržen tak, aby fungoval na různých platformách .NET, včetně .NET Framework, .NET Core a dalších.

Kde najdu podporu pro Aspose.PDF?

Můžete navštívitAspose Support Forum pro jakékoli dotazy nebo problémy, se kterými se setkáte.