Niestandardowa nazwa tagu

Wstęp

dzisiejszej erze cyfrowej pliki PDF są wszechobecne. Od raportów po instrukcje, służą wielu celom w różnych branżach. Jednak zapewnienie dostępności tych dokumentów dla wszystkich, w tym osób niepełnosprawnych, jest kluczowe. To właśnie tutaj wkraczają oznaczone pliki PDF. Ułatwiają one czytnikom ekranu i innym technologiom wspomagającym skuteczną interpretację treści dokumentu.

Wymagania wstępne

Zanim przejdziemy do kodowania, ważne jest, aby upewnić się, że wszystko jest gotowe. Oto, czego będziesz potrzebować:

  1. Visual Studio — wystarczy dowolna nowsza wersja, jednak w celu uzyskania optymalnej funkcjonalności najlepiej jest korzystać z najnowszej wersji.
  2. Aspose.PDF dla .NET — Najnowszą wersję można łatwo pobrać ze stronylink do pobrania.
  3. Podstawowa znajomość języka C# — znajomość podstaw programowania w języku C# będzie pomocna podczas implementacji kodu.

Importuj pakiety

Po skonfigurowaniu środowiska następnym krokiem jest zaimportowanie niezbędnych pakietów do korzystania z Aspose.PDF. Możesz to zrobić, dodając bibliotekę Aspose.PDF do swojego projektu.

Zainstaluj Aspose.PDF przez NuGet

  1. Otwórz projekt programu Visual Studio: Jeśli jeszcze nie utworzyłeś projektu, utwórz nowy.
  2. Uzyskaj dostęp do Menedżera pakietów NuGet: kliknij prawym przyciskiem myszy swój projekt w Eksploratorze rozwiązań i wybierz opcję „Zarządzaj pakietami NuGet”.
  3. Wyszukaj Aspose.PDF: Wpisz „Aspose.PDF” w pasku wyszukiwania.
  4. Zainstaluj pakiet: Kliknij „Instaluj”, aby dodać pakiet do swojego projektu. Po zainstalowaniu możesz zaczynać!

Dodaj dyrektywę Using

Aby wykorzystać funkcjonalność Aspose w swoim kodzie, musisz dodać odpowiednią dyrektywę using na początku pliku:

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

Po wykonaniu tych kroków możesz rozpocząć tworzenie oznaczonych plików PDF!

Teraz, gdy wszystko jest już skonfigurowane, przejdźmy do głównego zadania: tworzenia oznaczonego dokumentu PDF. Oto przewodnik krok po kroku, jak to zrobić za pomocą Aspose.PDF dla .NET.

Krok 1: Zdefiniuj katalog dokumentów

Najpierw musisz określić ścieżkę, w której zostanie zapisany Twój plik PDF. Tutaj zdefiniujesz katalog danych.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Wyjaśnienie: Zastąp „YOUR DOCUMENT DIRECTORY” rzeczywistą ścieżką, w której chcesz zapisać plik PDF. Ważne jest, aby mieć uprawnienia do zapisu w tym katalogu, aby uniknąć wyjątków w czasie wykonywania.

Krok 2: Utwórz nowy dokument PDF

Następnie utworzymy instancjęDocument klasa.

Document document = new Document();

Wyjaśnienie: Ta linia inicjuje nowy dokument PDF. Wyobraź sobie, że tworzysz puste płótno, na którym będziesz malować zawartość swojego pliku PDF.

Krok 3: Utwórz oznaczoną treść

Teraz czas na sedno tagowania. Pobierzemy oznaczoną zawartość dokumentu.

ITaggedContent taggedContent = document.TaggedContent;

Wyjaśnienie:TaggedContent Obiekt ten umożliwia nam manipulowanie logiczną strukturą i dostępnością pliku PDF poprzez hierarchiczną organizację treści.

Krok 4: Ustaw tytuł i język

Następnie możesz ustawić tytuł dokumentu i atrybut języka. Pomaga to czytnikom ekranowym prawidłowo przetwarzać dokument.

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

Wyjaśnienie: W tym miejscu informujemy osoby czytające ten plik PDF o jego tytule i języku, co ułatwia zrozumienie tekstu, zwłaszcza w przypadku narzędzi ułatwiających dostęp.

Krok 5: Utwórz elementy struktury logicznej

Teraz nadszedł czas na utworzenie elementów strukturalnych w pliku PDF.

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

Wyjaśnienie: Ten krok wprowadza element sekcji, w którym możesz zacząć dodawać treść.RootElement jest Twoją bazą.

Krok 6: Utwórz elementy akapitu

Teraz tworzymy różne elementy akapitu i ustalamy ich zawartość tekstową.

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

Wyjaśnienie: Każdy akapit przypomina zdanie w opowieści, przedstawiające tło i nadające znaczenie dokumentowi.

Krok 7: Przypisz tagi do akapitów

Ważne jest, aby każdy akapit odpowiednio oznaczyć, aby ułatwić dostęp do pliku PDF.

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

Wyjaśnienie: Dzięki etykietowaniu za pomocą tagów umożliwiamy technologiom wspomagającym zrozumienie struktury treści — jest to jak dawanie im mapy drogowej, która pomoże im poruszać się po terenie.

Krok 8: Dodaj akapity do sekcji

Teraz dodamy te akapity do wcześniej utworzonej sekcji.

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

Wyjaśnienie: Ta czynność porządkuje akapity w obrębie sekcji, dzięki czemu przepływ informacji staje się logiczny i łatwy do śledzenia.

Krok 9: Utwórz elementy rozpiętości

Podobnie jak akapity, spans dodają szczegółowe informacje do naszych treści tekstowych.

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

Wyjaśnienie: Rozpiętości pełnią funkcję doprecyzowania szczegółów; dodają konkretów temu, co przekazujesz w każdym akapicie.

Krok 10: Przypisz tagi do elementów rozpiętości

Podobnie jak w przypadku akapitów, powinniśmy oznaczyć elementy span, aby ułatwić zrozumienie.

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

Wyjaśnienie: Prawidłowe tagowanie spanów gwarantuje, że wszystkie niuanse zostaną dokładnie przedstawione, dzięki czemu dokument będzie czytelny dla każdego, kto się z nim zetknie.

Krok 11: Dodawanie zakresów do akapitów

Teraz dodajmy elementy span do odpowiednich akapitów.

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

Wyjaśnienie: Ta integracja wzbogaca akapity poprzez dodawanie dodatkowych informacji, podobnie jak dodawanie przypisów do książki w celu ułatwienia zrozumienia tekstu.

Krok 12: Zapisz oznaczony dokument PDF

Na koniec pora zapisać Twoje arcydzieło!

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

Wyjaśnienie: Ten wiersz zapisuje Twój oznaczony plik PDF do określonego katalogu. W ten sposób ukończyłeś tworzenie swojego otagowanego dokumentu PDF!

Wniosek

Tworzenie oznaczonych dokumentów PDF przy użyciu Aspose.PDF dla .NET nie polega jedynie na dodawaniu treści; chodzi o stworzenie dostępnego doświadczenia dla wszystkich użytkowników. Za pomocą zaledwie kilku kroków możesz upewnić się, że Twoje dokumenty przemawiają do wszystkich, usuwając bariery i zwiększając zrozumienie.

Najczęściej zadawane pytania

Czym jest plik PDF z tagami?

Oznaczony plik PDF zawiera dodatkowe metadane opisujące strukturę i dostępność treści dokumentu, dzięki czemu technologie wspomagające mogą go łatwiej interpretować.

Dlaczego potrzebuję Aspose.PDF dla .NET?

Aspose.PDF dla platformy .NET to zaawansowana biblioteka umożliwiająca programistom tworzenie, modyfikowanie i manipulowanie dokumentami PDF programowo, z wykorzystaniem rozbudowanych funkcji.

Jak mogę otrzymać wersję próbną Aspose.PDF?

Bezpłatną wersję próbną Aspose.PDF można uzyskać, odwiedzając stronęten link.

Czy mogę uzyskać pomoc dotyczącą Aspose.PDF?

Tak, możesz skontaktować się z pomocą techniczną za pośrednictwemforum Aspose.

Gdzie mogę znaleźć szczegółową dokumentację Aspose.PDF?

Pełną dokumentację można znaleźćTutaj.

Utwórz element tabeli Elementy struktury ilustracji