# Експорт і перетворення проєкту

Збережіть останній 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, що читає код, повідомлення про завершення каже, що файл збережено з попередженнями, і скільки їх, замість інших своїх приміток, як-от нагадування скопіювати зображення. Виберіть **Показати попередження**, щоб відкрити **Попередження експорту**, де перелічено, що пропало. **Показати в папці** у цьому діалозі відкриває теку зі збереженим файлом.

Список може називати:

- блок, який експорт пропустив, із файлом і рядком, коли вони відомі, як-от `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 і людською перевіркою доступності. Передперевірка перевіряє багато корисних сигналів, але не сертифікує відповідність.
