Часто задаваемые вопросы и устранение неполадок
Быстрые ответы о начале работы, проектах, компиляции, ассистентах и резервных копиях.
Начало работы
Заголовок раздела «Начало работы»Нужен ли мне аккаунт?
Заголовок раздела «Нужен ли мне аккаунт?»Нет. Скачайте Oleafly, откройте его и пишите. Необязательные службы, такие как облачный провайдер ИИ, GitHub или Dropbox, используют собственные аккаунты.
Поддерживает ли Oleafly LaTeX, Typst и Markdown?
Заголовок раздела «Поддерживает ли Oleafly LaTeX, Typst и Markdown?»Да. Выберите движок при создании проекта. У каждого движка свои возможности редактирования и экспорта. Краткое руководство проведёт вас через создание вашего первого PDF.
Могу ли я перенести существующую статью или резюме?
Заголовок раздела «Могу ли я перенести существующую статью или резюме?»Да. Импортируйте исходный код проекта, ZIP-архив или репозиторий Git. В Oleafly есть также пути конвертации для DOCX и текстовых PDF. Прочитайте раздел Перенос существующего проекта, чтобы выбрать подходящий путь.
Могу ли я работать автономно?
Заголовок раздела «Могу ли я работать автономно?»Вы можете писать, упорядочивать файлы, использовать локальную проверку текста и запускать скачанную локальную модель ИИ без подключения к облаку. Tectonic может компилировать с кэшированными пакетами. Новые пакеты, удалённые библиографии, облачные модели, GitHub и загрузки требуют подключения. Подготовьте проект с успешной компиляцией, прежде чем начать работать с ним автономно.
Где находятся мои файлы?
Заголовок раздела «Где находятся мои файлы?»Ваши проекты — это обычные папки в вашей локальной библиотеке. Вы можете копировать их, создавать резервные копии или открывать их в другом инструменте. В разделе Где хранятся ваши данные описаны файлы проекта, настройки приложения и контрольные точки.
Подходит ли Oleafly для диссертации или резюме?
Заголовок раздела «Подходит ли Oleafly для диссертации или резюме?»Да. Начните с процесса работы над диссертацией или процесса работы над резюме. В обоих используются те же инструменты редактирования, предпросмотра, библиографии и экспорта, что и для научной статьи.
Установка
Заголовок раздела «Установка»Операционная система блокирует установщик
Заголовок раздела «Операционная система блокирует установщик»Проверьте, что файл взят из официальных релизов (откроется в новой вкладке) и соответствует вашей платформе. Следуйте руководству по установке для шагов первого запуска на вашей платформе.
Какой пакет Linux мне использовать?
Заголовок раздела «Какой пакет Linux мне использовать?»Выберите архитектуру, соответствующую вашему компьютеру, и пакет AppImage, пакет Debian или RPM. Требования к системе см. в разделе Установка в Linux.
Компиляция
Заголовок раздела «Компиляция»Первая компиляция идёт медленно
Заголовок раздела «Первая компиляция идёт медленно»Tectonic может потребовать скачать пакеты, используемые этим документом, а первая компиляция на компьютере к тому же скачивает набор часто используемых. Они кэшируются для последующих сборок. Пока пакеты ещё скачиваются, компиляция может выйти за обычный пятиминутный лимит. Откройте Журнал, чтобы видеть, что происходит.
Отсутствует пакет
Заголовок раздела «Отсутствует пакет»Если включён офлайн-режим, выберите Выключить и скомпилировать в сообщении или отключите его на одну компиляцию, чтобы получить пакет. В системном наборе инструментов TeX используйте Найти и установить в ошибке. TeX Live из Debian, Ubuntu или Fedora получает пакеты через apt или dnf. См. Движки и пакеты LaTeX.
Я выбрал pdfLaTeX, и Oleafly просит дистрибутив TeX
Заголовок раздела «Я выбрал pdfLaTeX, и Oleafly просит дистрибутив TeX»pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX и pLaTeX работают на дистрибутиве TeX, установленном на вашем компьютере. Когда его нет, выбор любого из них перед компиляцией открывает диалог. Выберите Скачать и использовать TinyTeX, чтобы установить дистрибутив, или Вернуться к Tectonic, чтобы вернуться к встроенному движку. После неудачной компиляции предпросмотр предлагает тот же выбор в виде Скачать и использовать TinyTeX и Использовать Tectonic. См. Когда TeX не установлен.
MiKTeX пишет, что latexmk требует Perl
Заголовок раздела «MiKTeX пишет, что latexmk требует Perl»latexmk в MiKTeX работает на Perl, который MiKTeX не включает. Установите Strawberry Perl или TinyTeX из Настройки → Движки → LaTeX: у него свой Perl, и он берёт на себя компиляцию вместо MiKTeX. См. MiKTeX и Perl.
В моём PDF нет текста
Заголовок раздела «В моём PDF нет текста»В шрифте нет глифов для этих символов. Чаще всего это бывает с корейским, китайским и японским текстом, и TeX пропускает символы, не прерывая компиляцию. Oleafly предупреждает вас и перечисляет их в журнале. В LaTeX вставьте настройку, которую даёт предупреждение для вашего письма. В Typst скачайте набор шрифтов, который предлагает уведомление, или добавьте в папку fonts проекта шрифт с нужными символами. В Markdown задайте в заголовке YAML mainfont или CJKmainfont со шрифтом, в котором они есть. См. Символы, отсутствующие в PDF и Символы, которые выглядят как квадратики.
Oleafly остановил мою компиляцию, потому что она шла слишком долго
Заголовок раздела «Oleafly остановил мою компиляцию, потому что она шла слишком долго»Компиляция может идти 5 минут. Пока пакеты ещё скачиваются, лимит растягивается до 30 минут. Markdown в PDF получает 15 минут, а Quarto и Calepin — час. Скомпилируйте снова: загрузка продолжится с того места, где остановилась. Для длинных черновиков на Tectonic установите Режим компиляции в Быстрый в меню компиляции.
Могут ли новые проекты использовать мою собственную установку TeX?
Заголовок раздела «Могут ли новые проекты использовать мою собственную установку TeX?»Да. Откройте Настройки → Движки → LaTeX и установите Движок компиляции по умолчанию на latexmk (системный TeX). Новые, импортированные и сконвертированные проекты LaTeX затем будут начинаться с него. См. Задать значение по умолчанию для новых проектов.
Мой документ использует minted или PythonTeX
Заголовок раздела «Мой документ использует minted или PythonTeX»Эти пакеты запускают другие программы во время компиляции документа, и Oleafly блокирует это по умолчанию. Им требуется системный LaTeX. Если вы доверяете каждому файлу в проекте, выберите Разрешить внешние команды на панели над редактором. См. Разрешение внешних команд.
Компиляция завершилась с предупреждениями
Заголовок раздела «Компиляция завершилась с предупреждениями»Откройте Журнал и сначала проверьте неопределённые цитирования и ссылки. Предпроверка помогает найти затронутые места в исходном коде перед экспортом.
Я не понимаю ошибку сборки
Заголовок раздела «Я не понимаю ошибку сборки»Попросите ассистента прочитать журнал, исправить ошибку и скомпилировать снова. Используйте режим Спрашивать разрешение, если хотите просматривать предлагаемые действия по ходу работы. Вы также можете опубликовать журнал в форуме помощи сообщества Discord.
Почему отсутствует формат экспорта?
Заголовок раздела «Почему отсутствует формат экспорта?»Доступные форматы зависят от движка и типа документа. Проверьте таблицу экспорта.
ИИ-ассистенты
Заголовок раздела «ИИ-ассистенты»Какого ассистента можно использовать?
Заголовок раздела «Какого ассистента можно использовать?»Подключите провайдера моделей, используйте локальную модель или выберите CLI-агент. В разделе Настройка ИИ описан каждый путь.
Нужен ли ИИ для работы в редакторе?
Заголовок раздела «Нужен ли ИИ для работы в редакторе?»Нет. Написание, компиляция, цитирования, предпросмотры, диаграммы, история проекта и экспорт доступны без ассистента.
Что может делать ассистент?
Заголовок раздела «Что может делать ассистент?»Он может работать с файлами проекта, искать источники, изучать PDF, создавать рисунки, запускать инструменты и помогать исправлять сборку. Выберите тариф и политику подтверждения, которые подходят для работы. См. Чат и инструменты.
Что означает «Проверена» рядом с моделью?
Заголовок раздела «Что означает «Проверена» рядом с моделью?»Модель прошла проверку вызова инструментов. Это помогает выбрать модель для действий в проекте; качество её текстов или исследований при этом не оценивается. См. Настройка ИИ.
Почему расход показывается как «Неизвестно»?
Заголовок раздела «Почему расход показывается как «Неизвестно»?»Некоторые провайдеры и CLI-агенты не сообщают данные о расходе. «Неизвестно» означает, что значение недоступно. Прочитайте раздел Расход и бюджеты.
Могу ли я подключить внешнего ассистента?
Заголовок раздела «Могу ли я подключить внешнего ассистента?»Да. Используйте встроенное подключение CLI-агента, включите локальный MCP-сервер Oleafly или подключите своего агента к команде oleafly, которая работает и при закрытом приложении.
История и совместная работа
Заголовок раздела «История и совместная работа»Как восстановить более раннюю версию?
Заголовок раздела «Как восстановить более раннюю версию?»Откройте Контрольные точки, чтобы сравнить исходный код успешных сборок и восстановить версию. Используйте Систему контроля версий для коммитов Git, которыми вы управляете сами.
Могу ли я работать с соавтором?
Заголовок раздела «Могу ли я работать с соавтором?»Да. Благодаря совместной работе в реальном времени вы и ваши соавторы редактируете один проект одновременно через сервер совместной работы, которым управляет ваша группа. У каждого из вас проект хранится как файлы на собственном компьютере. Вы также можете обмениваться архивами исходного кода или использовать синхронизацию через GitHub для обмена коммитами.
Могу ли я использовать свои проекты на двух компьютерах?
Заголовок раздела «Могу ли я использовать свои проекты на двух компьютерах?»Да. Облачная синхронизация хранит проекты вашей библиотеки и настройки в вашем собственном Dropbox, и каждый подключённый компьютер может их скачать. Чтобы подключить её, откройте Настройки → Хранение данных → Облачная синхронизация. Перенести проект между компьютерами можно также с помощью синхронизации через GitHub.
Создаёт ли экспорт исходного кода полную резервную копию?
Заголовок раздела «Создаёт ли экспорт исходного кода полную резервную копию?»Он создаёт резервную копию исходного кода проекта. Автоматические контрольные точки, настройки приложения и учётные данные хранятся отдельно. Следуйте руководству по резервному копированию, чтобы включить всё необходимое.
Сообщить о проблеме
Заголовок раздела «Сообщить о проблеме»Откройте Настройки → Справка и о программе → Копировать сведения и приложите эти данные к краткому описанию, шагам для воспроизведения проблемы и соответствующему журналу. Сообщите о ней в Issues (откроется в новой вкладке); для вопросов и помощи с процессом работы используйте сообщество Discord.