# Из arXiv в Typst

Преобразуйте исходники LaTeX статьи arXiv в Typst с проверочной компиляцией и списком того, что не преобразовалось.

Из arXiv в Typst начинается с исходников, отправленных авторами, а не с PDF. Oleafly скачивает или распаковывает e-print, преобразует его главный файл LaTeX в Typst и один раз компилирует результат, чтобы вы видели, что ещё требует правки.

## Когда использовать

- нужна структура статьи arXiv в Typst;
- вы автор и переносите собственную работу в Typst;
- лицензия статьи разрешает планируемое повторное использование.

Чтобы оставить статью в LaTeX, используйте [Из arXiv в LaTeX](/docs/tools/arxiv-to-latex/). Статья без архива исходников не пройдёт через этот путь. [Из PDF в Typst](/docs/tools/pdf-to-typst/) вместо этого восстанавливает исходники из PDF.

## Преобразование статьи

1. Откройте **Из arXiv в Typst** или выполните команду `/arxiv-to-typst`.
2. В поле **ID arXiv** введите идентификатор, например `1706.03762`. Для работы без сети переключитесь на **Сохранённый архив** и выберите архив исходников `.tar.gz`, `.tgz` или `.gz`.
3. Нажмите **Преобразовать**.
4. Прочитайте примечание под результатом. В нём назван главный файл LaTeX, сказано, скомпилировал ли Typst результат, и подсчитаны элементы, которые не преобразовались. Список под примечанием показывает каждую ошибку Typst с номером строки и каждый непреобразованный элемент.
5. Нажмите **Сохранить ZIP**, чтобы сохранить `main.typ` вместе с остальными файлами статьи, или **Создать проект**, чтобы открыть его как проект Typst.

## Что делает преобразование

Oleafly находит главный файл и вносит в него текст файлов, подключаемых через `\input`, `\include` или `\subfile`. Pandoc преобразует этот LaTeX в Typst с нумерованными разделами. Рисунки, файлы библиографии и другие файлы архива не из TeX остаются в своих папках рядом с `main.typ`, поэтому преобразованный файл по-прежнему находит свои изображения. Затем Typst компилирует преобразованный файл как проверку.

Поиск по ID скачивает исходники с arXiv и требует сетевого соединения. Сохранённый архив преобразуется полностью на вашем устройстве с помощью Pandoc, поставляемого вместе с Oleafly.

## Что исправить вручную

Нестандартные макросы, пакеты без аналога в Typst, рисунки TikZ, сложные таблицы и стили библиографии — обычные остатки. Сначала разберите ошибки Typst из списка, затем сравните скомпилированный PDF со статьей раздел за разделом. Typst не умеет показывать рисунки EPS, поэтому преобразуйте их в PDF, PNG или SVG.

:::caution[Сначала проверьте лицензию]
Статьи на arXiv распространяются под разными лицензиями. Проверьте лицензию статьи и условия авторов, прежде чем повторно использовать её текст или рисунки.
:::

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