# Инструменты Oleafly

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

Статья редко приходит в нужном вам формате. Формула может быть заперта в снимке экрана, соавтор может прислать файл Word, а ссылка может оказаться всего лишь DOI. Инструменты Oleafly превращают такие обрывки в материал, который можно редактировать, проверять и хранить.

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

:::note[Включите набор инструментов]
Инструменты Oleafly пока находятся в бете. Откройте **Настройки → Эксперименты**, включите **Инструменты LaTeX** и вернитесь в Библиотеку. Этот параметр открывает галерею инструментов и её слэш-команды.
:::

## Открыть инструмент

Выберите самый быстрый путь:

1. В Библиотеке откройте **Инструменты Oleafly** и выполните поиск по названию, формату или задаче.
2. Нажмите ⌘⇧F на macOS или Ctrl+Shift+F на Windows и Linux. Введите `/tools`, чтобы открыть галерею, или слэш-команду конкретного инструмента, например `/latex-to-word`.
3. Внутри проекта используйте подходящее действие редактора, если оно доступно. Например, выделение формулы может открыть инструмент **Из LaTeX в изображение**.

На странице каждого инструмента в этом руководстве указана его точная слэш-команда.

### Изменение размера двухпанельного инструмента

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

## Выбирайте кратчайший путь

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

| Что есть | Что нужно | Открыть |
| --- | --- | --- |
| Снимок экрана или фотография | Редактируемые формулы, заметки или таблица | [Из изображения в LaTeX](/docs/tools/image-to-latex/) или [Из изображения в Typst](/docs/tools/image-to-typst/) |
| PDF | Редактируемый исходник | [Из PDF в LaTeX](/docs/tools/pdf-to-latex/), [Из PDF в Markdown](/docs/tools/pdf-to-markdown/) или [Из PDF в Typst](/docs/tools/pdf-to-typst/) |
| Документ Word | Редактируемый исходник вместе с изображениями | [Из Word в LaTeX](/docs/tools/word-to-latex/) или [Из Word в Typst](/docs/tools/word-to-typst/) |
| Исходник LaTeX | Word, HTML, Markdown, Typst или изображение формулы | [Из LaTeX в Word](/docs/tools/latex-to-word/), [HTML](/docs/tools/latex-to-html/), [Markdown](/docs/tools/latex-to-markdown/), [Typst](/docs/tools/latex-to-typst/) или [изображение](/docs/tools/latex-to-image/) |
| Исходник Typst | Word, HTML, Markdown или LaTeX | [Из Typst в Word](/docs/tools/typst-to-word/), [HTML](/docs/tools/typst-to-html/), [Markdown](/docs/tools/typst-to-markdown/) или [LaTeX](/docs/tools/typst-to-latex/) |
| Markdown | LaTeX или Typst | [Из Markdown в LaTeX](/docs/tools/markdown-to-latex/) или [Из Markdown в Typst](/docs/tools/markdown-to-typst/) |
| Разметка HTML | LaTeX или Typst | [Из HTML в LaTeX](/docs/tools/html-to-latex/) или [Из HTML в Typst](/docs/tools/html-to-typst/) |
| Файл таблицы | Экранированная таблица LaTeX или Typst | [Из Excel в LaTeX](/docs/tools/excel-to-latex/) или [Из Excel в Typst](/docs/tools/excel-to-typst/) |
| Скопированные строки CSV или TSV | Экранированная таблица Typst | [Из CSV в Typst](/docs/tools/csv-to-typst/) |
| Блок-схема Mermaid | Редактируемый код TikZ или fletcher | [Из Mermaid в LaTeX](/docs/tools/mermaid-to-latex/) или [Из Mermaid в Typst](/docs/tools/mermaid-to-typst/) |
| Формула в виде текста или изображения | Математическая запись LaTeX или Typst | [Из формулы в LaTeX](/docs/tools/equation-to-latex/) или [Из формулы в Typst](/docs/tools/equation-to-typst/) |
| Статья с arXiv | Её исходник на LaTeX или в переводе на Typst | [Из arXiv в LaTeX](/docs/tools/arxiv-to-latex/) или [Из arXiv в Typst](/docs/tools/arxiv-to-typst/) |

[Визуальный редактор Typst](/docs/tools/visual-typst-editor/), [Редактор Typst](/docs/tools/typst-editor/) и [Из таблицы в LaTeX](/docs/tools/table-to-latex/) начинают новую работу без входного файла. Если нужно нарисовать схему, а не преобразовать готовую, откройте [компоновщик диаграмм](/docs/figures-diagrams/).

### Собрать ссылки

Используйте идентификатор, если он у вас есть: [DOI](/docs/tools/doi-to-bibtex/), [ISBN](/docs/tools/isbn-to-bibtex/), [ID PubMed](/docs/tools/pubmed-to-bibtex/), [ID arXiv](/docs/tools/arxiv-citation-generator/) или [веб-адрес](/docs/tools/url-to-bibtex/). Используйте [Генератор цитат](/docs/tools/citation-generator/) для одного источника, [Генератор библиографии](/docs/tools/bibliography-generator/) для списка и [Генераторы цитат по стилям](/docs/tools/citation-styles/), когда нужно сравнить правила оформления.

### Искать, проверять и писать

- [Поиск цитат](/docs/tools/find-citations/) выполняет поиск по научным индексам и может просканировать черновик в поисках утверждений, которым нужны подтверждения.
- [Проверка BibTeX](/docs/tools/bibtex-validator/) находит неполные записи и дублирующиеся ключи до того, как они сломают библиографию.
- [Поиск лабораторий](/docs/tools/lab-search/) и [Дедлайны конференций](/docs/tools/conference-deadlines/) помогают изучать места для работы и конференции, за которыми стоит следить.
- [Статистические калькуляторы](/docs/tools/statistics-calculators/) вычисляют распространённые p-значения, размеры выборки и доверительные интервалы на вашем устройстве.
- [Генераторы текста](/docs/tools/writing-generators/) готовят обоснованный запрос из выбранного вами документа или фрагмента.
- [Справочник символов](/docs/tools/symbol-reference/) находит команду LaTeX и вставляет её в позицию курсора.

## Что где выполняется

| Вид работы | Что происходит |
| --- | --- |
| Преобразование документов, таблиц и диаграмм | Выполняется локально встроенными конвертерами Oleafly. Маршруты на основе Pandoc не загружают исходник в сеть. |
| Изображения, отсканированные PDF и формулы, описанные словами | Используют модель для инструментов: по умолчанию локальную модель Ollama, модель другого настроенного вами провайдера или Mathpix для изображений и PDF. Облачный выбор отправляет файл в этот сервис. Для изображений и сканов нужна модель с поддержкой зрения. |
| Поиск идентификаторов, статей и организаций | Обращается к соответствующему публичному каталогу и требует соединения с сетью. Сюда входит и поиск ID arXiv в инструментах «Из arXiv в LaTeX» и «Из arXiv в Typst». |
| Генераторы текста | Отправляют проверенный запрос провайдеру ассистента, который вы настроили. |
| Ручное редактирование ссылок, оформление цитат, проверка и статистика | Остаются на вашем устройстве. |

Метки инструментов сообщают, когда требуется соединение или модель. Модель для инструментов выбирается в **Настройки → ИИ-ассистент → Инструменты**. [Настройка Ollama](/docs/ollama/) рассказывает о локальных моделях, а [провайдеры моделей](/docs/ai-setup/) — о подключении ассистента.

## Результат преобразования — первый черновик

Oleafly сохраняет полезную структуру, но у форматов разный «словарь». Стиль Word — это не макрос LaTeX, PDF хранит позиции на странице, а не замысел автора, а у функции Typst может не быть эквивалента в LaTeX.

После любого преобразования:

1. Прочитайте сгенерированный исходник, а не относитесь к нему как к готовой рукописи.
2. Скомпилируйте результат или откройте его предпросмотр.
3. Проверьте формулы, ссылки, таблицы, рисунки и нестандартное форматирование.
4. Храните исходный файл, пока преобразованная версия не пройдёт эту проверку.

:::caution[Практические ограничения]
Общие преобразования файлов принимают файлы размером до 128 МБ. Распознавание изображений принимает файлы PNG, JPEG или WebP размером до 20 МБ. Распознавание отсканированных PDF ограничено 50 страницами. Импорт таблиц использует первый лист и принимает до 10 000 строк, 100 столбцов и 2 МБ текста ячеек. В отдельных руководствах описаны ограничения, важные для каждого маршрута.
:::

О маршрутах, доступных в меню **Импорт** и **Экспорт** проекта, читайте в полном [руководстве по импорту](/docs/import-project/) и [руководстве по экспорту](/docs/export/).