Часті питання та усунення несправностей
Швидкі відповіді про початок роботи, проєкти, компіляцію, асистентів і резервні копії.
Початок роботи
Розділ «Початок роботи»Чи потрібен обліковий запис?
Розділ «Чи потрібен обліковий запис?»Ні. Завантажте 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 задайте mainfont або CJKmainfont у заголовку YAML шрифтом, що їх має. Див. Символи, яких бракує в 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.