Utwórz plik PDF z tekstem oznaczonym

Wstęp

W dzisiejszej erze cyfrowej dokumenty PDF stały się jednym z najpopularniejszych formatów udostępniania i wyświetlania treści. Niezależnie od tego, czy są to raporty biznesowe, prace naukowe czy instrukcje użytkownika, pliki PDF są wszędzie! Ale tym, co odróżnia dobry plik PDF od świetnego, jest dostępność i struktura. Dokładnie tak! Oznaczone pliki PDF ułatwiają czytnikom ekranu i technologiom wspomagającym zrozumienie treści i nawigację po niej. I zgadnij co? W tym samouczku przeprowadzę Cię przez proces tworzenia oznaczonych plików PDF przy użyciu Aspose.PDF dla .NET, krok po kroku!

Więc weź swój ulubiony napój, usiądź wygodnie i zanurz się w świecie tagowanych plików PDF!

Wymagania wstępne

Zanim zaczniemy, jest kilka rzeczy, które musisz mieć na miejscu:

  1. Visual Studio - Upewnij się, że masz zainstalowany Visual Studio na swoim komputerze. Możesz użyć dowolnej wersji, która obsługuje .NET.
  2. Aspose.PDF dla .NET — Pobierz najnowszą wersję Aspose.PDF dla .NET ze stronystrona internetowaMożesz również zdecydować się na bezpłatną wersję próbną, aby poznać jej funkcje.
  3. .NET Framework - Te przykłady zostaną zbudowane dla .NET. Upewnij się, że masz zainstalowaną kompatybilną wersję na swoim komputerze.
  4. Podstawowa znajomość języka C# - Znajomość programowania w języku C# okaże się przydatna podczas pisania kodu!

Masz wszystko? Świetnie! Zabieramy się za kodowanie!

Importuj pakiety

Teraz, gdy mamy już uporządkowane nasze wymagania wstępne, przejdźmy do zabawnej części: importowania niezbędnych pakietów. Aby pracować z Aspose.PDF, zdecydowanie musisz dodać bibliotekę do swojego projektu.

Utwórz nowy projekt

Najpierw uruchom program Visual Studio i utwórz nowy projekt w języku C#.

  1. Otwórz program Visual Studio.
  2. Kliknij „Utwórz nowy projekt”.
  3. Wybierz „Aplikacja konsolowa (.NET)” i kliknij „Dalej”.
  4. Nadaj nazwę swojemu projektowi (np.TaggedPdfExample) i ustaw jego lokalizację.
  5. Kliknij „Utwórz”.

Dodaj odniesienie Aspose.PDF

Teraz dodajmy bibliotekę Aspose.PDF:

  1. Kliknij prawym przyciskiem myszy swój projekt w Eksploratorze rozwiązań.
  2. Wybierz „Zarządzaj pakietami NuGet”.
  3. Wyszukaj „Aspose.PDF” i zainstaluj najnowszą wersję.

Importuj wymagane przestrzenie nazw

Na górze głównego pliku programu (takiego jakProgram.cs), zaimportuj następujące przestrzenie nazw:

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

Teraz, gdy wszystko mamy już skonfigurowane, możemy podzielić kod na łatwiejsze do zrozumienia części i krok po kroku utworzyć oznaczony plik PDF!

Krok 1: Zdefiniuj katalog dokumentów

Zanim zaczniemy kodować, zdefiniujmy katalog dokumentu, w którym zapiszemy nasz plik PDF:

// Ścieżka do katalogu dokumentów.
string dataDir = "YOUR DOCUMENT DIRECTORY"; // Zaktualizuj to do swojej ścieżki

Zastępować"YOUR DOCUMENT DIRECTORY" ze ścieżką, pod którą chcesz zapisać plik PDF.

Krok 2: Utwórz dokument PDF

Utwórzmy nową instancję dokumentu PDF. To jak rysowanie pustego płótna, na którym będziemy dodawać naszą treść.

// Utwórz dokument PDF
Document document = new Document();

Krok 3: Pobierz oznaczoną zawartość dla dokumentu

Następnie musimy uzyskać oznaczoną zawartość naszego dokumentu. Pomyśl o oznaczonej zawartości jako o podstawowej strukturze, która ją udostępnia. Oto, jak to zrobić:

// Pobierz zawartość do pracy z TaggedPdf
ITaggedContent taggedContent = document.TaggedContent;

Krok 4: Ustaw tytuł i język dokumentu

Teraz ustawmy tytuł i język naszego dokumentu. To jest super ważne dla dostępności!

// Ustaw tytuł i język dokumentu
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

Krok 5: Utwórz elementy struktury na poziomie bloku tekstowego

Tutaj utworzymy naszą treść. Stworzymy nagłówki i akapity, tak jak klocki!

Krok 5.1: Utwórz element nagłówka

Na początek utwórzmy element nagłówka:

// Utwórz elementy struktury bloków tekstowych
HeaderElement headerElement = taggedContent.CreateHeaderElement();
headerElement.ActualText = "Heading 1";

Krok 5.2: Utwórz elementy akapitu

Następnie dodajmy kilka akapitów. Dodam kilka dla Ciebie, ale możesz dostosować to do swoich potrzeb!

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: Zapisz dokument PDF

Na koniec, zapiszmy to arcydzieło! Oto jak zapisać oznaczony plik PDF:

// Zapisz dokument PDF
document.Save(dataDir + "PDFwithTaggedText.pdf");

Właśnie utworzyłeś oznaczony plik PDF!

Wniosek

Tworzenie oznaczonych plików PDF za pomocą Aspose.PDF dla .NET jest dziecinnie proste, gdy już się z tym oswoisz! Dzięki temu Twoje dokumenty będą nie tylko przyjazne dla użytkownika, ale także dostępne dla szerszej publiczności. Podkreślanie struktury semantycznej z pewnością się opłaci, zwłaszcza jeśli działasz w branżach, w których dostępność treści jest niezbędna.

Najczęściej zadawane pytania

Czym jest plik PDF z tagami?

Oznaczony plik PDF zawiera ustrukturyzowane dane, dzięki którym czytniki ekranu i technologie wspomagające mogą łatwiej poruszać się po treści.

Czy muszę kupić Aspose.PDF, żeby z niego korzystać?

Chociaż możesz zacząć od bezpłatnego okresu próbnego, licencja będzie wymagana do długoterminowego użytkowania. Możesz dowiedzieć się więcejTutaj.

Czy mogę dostosować elementy struktury w moim pliku PDF?

Oczywiście! Możesz manipulować różnymi elementami i tworzyć złożone struktury w oparciu o swoje wymagania.

Czy Aspose.PDF jest kompatybilny ze wszystkimi aplikacjami .NET?

Tak, Aspose.PDF został zaprojektowany do działania na różnych platformach .NET, w tym .NET Framework, .NET Core i innych.

Gdzie mogę znaleźć pomoc dotyczącą Aspose.PDF?

Możesz odwiedzićForum wsparcia Aspose w przypadku jakichkolwiek pytań lub problemów.