Пишите на основе своих данных
Держите входные данные анализа, скрипты, таблицы и результаты в рукописи связанными.
Абзац с результатами вызывает больше доверия, когда расчёт, стоящий за ним, находится рядом. Используйте исследовательский проект, чтобы держать процедуру анализа и её результаты рядом с рукописью.
Подготовьте проект
Заголовок раздела «Подготовьте проект»Выберите стартовый шаблон Воспроизводимый анализ. Свяжите папку с данными, чтобы исследовательские инструменты могли читать исходные измерения, не перенося их в статью.
Запишите, что означают столбцы, их единицы измерения и любые исключения, прежде чем запрашивать анализ.
Дайте ассистенту ограниченную задачу
Заголовок раздела «Дайте ассистенту ограниченную задачу»Используйте /oleafly-data-analysis или исследовательскую задачу Анализ из раздела о исследовательских задачах:
Прочитай измерения в связанной папке Data. Сравни два условия методом из analysis-plan.md. Сохрани скрипт, таблицу с единицами измерения и заметку с описанием исключений. Не изменяй входные данные.
Скриптам анализа нужны соответствующие локальная среда выполнения и библиотеки. Пусть ассистент проверит эти требования и сохранит способ повторного запуска работы.
Проверьте результаты
Заголовок раздела «Проверьте результаты»Прочитайте скрипт и убедитесь, что выбранные данные и метод соответствуют вопросу. Проверьте единицы измерения, размеры выборок, пропущенные значения и неопределённость, прежде чем принимать результат.
Храните таблицы и рисунки вместе со скриптами, которые их создают. Навык figure-prep поможет превратить проверенный результат в рисунок для рукописи.
С CLI-агентом стартовая точка Проверка воспроизводимости выясняет, чего каждому результату ещё не хватает для воспроизведения: код, данные, версии программ, начальные значения генераторов случайных чисел и инструкции сборки. Проверка рисунков проверяет подписи, метки, единицы измерения на осях и читаемость. Обе просят агента написать отчёт в research/ и не трогать рукопись.
Запускайте код внутри документа
Заголовок раздела «Запускайте код внутри документа»Чтобы числа в PDF брались прямо из кода, пишите отчёт в Quarto или Calepin. Quarto запускает блоки R, Python или Julia в файле .qmd или .Rmd, а Calepin запускает блоки в документе Typst.
- В каждом проекте код остаётся выключенным, пока вы не выберете Разрешить запуск кода в этом проекте. При выключенном коде Quarto показывает код каждого блока без его вывода, а Calepin показывает результаты, которые сохранил в прошлый раз, когда код запускался. Фильтры, шорткоды, папка
_extensions, скрипты рендеринга и встроенный код R запускают код даже тогда, поэтому проект, использующий что-либо из этого, не скомпилируется, пока вы не разрешите код. - При выключенном коде и без R на компьютере файл
.qmdс front matter всё равно показывается в предпросмотре, если в его front matter нет ключаknitr:. Любой другой документ с кодом R, включая файлы.Rmd, требует R, даже когда код выключен. Установите R с cloud.r-project.org (откроется в новой вкладке) и скомпилируйте снова. - Oleafly нужен Quarto 1.5 или новее. Если ваш старее, Oleafly использует собственную копию или просит скачать её в Настройки → Движки → Quarto. Если копия не скачана, документ в проекте
_quarto.ymlсобирается вашим старым Quarto. - Код на Python запускается в собственном окружении проекта, если в проекте есть папка
.venv,venvилиenvс установленным Jupyter, а Calepin использует папку.venv, если она есть в проекте. Иначе код запускается в Python, указанном в разделе Языки в Настройки → Движки → Quarto. - Документу
pdfилиbeamerнужен LaTeX. Если TeX не установлен, установите TinyTeX, когда Oleafly это предложит, переключите документ наformat: typstили добавьте в front matterpdf-engine: tectonic, чтобы использовать встроенный движок, как только код разрешён. - Quarto пишет рабочий файл с именем документа рядом с ним:
report.texдля PDF илиreport.typдля Typst. Если файл с таким именем у вас уже есть, компиляция останавливается и называет его, а не заменяет. Переименуйте или переместите свой файл и скомпилируйте снова. - Если в PDF нет корейских, китайских или японских символов, предупреждение называет шрифт и даёт две строки для front matter:
CJKmainfont:с этим шрифтом иpdf-engine: tectonic. Добавьте обе, потому что шрифт поставляется со встроенным движком.pdf-engine: tectonicработает, только когда код разрешён для проекта. - Блокнот может работать до часа. После этого Oleafly останавливает его, а журнал показывает ячейку, до которой он дошёл. Сократите или закэшируйте эту ячейку и скомпилируйте снова.
Напишите результат
Заголовок раздела «Напишите результат»Попросите ассистента набросать фрагмент с результатами, используя только проверенные выходные данные. Сверьте каждое число с таблицей и не смешивайте метод с интерпретацией.
Скомпилируйте документ и просмотрите полную таблицу или рисунок в PDF, включая метки и подпись.