# Предпроверка

Проверяйте исходник, журнал сборки, PDF, источники, признаки доступности и риски подачи, прежде чем документ покинет ваши руки.

Успешная компиляция доказывает лишь то, что PDF был создан. Она не доказывает, что разрешилась каждая цитата, порядок чтения осмыслен, архив подачи чист или что файл действительно несёт заявленную структуру доступности.

Предпроверка собирает эти вопросы в один локальный обзор. Откройте значок **щита** на панели проекта, выберите проверки, подходящие документу, и запускайте одну проверку, пока исправляете проблему, или весь набор перед подачей.

![Панель предпроверки Oleafly. Выберите нужные проверки, запустите одну из её строки или все включённые проверки кнопкой внизу.](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![Предпроверка запускает проверки сборки, подачи и доступности для статьи перед отправкой.](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## Шесть независимых проверок

### Компиляция и вёрстка

Читает последний журнал сборки и PDF и находит неудачные сборки, неразрешённые цитаты и ссылки, предупреждения о повторных проходах, отсутствующие глифы, переполненные блоки, обрезанный текст, повторяющиеся точки назначения PDF и разные размеры страниц.

### Готовность к подаче

Применяет к проекту выбранный публикационный профиль. Проверяются устойчивые требования к классу документа, аннотации и ключевым словам, форматам рисунков, встроенным шрифтам, ограничениям PDF, подписям, переносимым именам и мусору в пакете исходников.

### Готовность к ATS

Извлекает резюме примерно так, как это сделала бы система отбора кандидатов. Отчёт содержит контактные поля, ожидаемые разделы и вёрстку, которая может перепутать порядок чтения.

### Доступность

Проверяет сигналы исходника и PDF: тегирование, альтернативный текст, метаданные языка и заголовка, настройки просмотрщика, заголовки, таблицы, ссылки, порядок чтения, выделяемый текст, закладки там, где они полезны, и очень мелкий текст.

### Источники и ресурсы

Находит отсутствующие файлы, неразрешённые цитаты и перекрёстные ссылки, повторяющиеся метки и DOI, неполные записи библиографии и непроцитированные источники, когда доступен полный проект.

### Приватность и слепое рецензирование

Ищет учётные данные, закрытые ключи, конфиденциальные файлы, черновые заметки, внутренние комментарии, благодарности, поля авторов и метаданные личности, которые могут сорвать слепое рецензирование.

## Проекты Typst

Для исходников Typst есть собственные проверки. Они читают ваши файлы `.typ` напрямую, поэтому правила LaTeX никогда не срабатывают на синтаксисе Typst.

- **Источники и ресурсы** находит ссылки `@` и цитаты без подходящей метки или записи библиографии, повторяющиеся метки, пути изображений или `#include`, которым не соответствует ни один файл проекта, файл `#bibliography`, которого нет в проекте, и документ, который цитирует источники, но ни разу не вызывает `#bibliography`. Ключи цитирования могут находиться в файле `.bib` или в файле `.yml` Hayagriva.
- **Доступность** отмечает изображения без текста `alt` — на самом изображении или на содержащем его рисунке, — пустые заголовки и документ без заголовка, заданного через `#set document(title: ...)` или шаблон.
- **Готовность к подаче** проверяет, что проект подключает шаблон, подходящий выбранному профилю, что шаблон получает аннотацию и ключевые слова и что не осталось текста `#lorem`, заполнителей или заметок TODO. Она также смотрит подписи, размеры изображений и имена файлов.
- **Приватность и слепое рецензирование** находит переданные в шаблон имена авторов, адреса почты и аффилиации, благодарности и локальные пути файлов.

Каждое замечание называет файл и строку, а его подробности показывают исправление для Typst, например `#image("chart.png", alt: "Bar chart of yearly sales")`.

## Смотрите на достоверность, а не только на цвет

Каждый результат объясняет, как Oleafly к нему пришёл:

- **Подтверждено** — приложение наблюдало прямое свидетельство в исходнике, журнале, проекте или PDF.
- **Рекомендация** — документированная эвристика нашла то, что человеку стоит проверить.
- **Вручную** — проверка, которую файлы не могут надёжно закрыть сами.

Отсутствующие входные данные никогда не превращаются в успех. Замечания только по исходнику остаются частичными, пока не появится текущий PDF.

## Выберите публикационный профиль

Используйте профиль общей публикации, arXiv, IEEE, ACM, журнала или диссертации, который лучше всего соответствует месту публикации. Профили охватывают требования, достаточно стабильные для автоматической проверки. В проекте Typst профиль дополнительно ожидает подходящий шаблон Typst, и замечание называет принимаемые шаблоны.

Затем откройте действующие инструкции площадки. Лимиты страниц, поля, ограничения на размер файлов, правила анонимизации и соглашения об именах меняются слишком часто, чтобы общий профиль решал их за вас.

## Посмотрите, что получает другой читатель

Выберите **Скринридер** на панели предпроверки, чтобы открыть режим **Что видит читатель**, который извлекает текст PDF страница за страницей. Используйте его, чтобы заметить статью из двух колонок, читающуюся поперёк страницы, номер телефона, пропавший из-за значкового шрифта, подпись не на своём месте или страницу без выделяемого текста.

Для резюме режим **Что извлёк парсер** показывает имя, почту, телефон, ссылки и стандартные разделы, которые смогла восстановить имитация ATS.

Эти режимы — свидетельство, а не замена проверке с настоящим порталом подачи, программой чтения с экрана или парсером, которыми пользуется ваша аудитория.

## PDF/UA и доступность: честная граница

Oleafly проверяет ту часть PDF/UA-1, которую можно прочитать из самого файла. Замечания ссылаются на PDF/UA-1, на PDF/UA-2 там, где он отличается, на контрольные точки Matterhorn Protocol и методики WCAG 2.2 для PDF.

Отчёт охватывает машиночитаемые сигналы, например:

- дерево тегов, содержащее настоящее содержимое;
- альтернативный текст у рисунков и формул;
- ячейки заголовков в таблицах;
- последовательность заголовков;
- язык документа и заголовок XMP;
- настройку просмотрщика, которая показывает заголовок;
- описания ссылок и подозрительное содержимое без тегов;
- подтверждает ли файл заявленное соответствие PDF/UA-1.

Панель сообщает, сколько из 106 машиночитаемых правил PDF/UA-1 проверено. Она также сообщает, когда правило не удалось прочитать или оно не применимо. Непроверенное правило не засчитывается как пройденное.

:::caution[Предпроверка не сертифицирует PDF/UA]
Это выборочная проверка, а не заявление о соответствии. Oleafly не может решить, осмыслен ли альтернативный текст, понятен ли человеку порядок чтения, достаточен ли контраст цветов и хорошо ли документ работает со вспомогательными технологиями читателя. Для формального заключения о соответствии проверьте итоговый файл в veraPDF или PAC 2024 и завершите проверку человеком.
:::

## Подготовка тегированного PDF из LaTeX

Тегирование в LaTeX зависит от класса документа, пакетов, движка и версии TeX Live. Прежде чем предложить подготовку, предпроверка проверяет действующий главный документ и файлы преамбулы, которые он загружает.

1. Запустите проверку **Доступность** на текущем PDF и прочитайте замечания.
2. Откройте **Доступный экспорт**.
3. Изучите отчёт о совместимости класса и пакетов. Несовместимый класс блокирует подготовку; частично совместимый или неизвестный пакет показывается как предупреждение.
4. Выберите **Подготовить к доступному экспорту** и просмотрите каждое предлагаемое изменение исходника.
5. Замените каждый созданный заполнитель альтернативного текста осмысленным описанием и добавьте заголовок документа, когда приложение попросит.
6. Скомпилируйте через pdfLaTeX или LuaLaTeX из TeX Live 2026 или из TeX Live, обновлённого с ноября 2025 года. Доступным формулам нужен LuaLaTeX.
7. Запустите проверку «Доступность» ещё раз, изучите режим чтения, а затем, когда важно соответствие, проверьте итоговый PDF вне Oleafly.

Подготовка может добавить или обновить `\DocumentMetadata` с языком, намерением PDF/UA-2 и тегированием; объявить первую строку заголовка таблицы; добавить видимые заполнители для отсутствующих альтернатив рисунков; и подключить `unicode-math`, если выбранному движку он нужен. Изменения показываются до их применения.

Строка `\DocumentMetadata` помещается внутрь проверки версии. LaTeX старше ноября 2025 года, например встроенного движка, пропускает её и собирает документ без тегов, а не завершается ошибкой, и PDF не заявляет о соответствии PDF/UA. Тогда предпроверка сообщает **Тегирование пропущено, потому что этот LaTeX слишком старый** и называет LaTeX, на котором шла сборка.

Встроенный движок Tectonic не умеет создавать дерево тегов. **Скомпилировать с тегами и проверить** использует доступный системный дистрибутив TeX или управляемый Oleafly TinyTeX и всегда запускает LuaLaTeX, даже в проекте на Tectonic. Если компиляция с тегами останавливается на отсутствующем файле, например `tagpdf-base.sty` в TinyTeX, Oleafly предлагает установить его, как при обычной компиляции, а затем запускает компиляцию с тегами снова. Подготовленный исходник можно также скомпилировать вашим собственным актуальным инструментарием.

:::note[Совместимость может стать препятствием]
Предпроверка использует опубликованные LaTeX Project данные о состоянии тегирования. Неподдерживаемые классы блокируются, частично поддерживаемые помечаются предупреждением, а пакеты, которых нет в данных, считаются неизвестными, а не безопасными. Пакет `enumitem` сейчас заблокирован, потому что его нельзя загрузить в тегированном рабочем процессе.
:::

См. [Движки и пакеты LaTeX](/docs/latex-engines/) — там описаны TinyTeX, состояние пакетов и граница безопасности вокруг системного TeX.

## Стандарты PDF из Typst

В проекте Typst нет исходника, который нужно готовить. Typst сам создаёт архивные и доступные PDF, поэтому проверка **Доступность** показывает **Стандарты PDF** вместо **Доступного экспорта**.

1. Запустите проверку **Доступность** и исправьте отсутствующий альтернативный текст и отсутствующий заголовок документа. PDF/UA-1 нужно и то и другое.
2. В разделе **Стандарты PDF** выберите **Стандарт**, например PDF/UA-1 или PDF/A-2b.
3. Выберите **Экспортировать PDF** и сохраните файл.
4. Когда важно соответствие, проверьте экспортированный PDF вне Oleafly.

Typst 0.14 и новее тегирует каждый PDF, поэтому отдельной тегированной компиляции нет. Более старые версии предлагают меньше стандартов, а Typst 0.11 не предлагает ни одного; панель сообщает, какой из случаев применяется. Чтобы использовать более новую версию, измените **Версия Typst (этот проект)** в меню компиляции. См. [Проекты Typst](/docs/typst/#what-each-version-can-do).

## Практическая финальная проверка

1. Скомпилируйте именно тот исходник, который собираетесь подать.
2. Запустите все подходящие проверки предпроверки.
3. Исправьте подтверждённые замечания и разберите рекомендации.
4. Закройте каждый пункт «Вручную» по действующему руководству площадки.
5. Прочитайте итоговый PDF от первой страницы до последней, включая источники и приложения.
6. Откройте экспортированный файл и архив исходников из мест, где они сохранены.
7. До крайнего срока используйте собственный валидатор места подачи.

Предпроверка сокращает число предотвратимых неожиданностей. Принятие работы, доступность и научная корректность по-прежнему требуют автора, площадки и людей, которые будут пользоваться документом.
