How to Export PDF/UA Format Documents in C

Jakiego kodu potrzebuję do eksportu do formatu PDF/UA?

Poniższy przykład ilustruje konwersję istniejącego pliku PDF do formatu PDF/UA. Takie podejście sprawdza się w przypadku starszych dokumentów, które muszą spełniać standardy dostępności. Proces konwersji zachowuje treść dokumentu, dodając jednocześnie struktury ułatwiające dostępność wymagane przez standard PDF/UA.

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-fromfile.cs

using IronPdf;

// Open PDF File
PdfDocument pdf = PdfDocument.FromFile("wikipedia.pdf");

// Export as PDF/UA compliance PDF
pdf.SaveAsPdfUA("pdf-ua-wikipedia.pdf");

Imports IronPdf

' Open PDF File
Dim pdf As PdfDocument = PdfDocument.FromFile("wikipedia.pdf")

' Export as PDF/UA compliance PDF
pdf.SaveAsPdfUA("pdf-ua-wikipedia.pdf")

Jaka jest różnica między PDF/UA-1 a PDF/UA-2?

PDF/UA-1 (ISO 14289-1) to oryginalny uniwersalny standard dostępności dokumentów PDF, opublikowany w 2012 roku. Stanowi on podstawę dla plików PDF zapewniających dostępność dzięki obsłudze technologii wspomagających i treści ustrukturyzowanej.

PDF/UA-2 (ISO 14289-2:2024) to najnowsza wersja, oferująca rozszerzoną obsługę nowoczesnych funkcji PDF, w tym ulepszoną obsługę pól formularzy, adnotacji, treści multimedialnych i złożonych struktur dokumentów. PDF/UA-2 zapewnia lepszą zgodność ze specyfikacjami PDF 2.0, zachowując jednocześnie kompatybilność wsteczną z wymaganiami dotyczącymi dostępności.

Aby określić format PDF/UA-2 podczas eksportowania, należy użyć parametru version w metodzie SaveAsPdfUA:

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-pdfua2.cs

using IronPdf;

// Load existing PDF
var pdf = PdfDocument.FromFile("input.pdf");

// Export as PDF/UA-2 format
pdf.SaveAsPdfUA("output_pdfua2.pdf", PdfUaVersion.PdfUa2);

Imports IronPdf

' Load existing PDF
Dim pdf = PdfDocument.FromFile("input.pdf")

' Export as PDF/UA-2 format
pdf.SaveAsPdfUA("output_pdfua2.pdf", PdfUaVersion.PdfUa2)

Jak przekonwertować do formatu PDF/UA-2 w pamięci?

W przypadku przepływów pracy wymagających dodatkowych modyfikacji przed zapisaniem należy użyć ConvertToPdfUA(), aby najpierw przekonwertować dokumenty w pamięci. Takie podejście pozwala na zastosowanie transformacji zgodnych z PDF/UA-2, a następnie wykonanie innych operacji przed ostatecznym eksportem:

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-convert-ua2.cs

using IronPdf;

// Open PDF File
PdfDocument pdf = PdfDocument.FromFile("input.pdf");

// Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2);

// Perform additional modifications if needed
// ...

// Save the converted document
pdf.SaveAs("output-ua2.pdf");

Imports IronPdf

' Open PDF File
Dim pdf As PdfDocument = PdfDocument.FromFile("input.pdf")

' Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2)

' Perform additional modifications if needed
' ...

' Save the converted document
pdf.SaveAs("output-ua2.pdf")

Jak wygląda plik wyjściowy w formacie PDF/UA?

Plik wyjściowy jest zgodny ze standardem PDF/UA:

Wynik w formacie PDF:

Jak renderować HTML bezpośrednio do formatu PDF/UA?

Oprócz eksportowania dokumentów do formatu PDF/UA, należy użyć metody RenderHtmlAsPdfUA do renderowania danych wejściowych HTML bezpośrednio do formatu PDF/UA. Takie podejście sprawdza się zarówno podczas tworzenia nowych dokumentów od podstaw, jak i podczas pracy z treściami dynamicznymi z aplikacji internetowych.

Podczas renderowania HTML do formatu PDF/UA upewnij się, że kod HTML jest zgodny z najlepszymi praktykami w zakresie dostępności: używaj semantycznych elementów HTML, zapewnij odpowiednią hierarchię nagłówków, dołącz tekst alternatywny do obrazów i zachowaj logiczny przebieg treści. Silnik renderujący IronPDF dla przeglądarki Chrome zapewnia dokładną konwersję przy zachowaniu funkcji ułatwień dostępu. Więcej informacji na temat konwersji HTML do PDF można znaleźć w naszym przewodniku HTML do PDF.

Oto przykładowy kod:

Jaki kod renderuje HTML do formatu PDF/UA?

Ten przykład pokazuje, jak utworzyć dokument zgodny ze standardem PDF/UA bezpośrednio z treści HTML. Należy zwrócić uwagę na użycie semantycznych elementów HTML, takich jak nagłówki i akapity, które są niezbędne do tworzenia dokumentów PDF dostępnych dla osób niepełnosprawnych. Tytuł metadanych zapewnia prawidłową identyfikację dokumentu, co jest wymogiem zgodności z PDF/UA.

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-render-html-to-pdfua.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// html is a large stright above of a full html page with <html><head><style><body> etc...
var pdf = renderer.RenderHtmlAsPdfUA(@"
    <!DOCTYPE html>
    <html>
    <head>
        <title>Document</title>
    </head>
    <body>
        <h1>Heading 1</h1>
        <h2>Heading 2</h2>
        <p>Paragraph text</p>
    </body>
    </html>");

pdf.MetaData.Title = "v2025.1";

pdf.SaveAs("html-string-ua-ironpdf.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' html is a large stright above of a full html page with <html><head><style><body> etc...
Private pdf = renderer.RenderHtmlAsPdfUA("
    <!DOCTYPE html>
    <html>
    <head>
        <title>Document</title>
    </head>
    <body>
        <h1>Heading 1</h1>
        <h2>Heading 2</h2>
        <p>Paragraph text</p>
    </body>
    </html>")

pdf.MetaData.Title = "v2025.1"

pdf.SaveAs("html-string-ua-ironpdf.pdf")

Jak sprawdzić zgodność z PDF/UA?

Plik wyjściowy jest zgodny ze standardem PDF/UA:

Aby zweryfikować zgodność z PDF/UA na zewnątrz, użyj narzędzia veraPDF Conformance Checker, darmowego i otwartego oprogramowania przeznaczonego do sprawdzania plików PDF. Narzędzie to sprawdza dokumenty pod kątem zgodności ze standardami PDF/UA-1 i PDF/UA-2 oraz dostarcza szczegółowe raporty dotyczące problemów związanych z zgodnością. Regularna walidacja ma kluczowe znaczenie podczas wdrażania funkcji ułatwień dostępu w procesie pracy z plikami PDF.