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

Выберите Новый проект → Импорт проекта или воспользуйтесь кнопкой Импорт в библиотеке. Oleafly создаёт новый локальный проект и оставляет исходный файл или репозиторий без изменений. Если при импорте не переносится собственный репозиторий Git, импортированные файлы становятся первым коммитом Git проекта, Создать проект.

Выберите «Импорт проекта» в диалоге создания проекта, чтобы начать с существующей работы. Открыть полный снимок экрана

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

Что у вас есть	Путь импорта	Проект, который можно создать
Полная папка проекта	Существующий проект (.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 в исходном формате, создайте пустой проект для этого формата и добавьте файл исходника через дерево файлов.

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

Используйте 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 не справляется, открывается диалог выбора движка, чтобы вы могли выбрать другой. См. Значение по умолчанию для новых проектов и Когда Tectonic не хватает.

Преобразование 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, чтобы просмотреть или сохранить архив исходников, не начиная с диалога импорта, и Из arXiv в Typst, когда статью нужно преобразовать в Typst. Идентификатору arXiv нужно подключение к сети; архиву исходников, уже находящемуся на диске, — нет.

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

Импорт из GitHub

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

Oleafly создаёт локальную копию в библиотеке. Проверьте её основной документ и выполните компиляцию перед редактированием. В разделе Синхронизация с GitHub описаны получение, фиксация и публикация изменений после импорта.

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

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

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

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

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

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

• Из PDF в LaTeX — для проекта LaTeX или архива исходников
• Из PDF в Markdown — для редактируемого Markdown
• Из PDF в Typst — для редактируемого Typst

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

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

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

Импортируйте BibTeX, RIS, EndNote XML или Zotero RDF через Источники и цитирование. Подключите папку со статьями или данными как контекст исследования только для чтения, когда она должна остаться вне проекта.