Tworzenie dostępnych plików PDF

Z czasem rozwój możliwości tworzenia plików PDF umożliwił zapewnienie ich dostępności. Postępy, w tym LaTeX Tagging Project, sprawiły, że dostępne mogą być również pliki PDF generowane w LaTeX-u, a usprawnienia wciąż trwają.

To przede wszystkim wydanie TeX Live 2025 umożliwia ten proces w Overleaf. Pamiętaj, że przy korzystaniu z MathML zalecanym kompilatorem jest LuaLaTeX.

Aby upewnić się, że ustawienia projektu są odpowiednio skonfigurowane, dowiedz się, jak zmienić kompilator i wersję TeX Live.

Nasze podejście opiera się w dużej mierze na instrukcjach tworzenia dostępnych plików PDF opracowanych przez LaTeX Project, w których znajdziesz więcej szczegółów na poniższe tematy.

Pamiętaj, że stosowanie tych praktyk nie gwarantuje dostępności każdego elementu projektu — więcej informacji znajdziesz w sekcji FAQ na tej stronie.

​

Tagowanie

W skrócie tagowanie PDF to proces, który automatycznie tworzy „strukturę” łatwo rozpoznawalną przez czytniki ekranu i ułatwiającą przeszukiwanie, zarówno obecnie, jak i w przyszłości. Wykorzystuje on istniejącą strukturę zdefiniowaną w kodzie LaTeX, dzięki czemu czytnik ekranu potrafi odróżnić elementy takie jak nagłówki, tekst główny, rysunki i równania.

TeX Live 2025 w pełni obsługuje automatyczne tagi PDF za pomocą deklaracji \DocumentMetaData. Dodaj tę deklarację przed \documentclass. Deklaracja ta ma dwa ważne klucze wpływające na możliwości tagowania: tagging i tagging-setup .

​

tagging

Upewnij się, że tagowanie jest włączone, ustawiając klucz tagging na on.

\DocumentMetadata{tagging=on}

​

tagging-setup

Skonfiguruj sposób tagowania dokumentu, zmieniając wartość klucza tagging-setup.

\DocumentMetadata{tagging=on,tagging-setup={math/setup=mathml-SE}}

W tym przykładzie użyliśmy `math/setup=mathml-SE` do tagowania elementów struktury MathML, ale można ustawić dowolną wartość obsługiwaną przez [`\tagpdfsetup`](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf).

​

Opisy

Oprócz automatycznego tagowania może być również konieczne dodanie opisów zawartości elementów, zwłaszcza jeśli dokument zawiera obrazy lub tabele.

​

Obrazy

Dodawanie istotnych opisów obrazów w Overleaf jest proste i może też pomóc zrozumieć kontekst niektórych obrazów podczas przeglądania kodu LaTeX. Wystarczy dodać odpowiednią opcję opisu obrazu w każdym wystąpieniu \includegraphics. Pod kątem dostępności wyróżnia się trzy główne typy obrazów: obrazy wymagające tekstu alternatywnego (alt), artefakty oraz obrazy odpowiadające faktycznemu tekstowi.

Tekst alternatywny

Dodanie tekstu alternatywnego do obrazów zapewnia, że zdjęcie ma opis, który może służyć jako tekstowy zamiennik treści wizualnej. Użyj klucza alt i podaj wartość tekstową.

Alt text example

\includegraphics[width=0.25\linewidth,alt={Macro photo of a green frog's head and hands}]{frog.jpg}

Artefakty

Jeśli obraz nie musi być odczytywany przez czytnik ekranu (tj. jest czysto dekoracyjny), oznacz go jako artefakt. Użyj klucza artifact bez przypisywania wartości.

Artifact example

\includegraphics[artifact]{.jpg}

Faktyczny tekst

Jeśli obraz jest wyłącznie obrazkiem znaku Unicode, podaj ten znak w postaci tekstowej. Użyj klucza actualtext i przypisz mu pojedynczy znak (bez nawiasów).

Actual text example

\includegraphics[actualtext=B]{.jpg}

​

Tabele

Choć tabele zwykle zawierają tekst, nadal ważne jest, aby był on powiązany z właściwymi elementami tabeli. Dodaj \tagpdfsetup przed środowiskiem tabular lub w preambule, aby rozpocząć konfigurację tabel w projekcie Overleaf. Pod kątem dostępności wyróżnia się dwa główne typy tabel: tabele danych i tabele prezentacyjne.

Tabele danych

Jeśli tabela ma co najmniej jeden wiersz nagłówka, wskaż, które wiersze są wierszami nagłówka. Użyj klucza table/header-rows i podaj ciąg liczb odpowiadających położeniu wierszy nagłówka.

Data table example

\tagpdfsetup{table/header-rows={1}}
\begin{tabular}{l|r}
Item & Quantity \\\hline
Widgets & 42 \\
Gadgets & 13
\end{tabular}

Tabele prezentacyjne

Jeśli tabela nie powinna być interpretowana przez czytnik ekranu jako tabela, oznacz ją jako tabelę prezentacyjną. Użyj klucza table/tagging=presentation.

Presentation table example

\tagpdfsetup{table/tagging=presentation}
\begin{tabular}{cc}
\textbullet & \textbullet \\
''' & '''
\end{tabular}

​

FAQ

Czy istnieją narzędzia, które pomogą sprawdzić, czy mój dokument jest dostępny?

Tak, istnieje kilka zewnętrznych narzędzi, w tym veraPDF, które potrafią weryfikować części i poziomy zgodności PDF/A. Dodatkowo możesz użyć narzędzia takiego jak WebAIM, aby obliczyć współczynnik kontrastu między dwoma kolorami.

Czy pakiety w moim projekcie Overleaf są zgodne z tymi funkcjami?

Możesz zajrzeć na listę statusu pakietów LaTeX Tagging Project.

Czy nadal mogę używać beamer? Czy są dostępne inne pakiety do prezentacji?

Korzystanie z beamer wiąże się z ograniczeniami; wypróbuj eksperymentalną klasę ltx-talk.

Czy edytor Overleaf jest dostępny?

Tak. Jako aplikacja internetowa Overleaf wykorzystuje funkcje dostępności nowoczesnych przeglądarek, które są regularnie oceniane przez ekspertów ds. dostępności. Nasz najnowszy ukończony Voluntary Product Accessibility Template (VPAT) wykazuje zgodność z wytycznymi Web Content Accessibility Guidelines (WCAG) 2.2 na poziomie AA.

Czy pliki PDF tworzone przez Overleaf mogą spełniać wymagania tytułu II ustawy Americans with Disability Act (ADA) i zharmonizowanej normy europejskiej dotyczącej dostępności (EN 301 549)?

Tak. Przepisy w Stanach Zjednoczonych i Europie wymagają, aby pliki PDF spełniały WCAG 2.1 AA. Aby spełnić WCAG 2.1 AA, plik PDF musi być otagowany. Obsługę tagowania plików PDF zapewnia TeX Live 2025.

Czy pliki PDF tworzone przez Overleaf mogą spełniać standard PDF/UA-1?

Tak. Tagging Project prowadzony przez LaTeX Project został zaprojektowany specjalnie do tworzenia tagów strukturalnych wymaganych przez PDF/UA-1 (oraz nadchodzący PDF/UA-2). Jeśli użytkownik stosuje się do aktualnych zaleceń LaTeX Project dotyczących tagowania, w praktyce tworzy dokument „gotowy na PDF/UA”, co jest najpewniejszym sposobem spełnienia prawnego wymogu WCAG 2.1 AA, nałożonego przez przepisy amerykańskie i europejskie.

Jak przełączyć kompilator na LuaLaTeX?

Przejście na LuaLaTeX, silnik kompilacji LaTeX zalecany przez zespół LaTeX Tagging Project, jest łatwe. Choć domyślnym kompilatorem w Overleaf jest PDFLaTeX, możesz przełączyć się na LuaLaTeX w ustawieniach projektu.

Gdzie mogę wybrać najnowszą wersję TeX Live?

Najnowszą wersję znajdziesz w Overleaf Labs, który zapewnia dostęp do obrazu „rolling TeX Live” w Overleaf, w tym do najnowszej obsługi tagowania PDF. Ta eksperymentalna wersja TeX Live służy przede wszystkim do testowania zmian w TeX Live i pakietach oraz do podglądu nowych funkcji dostępności, zanim trafią do naszego corocznego wydania TeX Live.

Większość funkcji tagowania PDF jest dostępna w standardowym obrazie TeX Live 2025.