# Экспорт и конвертация проекта

Сохраните последний PDF, упакуйте редактируемый исходный код, экспортируйте изображения страниц или HTML, создайте PDF/A и PDF/UA из Typst или конвертируйте документ LaTeX, Typst или Markdown.

Откройте **Экспорт** на панели инструментов проекта. Меню зависит от текущего движка и типа документа, поэтому в нём показываются только те маршруты, которые Oleafly может выполнить для этого проекта.

![Экспорт — это элемент загрузки сразу после кнопки «Скомпилировать заново» в верхней панели проекта.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## Выберите результат, который нужен получателю

- **PDF** подходит для чтения, печати и большинства порталов подачи.
- **ZIP с исходным кодом** нужен соавторам или системам, которым требуются рукопись, рисунки, библиография и локальные стили.
- **PNG страницы** нужен для слайда, сообщения или системы рецензирования, которой требуется изображение.
- **PNG, SVG или HTML, созданные Typst**, нужны проектам Typst, в которых требуются все страницы в виде изображений, векторные страницы или веб-страница.
- **Word, HTML, Markdown, Typst, LaTeX или обычный текст** нужны тому, кто хочет отредактировать или повторно использовать содержимое в другом формате.
- **PowerPoint** превращает презентацию или документ Markdown в слайды. **EPUB** предназначен для читалки электронных книг. Какие именно пункты появятся, зависит от движка. См. [Экспорт презентаций и книг](#presentation-and-book-exports).

## Сохраните PDF, архив исходного кода или изображение страницы

1. Выберите **Скомпилировать заново**, чтобы результат включал ваши последние правки.
2. Просмотрите PDF, включая последние страницы и библиографию.
3. Откройте **Экспорт**.
4. Выберите **Экспорт в PDF**, **Экспорт исходников (.zip)** или **Экспорт страницы в PNG**.
5. Укажите место сохранения в диалоге.
6. Выберите **Показать в папке** в сообщении о завершении, чтобы найти сохранённый файл.

Действия для PDF и изображений страниц остаются неактивными, пока у проекта нет PDF, и меню пишет **Для PDF сначала нужна компиляция**. **Экспорт в PDF** сохраняет PDF, показанный в предпросмотре. **Экспорт страницы в PNG** сохраняет в высоком разрешении ту страницу, которую вы смотрите в предпросмотре.

Архив исходного кода не включает кэши сборки и внутренние данные Git. Он также не содержит символические ссылки, и сообщение о завершении говорит, сколько из них пропущено.

### Когда PDF не актуален

Если предпросмотр устарел, Oleafly всё равно сохраняет PDF или изображение страницы, а сообщение о завершении сообщает вам об этом:

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

Скомпилируйте заново, проверьте предпросмотр и экспортируйте снова, прежде чем отправлять файл кому-либо.

## Изображения и HTML из Typst

В меню «Экспорт» проекта Typst есть также пункт **Изображения и HTML**, который открывает окно **Экспорт с помощью Typst**. Эти файлы создаёт сам Typst, поэтому страницы в PNG и SVG выглядят в точности как в PDF.

- **Изображения PNG** принимают **Разрешение** 72, 144, 300 или 600 PPI.
- **Изображения SVG** сохраняют страницы как векторную графику.
- **HTML** помечен как **Экспериментально**. HTML из Typst сохраняет текст и изображения, но не включает настройку страницы и рисунки. До Typst 0.15 в нём нет и формул, и диалог сообщает об этом, когда вы выбираете HTML.

Для PNG и SVG поле **Страницы** принимает номера и диапазоны страниц, например `1, 3-5` или `8-`. Оставьте его пустым, чтобы экспортировать все страницы. Каждая страница сохраняется в отдельный файл с номером в имени, которое вы выберете. Диапазоны страниц требуют Typst 0.12 или новее, а HTML требует Typst 0.13 или новее. Диалог предлагает только то, что умеет делать версия Typst проекта. Если в проекте есть [варианты сборки](/docs/typst/#build-variants-and-sysinputs), экспорт использует тот из них, который выбран в меню компиляции.

## PDF/A и PDF/UA из Typst

Typst сам создаёт архивные и доступные PDF. Откройте значок **щита** на панели проекта, чтобы попасть в [Предпроверку](/docs/preflight/), и найдите пункт **Стандарты PDF** в проверке **Доступность**. Выберите **Стандарт**, например PDF/A-2b или PDF/UA-1, затем нажмите **Экспортировать PDF**.

Список зависит от версии Typst проекта. В Typst 0.11 стандартов нет, Typst 0.12 предлагает PDF/A-2b, Typst 0.13 добавляет PDF/A-3b, а Typst 0.14 и новее предлагают все уровни PDF/A плюс PDF/UA-1. Кроме того, Typst 0.14 и новее добавляет теги во все PDF для программ чтения с экрана, поэтому отдельная компиляция с тегами не нужна. Для PDF/UA-1 требуются заголовок документа и альтернативный текст для каждого изображения, и Предпроверка проверяет и то и другое.

## Редактируемые форматы

| Движок проекта | Форматы в меню «Экспорт» |
| --- | --- |
| **LaTeX** | Word, автономный HTML с MathML, Markdown, Typst и обычный текст |
| **Typst** | LaTeX, Word, автономный HTML с MathML, Markdown и обычный текст |
| **Markdown** | Word, автономный HTML с MathML, Typst, LaTeX и обычный текст |

Проект Typst дополнительно предлагает EPUB, а проект Markdown дополнительно предлагает PowerPoint и EPUB. Проект LaTeX предлагает их только для подходящего класса документа.

Эти конвертации выполняются локально через Pandoc. Oleafly использует совместимую установку на вашем компьютере либо скачивает проверенную управляемую сборку, когда она впервые нужна.

Проекты Typst идут другим путём. Typst сначала записывает документ как HTML, а Pandoc превращает этот HTML в Word, HTML, Markdown, LaTeX, обычный текст или EPUB, поэтому формулы и ссылки сохраняются. Может ли документ пойти этим путём, зависит от версии Typst проекта:

| Версия Typst | Путь |
| --- | --- |
| 0.15 или новее | Через HTML |
| 0.13 и 0.14 | Через HTML, когда Typst может записать весь документ. Когда не может, Pandoc вместо этого читает исходный код Typst. |
| 0.12 или старше | Pandoc читает исходный код |

Если Typst останавливается с ошибкой при записи HTML, Pandoc читает исходный код в любой версии. Когда Pandoc читает исходный код в Typst 0.13 или 0.14, сообщение о завершении предупреждает, что повёрнутый, масштабированный, сдвинутый или наклонённый текст может отсутствовать, если только у экспорта нет предупреждений. Для самого полного экспорта переключите проект на Typst 0.15 или новее в пункте **Версия Typst (этот проект)** меню компиляции.

Когда экспорт идёт через HTML, текст внутри функций компоновки, таких как `align`, `grid` и `rotate`, сохраняется. Рисунок, сделанный в CeTZ, теряет линии и фигуры и сохраняет только текстовые подписи, а сообщение о завершении называет, что Typst не включил.

## Конвертируйте документ

1. Скомпилируйте один раз и исправьте ошибки в исходном коде.
2. Откройте **Экспорт** и выберите целевой формат.
3. Завершите настройку Pandoc, если появится запрос. Если Oleafly сообщает, что Pandoc недоступен, выберите **Восстановить Pandoc** в **Настройки → Движки → Markdown**, затем экспортируйте снова.
4. Сохраните преобразованный файл с предложенным расширением.
5. Прочитайте сообщение о завершении. Если в нём упомянуты предупреждения, выберите **Показать предупреждения**, чтобы увидеть, что экспорт не включил.
6. Откройте файл в целевом приложении и проверьте структуру и внешний вид.

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

Чтобы превратить целый проект LaTeX в проект Typst, в котором вы продолжите работать, используйте вместо этого [конвертацию в проект Typst](/docs/typst/#convert-a-latex-project-to-typst). Она создаёт новый проект и сообщает, на что нужно обратить внимание.

### Что сохраняет конвертация

Pandoc стремится сохранить заголовки, абзацы, списки, ссылки, цитирования, таблицы, изображения и редактируемые формулы. Он не может воспроизвести каждую возможность исходного языка в каждом целевом формате. Внимательно проверьте эти места:

- пользовательские команды и окружения LaTeX
- тщательно выверенную вёрстку страниц и плавающие объекты
- сложные или вложенные таблицы
- стиль библиографии и отображение цитирований
- функции Typst без прямого аналога в целевом формате
- чистый HTML и расширения Markdown

HTML-экспорт встраивает свои ресурсы и записывает формулы в виде MathML. Это делает его удобным для передачи документа, который должен открываться сам по себе, но всё же стоит проверить его в браузерах, которыми пользуются ваши читатели.

### Что сохраняет каждый формат

- Экспорт в Word и PowerPoint превращает рисунки PDF, SVG и WebP в картинки PNG с 220 ppi. Рисунок без размера в исходнике сохраняет собственную ширину.
- Экспорт в HTML и EPUB превращает рисунки PDF в картинки PNG.
- Markdown и обычный текст, экспортированные из LaTeX, сохраняют название, автора и аннотацию.
- Экспорт из LaTeX в Markdown или Typst и из Markdown в LaTeX или Typst ссылается на файлы рисунков проекта, а не копирует их. Если у экспорта нет предупреждений, сообщение о завершении напоминает скопировать изображения и библиографию рядом с экспортированным файлом, прежде чем компилировать его. Документ Markdown, экспортированный в Typst или LaTeX, сохраняет объявленную в нём библиографию, а если её нет — файлы `.bib` проекта.
- Экспорт документа Markdown в LaTeX следует его [типу документа](/docs/writing/markdown/#document-types). Слайды и постеры становятся исходником Beamer, отчёт или книга начинает главы с заголовков `#`, а письмо становится письмом KOMA-Script.
- Экспорт из Typst в LaTeX копирует изображения документа в папку `<name>-media` рядом с файлом `.tex`. Изображения SVG, GIF и WebP там становятся PDF, потому что LaTeX не умеет их читать.

Экспорт ищет рисунки в папке главного документа, в корне проекта и в папках `\graphicspath`, и находит рисунок, названный без расширения. Рисунки EPS преобразовать нельзя, поэтому они попадают в файл без изменений, с предупреждением. В экспорте документа Markdown в Word, HTML, EPUB или PowerPoint блок Mermaid показывает сохранённый для него рисунок.

### Предупреждения после экспорта

Pandoc пропускает то, что формат вместить не может. Когда это случается при экспорте из проекта LaTeX или Markdown либо при экспорте из Typst, где Pandoc читает исходный код, сообщение о завершении говорит, что файл сохранён с предупреждениями, и сколько их, вместо остальных заметок, например напоминания скопировать изображения. Выберите **Показать предупреждения**, чтобы открыть **Предупреждения экспорта**, где перечислено, что пропало. **Показать в папке** в этом диалоге открывает папку с сохранённым файлом.

В списке могут быть:

- блок, который экспорт пропустил, с файлом и строкой, когда они известны, например `tikzpicture`, `\includepdf` или команда наложения Beamer вроде `\only` или `\uncover`
- рисунок, который экспорт не смог найти или преобразовать
- ключ цитирования, которого нет в библиографии
- формула, оставшаяся кодом TeX
- ссылки, у которых ещё нет номера, что исправляет компиляция

Повторяющееся предупреждение показывается один раз, а список обрывается на 50. Экспорт в PowerPoint при отсутствующем рисунке работает иначе: он останавливается, файл не сохраняет, а в ошибке названо имя рисунка. Экспорты из Typst через HTML сообщают, что Typst не включил, прямо в сообщении о завершении.

## Экспорт презентаций и книг

Проект LaTeX сопоставляет эти форматы со своим классом документа. **Экспорт в PowerPoint (.pptx)** появляется для презентации Beamer, а **Экспорт в EPUB (.epub)** для классов `book`, `report`, `memoir`, `scrbook` и `scrreprt`.

В презентации Beamer каждый кадр начинает новый слайд, `\section` добавляет слайд раздела, а `\subsection` ничего не добавляет. Кадр с несколькими изображениями или с изображением и другим содержимым может занять второй слайд.

В проектах Typst и Markdown меню не проверяет документ для этих экспортов. Проект Markdown всегда предлагает оба варианта, а проект Typst всегда предлагает EPUB. Когда документ Markdown превращается в PowerPoint, каждый заголовок уровня 1 становится слайдом раздела, а каждый заголовок уровня 2 начинает новый слайд. Исключение — документ с `type: slides`: строка `slide-level` в его front matter выбирает уровень заголовка, с которого начинается слайд. Каждый EPUB получает оглавление, а его формулы записываются в MathML.

Используйте эти файлы как редактируемые заготовки. Композиция слайдов и типографика книг редко переходят один в один между форматами, поэтому просмотрите каждый слайд или главу в целевом приложении.

## Экспорт отдельного рисунка

Проект отдельного рисунка после компиляции предлагает **Экспорт в PDF (векторное изображение)** и **Экспорт в PNG**. Выберите PDF, чтобы линии и текст оставались чёткими при любом масштабе. Выберите PNG, если место назначения принимает только растровые изображения.

## Сохраните результат внутри проекта

[Предпросмотр PDF](/docs/pdf-preview/) также предлагает **Сохранить PDF в проект**. Это оставляет копию для подачи или скомпилированный рисунок рядом с исходным кодом. Чтобы эта копия оставалась актуальной, включите [синхронизацию PDF при компиляции](/docs/pdf-preview/#sync-pdf-on-compiles) в том же меню, и Oleafly после каждой успешной компиляции будет обновлять PDF с именем по названию проекта. Более ранний PDF можно сохранить из [контрольной точки](/docs/checkpoints/#save-a-pdf-from-a-checkpoint), не восстанавливая проект. Добавляйте этот файл в [историю Git](/docs/git-history/), только если вы намерены версионировать создаваемый результат.

## Проверьте перед передачей

Запустите [Предпроверку](/docs/preflight/) перед подачей. Если вам нужен PDF с тегами, пройдите процесс доступного экспорта для LaTeX или выберите стандарт PDF/UA в проекте Typst, а затем проверьте результат независимым средством проверки PDF/UA и людской проверкой доступности. Предпроверка проверяет много полезных признаков, но не сертифицирует соответствие.
