> ## 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.

# Создание доступных PDF

Со временем развитие возможностей создания PDF сделало доступность PDF-документов достижимой. Благодаря таким достижениям, как [LaTeX Tagging Project](https://latex3.github.io/tagging-project/documentation/), доступными стали и PDF-файлы, созданные с помощью LaTeX, и улучшения продолжаются.

<Check>
  Именно выпуск [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) делает этот процесс возможным в Overleaf. Обратите внимание, что при использовании MathML рекомендуемым компилятором является **LuaLaTeX**.

  Чтобы убедиться, что параметры вашего проекта настроены соответствующим образом, узнайте, как [сменить компилятор и версию TeX Live](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Check>

Наш подход в значительной степени основан на [инструкциях по созданию доступных PDF](https://latex3.github.io/tagging-project/documentation/usage-instructions) от LaTeX Project, к которым можно обратиться за подробностями по следующим темам.

<Warning>
  Обратите внимание, что применение этих практик не гарантирует доступности каждого элемента вашего проекта — подробнее см. в разделе «Часто задаваемые вопросы» на этой странице.
</Warning>

### <Icon icon="tag" /> Разметка тегами

По сути, разметка PDF тегами — это процесс, который автоматически создаёт «структуру», легко распознаваемую программами чтения с экрана и улучшающую возможности поиска как сейчас, так и в будущем. Он использует существующую структуру, заданную вашим кодом LaTeX, чтобы программа чтения с экрана могла различать такие элементы, как заголовки, основной текст, рисунки и формулы.

TeX Live 2025 полностью поддерживает автоматическую разметку PDF тегами с помощью объявления `\DocumentMetaData`. Добавьте это объявление перед `\documentclass`. У этого объявления есть два важных ключа, влияющих на возможности разметки тегами: `tagging` и `tagging-setup`.

#### **`tagging`**

Убедитесь, что разметка тегами включена, установив для ключа `tagging` значение `on`.

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

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

Настройте способ разметки документа тегами, изменив значение ключа `tagging-setup`.

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

<Info>
  В этом примере мы использовали \`math/setup=mathml-SE\` для разметки тегами структурных элементов MathML, но можно задать любое значение, которое поддерживает \[\`\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" /> Описания

Помимо автоматической разметки тегами, может потребоваться добавить описания содержимого элементов, особенно если ваш документ содержит изображения и/или таблицы.

#### <Icon icon="image" /> Изображения

Добавлять важные описания к изображениям в Overleaf просто; кроме того, это помогает понять контекст определённых изображений при работе с кодом LaTeX. Всё, что нужно, — добавить соответствующий параметр описания изображения в каждый вызов `\includegraphics`. С точки зрения доступности различают три основных типа изображений: изображения, требующие альтернативного (alt) текста, артефакты и изображения, соответствующие реальному тексту.

**Альтернативный текст**

Добавление альтернативного текста к изображениям гарантирует, что у изображения есть описание, которое можно использовать как текстовую замену визуального содержимого. Используйте ключ `alt` и укажите текстовое значение.

```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}
```

**Артефакты**

Если изображение не должно распознаваться программой чтения с экрана (например, если оно носит чисто декоративный характер), пометьте его как артефакт. Используйте ключ `artifact` без присвоения значения.

```latex title="Artifact example" wrap theme={null}
\includegraphics[artifact]{.jpg}
```

**Реальный текст**

Если изображение представляет собой лишь изображение символа Unicode, укажите соответствующий текстовый символ. Используйте ключ `actualtext` и присвойте ему один символ (без скобок).

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

#### <Icon icon="table" /> Таблицы

Хотя таблицы обычно содержат текст, важно, чтобы этот текст был связан с правильными частями таблицы. Добавьте `\tagpdfsetup` перед `tabular` или в преамбулу, чтобы начать настройку таблиц в вашем проекте Overleaf. С точки зрения доступности различают два основных типа таблиц: таблицы данных и презентационные таблицы.

**Таблицы данных**

Если в таблице есть хотя бы одна строка заголовка, укажите, какие строки являются строками заголовка. Используйте ключ `table/header-rows` и укажите последовательность номеров, соответствующих положению строк заголовка.

```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}
```

**Презентационные таблицы**

Если таблица не должна интерпретироваться программой чтения с экрана как таблица, пометьте её как презентационную. Используйте ключ `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" /> Часто задаваемые вопросы

<Accordion title="Есть ли инструменты, которые помогут проверить доступность моего документа?">
  Да, существует несколько внешних инструментов, включая [veraPDF](https://verapdf.org/), которые могут проверять части PDF/A и уровни соответствия. Кроме того, для расчёта коэффициента контрастности между двумя цветами можно использовать такой инструмент, как [WebAIM](https://webaim.org/).
</Accordion>

<Accordion title="Совместимы ли пакеты в моём проекте Overleaf с этими функциями?">
  Вы можете обратиться к [списку статусов пакетов](https://latex3.github.io/tagging-project/tagging-status/) LaTeX Tagging Project.
</Accordion>

<Accordion title="Можно ли по-прежнему использовать `beamer`? Есть ли другие пакеты для презентаций?">
  Использование `beamer` имеет ограничения; обратите внимание на экспериментальный [класс `ltx-talk`](https://ctan.org/pkg/ltx-talk).
</Accordion>

<Accordion title="Доступен ли редактор Overleaf?">
  Да. Как веб-приложение Overleaf использует функции доступности современных веб-браузеров, которые регулярно оцениваются экспертами по доступности. Наш последний заполненный [Voluntary Product Accessibility Template (VPAT)](https://www.overleaf.com/for/customers/vpat) подтверждает соответствие Web Content Accessibility Guidelines (WCAG) 2.2 уровня AA.
</Accordion>

<Accordion title="Могут ли PDF, созданные в Overleaf, соответствовать требованиям раздела II Закона об американцах с ограниченными возможностями (ADA) и гармонизированного европейского стандарта доступности (EN 301 549)?">
  Да. Законодательство США и Европы требует, чтобы PDF соответствовали WCAG 2.1 AA. Чтобы соответствовать WCAG 2.1 AA, PDF должен быть размечен тегами. Поддержка разметки PDF тегами предоставляется в TeX Live 2025.
</Accordion>

<Accordion title="Могут ли PDF, созданные в Overleaf, соответствовать стандарту PDF/UA-1?">
  Да. Tagging Project от LaTeX Project специально разработан для создания структурных тегов, требуемых PDF/UA-1 (и готовящимся PDF/UA-2). Если пользователь следует текущим рекомендациям LaTeX Project по разметке тегами, он фактически создаёт документ, «готовый к PDF/UA», что является самым надёжным способом выполнить юридическое требование WCAG 2.1 AA, установленное законодательством США и Европы.
</Accordion>

<Accordion title="Как переключить компилятор на LuaLaTeX?">
  Перейти на LuaLaTeX — движок компиляции LaTeX, рекомендованный командой проекта LaTeX Tagging, — очень просто. Хотя по умолчанию в Overleaf используется компилятор PDFLaTeX, вы можете [переключиться на LuaLaTeX в настройках проекта](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="Где выбрать самую свежую версию TeX Live?">
  Самую свежую версию можно получить в [Overleaf Labs](https://www.overleaf.com/labs/participate), где предоставляется доступ к образу «rolling TeX Live» в Overleaf, включая новейшую поддержку разметки PDF тегами. Эта экспериментальная версия TeX Live предназначена в первую очередь для тестирования изменений в TeX Live и пакетах, а также для предварительного ознакомления с новыми функциями доступности до их включения в наш ежегодный выпуск TeX Live.

  Большинство функций разметки PDF тегами доступны в стандартном образе [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available).
</Accordion>

[^1]: Автоматическая разметка тегами включена.

[^2]: Задана конфигурация разметки тегами.

[^3]: У изображения есть альтернативный текст.

[^4]: Изображение является артефактом.

[^5]: Изображение является символом.

[^6]: В таблице одна строка заголовка.

[^7]: Таблица является презентационной.


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