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:
- Visual Studio - Upewnij się, że masz zainstalowany Visual Studio na swoim komputerze. Możesz użyć dowolnej wersji, która obsługuje .NET.
- 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.
- .NET Framework - Te przykłady zostaną zbudowane dla .NET. Upewnij się, że masz zainstalowaną kompatybilną wersję na swoim komputerze.
- 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#.
- Otwórz program Visual Studio.
- Kliknij „Utwórz nowy projekt”.
- Wybierz „Aplikacja konsolowa (.NET)” i kliknij „Dalej”.
- Nadaj nazwę swojemu projektowi (np.
TaggedPdfExample
) i ustaw jego lokalizację. - Kliknij „Utwórz”.
Dodaj odniesienie Aspose.PDF
Teraz dodajmy bibliotekę Aspose.PDF:
- Kliknij prawym przyciskiem myszy swój projekt w Eksploratorze rozwiązań.
- Wybierz „Zarządzaj pakietami NuGet”.
- 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.