# Перенос существующей работы в Oleafly

Импортируйте архив проекта, преобразуйте документ, перенесите исходный пакет arXiv, скопируйте репозиторий GitHub или превратите проект LaTeX в проект Typst.

Выберите **Новый проект → Импорт проекта** или воспользуйтесь кнопкой **Импорт** в библиотеке. Oleafly создаёт новый локальный проект и оставляет исходный файл или репозиторий без изменений. Если при импорте не переносится собственный репозиторий Git, импортированные файлы становятся [первым коммитом Git](/docs/new-project/#the-first-git-commit) проекта, **Создать проект**.

![Выберите «Импорт проекта» в диалоге создания проекта, чтобы начать с существующей работы.](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

## Выберите путь под ваш исходный материал

| Что у вас есть | Путь импорта | Проект, который можно создать |
| --- | --- | --- |
| Полная папка проекта | **Существующий проект** (`.zip`) | Архивированный исходный код, иллюстрации, библиография и локальные файлы стилей |
| Документ Word | **Документ Word** (`.docx`) | LaTeX, Markdown или Typst |
| Документ Markdown | **Документ Markdown** (`.md`, `.markdown`) | LaTeX или Typst |
| Документ HTML | **Страница HTML** (`.html`, `.htm`) | LaTeX, Markdown или Typst |
| Документ Typst | **Документ Typst** (`.typ`) | LaTeX или Markdown |
| Статья с arXiv | **Статья с arXiv** по идентификатору или URL | Исходный пакет LaTeX этой статьи |
| Репозиторий GitHub | **GitHub** | Локальный проект, связанный с репозиторием |
| PDF без редактируемого исходника | **Инструменты Oleafly → Преобразование PDF** | Восстановленные LaTeX, Markdown или Typst, в зависимости от выбранного инструмента |
| Проект LaTeX, уже открытый в Oleafly | **Преобразовать в проект Typst** в палитре команд | Новый проект Typst, при этом проект LaTeX остаётся как был |

Выбирайте тот же формат написания, только когда Oleafly его предлагает. Чтобы сохранить файл Markdown или Typst в исходном формате, создайте пустой проект для этого формата и добавьте файл исходника через [дерево файлов](/docs/files/#adding-existing-files).

## Импорт полного архива проекта

Используйте ZIP, когда у вас уже есть работающая структура исходников.

1. Положите основной документ, иллюстрации, библиографию и локальные файлы классов или стилей в одну папку. Сохраните относительные пути, которые использует исходник.
2. Сожмите папку в файл `.zip`.
3. Выберите **Импорт → Существующий проект** и укажите ZIP.
4. Проверьте отмеченный звёздочкой основной документ в импортированном дереве файлов.
5. Скомпилируйте. Если проекту нужна другая связка инструментов LaTeX, выберите её в меню компилятора.

Например, держите `main.tex`, `references.bib`, `sections/method.tex` и `figures/plot.pdf` вместе. ZIP с исходниками сохраняет эти связи. PDF не содержит той же редактируемой структуры проекта.

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

## Какой компилятор LaTeX использует импорт

Импортированный или преобразованный проект LaTeX начинает с движка компиляции по умолчанию из **Настройки → Движки → LaTeX** — это Tectonic, если вы его не меняли. Если по умолчанию выбран `latexmk`, а проект называет pdfLaTeX, XeLaTeX или LuaLaTeX, этот компилятор сохраняется. Если при импорте обнаруживаются возможности, с которыми Tectonic не справляется, открывается диалог выбора движка, чтобы вы могли выбрать другой. См. [Значение по умолчанию для новых проектов](/docs/engines/#set-a-default-for-new-projects) и [Когда Tectonic не хватает](/docs/latex-engines/#when-tectonic-isnt-enough).

## Преобразование Word, Markdown, HTML или Typst

1. Выберите соответствующий тип документа в разделе **Импорт**.
2. Выберите файл.
3. Если Oleafly предлагает больше одного целевого формата, выберите тот, в котором будете редактировать дальше. LaTeX помечен как рекомендуемый путь.
4. Завершите настройку Pandoc, если появится запрос. Oleafly может использовать совместимую установленную версию или скачать собственную управляемую.
5. Откройте новый проект, скомпилируйте его и сравните с оригиналом.

Преобразование выполняется локально через Pandoc. Импорт из Word или HTML также извлекает встроенные медиафайлы в проект, чтобы преобразованный исходник мог на них ссылаться. Документ Markdown, импортированный в проект LaTeX, сохраняет свои цитаты: `[@key]` превращается в `\citep` или `\citet`, а файл библиографии переносится вместе с ним, поэтому панель «Источники» содержит ваши источники с самого начала.

Выберите целевой формат с учётом предстоящей работы:

- **LaTeX** подходит для журнальных шаблонов, детальной вёрстки и рабочих процессов с тегированными PDF.
- **Markdown** подходит для более лёгкого формата исходника и широкого преобразования документов.
- **Typst** подходит для быстрой компиляции и шаблонов, созданных специально для Typst.

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

## Импорт исходного пакета arXiv

Выберите **Статья с arXiv**, затем вставьте идентификатор вида `2401.01234` или URL вида `arxiv.org/abs/...`. Oleafly скачивает отправленный авторами исходный пакет и открывает его как проект LaTeX.

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

Всегда проверяйте лицензию и условия авторов, прежде чем повторно использовать исходники или иллюстрации.

## Импорт из GitHub

Выберите **GitHub** в диалоге импорта. При необходимости подключите аккаунт через **Настройки → Интеграции → GitHub**, затем выберите репозиторий, к которому у вас есть доступ.

Oleafly создаёт локальную копию в библиотеке. Проверьте её основной документ и выполните компиляцию перед редактированием. В разделе [Синхронизация с GitHub](/docs/github-sync/) описаны получение, фиксация и публикация изменений после импорта.

## Преобразование проекта LaTeX в Typst

Oleafly может создать копию в Typst из уже имеющегося у вас проекта LaTeX. Сам проект LaTeX при этом не меняется.

1. Откройте проект LaTeX.
2. Откройте палитру команд ⌘K (Ctrl+K) и выполните **Преобразовать в проект Typst**.
3. Проверьте **Имя нового проекта**. По умолчанию это имя проекта с добавленным `(Typst)`.
4. Выберите **Преобразовать**. Oleafly преобразует проект с помощью Pandoc, создаёт проект Typst и один раз компилирует его для проверки.
5. Прочитайте отчёт, затем выберите **Открыть проект Typst**.

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

## Реконструкция PDF

Включите **Инструменты LaTeX** в **Настройки → Эксперименты**, затем выберите инструмент под нужный результат:

- [Из PDF в LaTeX](/docs/tools/pdf-to-latex/) — для проекта LaTeX или архива исходников
- [Из PDF в Markdown](/docs/tools/pdf-to-markdown/) — для редактируемого Markdown
- [Из PDF в Typst](/docs/tools/pdf-to-typst/) — для редактируемого Typst

Локальный конвейер PDF читает текстовый слой, восстанавливает порядок чтения и извлекает иллюстрации. В инструменте **Из PDF в LaTeX** переключитесь на режим отсканированных документов, когда PDF состоит из изображений страниц. Этот путь использует модель для инструментов, то есть локальную модель Ollama, если вы не выберете другую, и поддерживает документы до 50 страниц.

Сравнивайте результат с PDF страница за страницей. Колонки, формулы, таблицы, сноски и порядок чтения — проблемы реконструкции, поэтому результат преобразования PDF не следует считать исходником.

## Добавление источников без импорта рукописи

Импортируйте BibTeX, RIS, EndNote XML или Zotero RDF через [Источники и цитирование](/docs/citations/#import-a-whole-reference-library). Подключите папку со статьями или данными как [контекст исследования только для чтения](/docs/linked-folders/), когда она должна остаться вне проекта.