> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://latex3.github.io/tagging-project/documentation/), sprawiły, że dostępne mogą być również pliki PDF generowane w LaTeX-u, a usprawnienia wciąż trwają.

<Check>
  To przede wszystkim wydanie [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) 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](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Check>

Nasze podejście opiera się w dużej mierze na [instrukcjach tworzenia dostępnych plików PDF](https://latex3.github.io/tagging-project/documentation/usage-instructions) opracowanych przez LaTeX Project, w których znajdziesz więcej szczegółów na poniższe tematy.

<Warning>
  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.
</Warning>

### <Icon icon="tag" /> 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`.

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on}
```

#### **`tagging-setup`**

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

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on,tagging-setup={math/setup=mathml-SE}}
```

<Info>
  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](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf)).
</Info>

### <Icon icon="text-size" /> 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.

#### <Icon icon="image" /> 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ą.

```latex title="Alt text example" wrap theme={null}
\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.

```latex title="Artifact example" wrap theme={null}
\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).

```latex title="Actual text example" wrap theme={null}
\includegraphics[actualtext=B]{.jpg}
```

#### <Icon icon="table" /> 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.

```latex title="Data table example" theme={null}
\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`.

```latex title="Presentation table example" theme={null}
\tagpdfsetup{table/tagging=presentation}
\begin{tabular}{cc}
\textbullet & \textbullet \\
''' & '''
\end{tabular}
```

### <Icon icon="comments-question" /> FAQ

<Accordion title="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](https://verapdf.org/), które potrafią weryfikować części i poziomy zgodności PDF/A. Dodatkowo możesz użyć narzędzia takiego jak [WebAIM](https://webaim.org/), aby obliczyć współczynnik kontrastu między dwoma kolorami.
</Accordion>

<Accordion title="Czy pakiety w moim projekcie Overleaf są zgodne z tymi funkcjami?">
  Możesz zajrzeć na [listę statusu pakietów](https://latex3.github.io/tagging-project/tagging-status/) LaTeX Tagging Project.
</Accordion>

<Accordion title="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`](https://ctan.org/pkg/ltx-talk).
</Accordion>

<Accordion title="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)](https://www.overleaf.com/for/customers/vpat) wykazuje zgodność z wytycznymi Web Content Accessibility Guidelines (WCAG) 2.2 na poziomie AA.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="Gdzie mogę wybrać najnowszą wersję TeX Live?">
  Najnowszą wersję znajdziesz w [Overleaf Labs](https://www.overleaf.com/labs/participate), 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](https://www.overleaf.com/blog/tex-live-2025-is-now-available).
</Accordion>

[^1]: Automatyczne tagowanie jest włączone.

[^2]: Konfiguracja tagowania jest ustawiona.

[^3]: Obraz ma tekst alternatywny.

[^4]: Obraz jest artefaktem.

[^5]: Obraz jest znakiem.

[^6]: Tabela ma jeden wiersz nagłówka.

[^7]: Tabela jest tabelą prezentacyjną.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.