# 데이터로 글쓰기

분석 입력, 스크립트, 표, 원고 속 결과가 서로 이어지도록 관리합니다.

결과 단락은 그 뒤에 있는 계산이 가까이 있을 때 더 믿을 수 있습니다. 연구 프로젝트를 만들어 분석 절차와 그 출력을 원고 옆에 두세요.

## 프로젝트 설정하기

**재현 가능한 분석** 시작 구성을 고르세요. [데이터 폴더를 연결](/docs/linked-folders/)하면 연구 도구가 원본 측정값을 논문 안으로 옮기지 않고도 읽을 수 있습니다.

분석을 요청하기 전에 각 열의 의미, 단위, 제외한 항목을 기록하세요.

## 어시스턴트에게 범위가 정해진 일 맡기기

`/oleafly-data-analysis` 명령이나 **분석** [연구 작업](/docs/research-tasks/)을 쓰세요.

> 연결된 Data 폴더의 측정값을 읽으세요. analysis-plan.md에 적힌 방법으로 두 조건을 비교하세요. 스크립트, 단위가 있는 표, 제외한 항목을 설명하는 메모를 저장하세요. 입력 데이터는 바꾸지 마세요.

분석 스크립트를 실행하려면 해당 로컬 런타임과 라이브러리가 필요합니다. 어시스턴트가 이 요건을 확인하게 하고, 작업을 다시 실행하는 방법을 저장하게 하세요.

## 출력 검토하기

스크립트를 읽고 선택한 데이터와 방법이 질문에 맞는지 확인하세요. 결과를 받아들이기 전에 단위, 표본 수, 결측값, 불확실성을 점검하세요.

표와 그림은 그것을 만든 스크립트와 함께 보관하세요. [그림 준비 스킬](/docs/skills/)은 검토를 마친 결과를 원고에 넣을 그림으로 바꾸는 데 도움이 됩니다.

[CLI 에이전트](/docs/cli-agents/#research-starting-points)에서는 **재현성 점검** 시작점이 각 결과를 재현하려면 무엇이 더 필요한지 묻습니다. 코드, 데이터, 소프트웨어 버전, 난수 시드, 빌드 방법이 그 대상입니다. **그림 점검**은 캡션, 레이블, 축 단위, 가독성을 확인합니다. 둘 다 에이전트에게 `research/`에 보고서를 쓰고 원고는 건드리지 말라고 요청합니다.

## 문서 안에서 코드 실행하기

PDF의 수치가 코드에서 곧바로 나오게 하려면 [Quarto나 Calepin](/docs/engines/#quarto)으로 보고서를 쓰세요. Quarto는 `.qmd`나 `.Rmd` 파일의 R, Python, Julia 청크를 실행하고, Calepin은 Typst 문서의 청크를 실행합니다.

- 프로젝트마다 **이 프로젝트에서 코드 허용**을 선택하기 전까지 코드는 꺼져 있습니다. 코드가 꺼져 있으면 Quarto는 각 청크의 코드를 출력 없이 보여 주고, Calepin은 코드가 마지막으로 실행되었을 때 저장한 결과를 보여 줍니다. 필터, 단축 코드, `_extensions` 폴더, 렌더링 스크립트, 인라인 R 코드는 이때도 코드를 실행하므로, 이런 것을 쓰는 프로젝트는 코드를 허용하기 전까지 컴파일되지 않습니다.
- 코드가 꺼져 있고 컴퓨터에 R이 없어도, 머리말에 `knitr:` 키가 없는 `.qmd` 파일은 머리말이 있으면 미리보기가 됩니다. R 코드가 있는 다른 문서는 `.Rmd` 파일을 포함해 코드가 꺼져 있어도 R이 필요합니다. [cloud.r-project.org](https://cloud.r-project.org/)에서 R을 설치한 다음 다시 컴파일하세요.
- Oleafly에는 Quarto 1.5 이상이 필요합니다. 사용 중인 버전이 더 낮으면 Oleafly가 자체 사본을 쓰거나 **설정 → 엔진 → Quarto**에서 내려받으라고 요청합니다. 내려받은 사본이 없으면 `_quarto.yml` 프로젝트의 문서는 대신 낮은 버전의 Quarto로 빌드됩니다.
- 프로젝트에 Jupyter가 설치된 `.venv`, `venv`, `env` 폴더가 있으면 Python 코드는 프로젝트 자체 환경에서 실행되며, Calepin은 프로젝트에 `.venv` 폴더가 있으면 그것을 씁니다. 그렇지 않으면 코드는 **설정 → 엔진 → Quarto**의 **언어**에 나열된 Python에서 실행됩니다.
- `pdf`나 `beamer` 문서에는 LaTeX가 필요합니다. TeX가 설치되어 있지 않다면 Oleafly가 제안할 때 TinyTeX를 설치하거나, 문서를 `format: typst`로 바꾸거나, 코드를 허용한 뒤 내장 엔진을 쓰도록 머리말에 `pdf-engine: tectonic`을 추가하세요.
- Quarto는 문서 옆에 문서 이름으로 된 작업 파일을 씁니다. PDF는 `report.tex`, Typst는 `report.typ`입니다. 이미 내 파일이 그 이름이면 컴파일이 파일을 덮어쓰지 않고 멈춘 뒤 그 이름을 알려 줍니다. 파일 이름을 바꾸거나 옮긴 다음 다시 컴파일하세요.
- PDF에서 한국어, 중국어, 일본어 문자가 빠지면 경고가 글꼴 이름과 머리말에 추가할 두 줄을 알려 줍니다. 그 글꼴을 지정하는 `CJKmainfont:`와 `pdf-engine: tectonic`입니다. 글꼴은 내장 엔진에 들어 있으므로 둘 다 추가하세요. `pdf-engine: tectonic`은 프로젝트에서 코드를 허용한 뒤에만 작동합니다.
- 노트북은 최대 한 시간 동안 실행될 수 있습니다. 그 시간을 넘기면 Oleafly가 멈추고 로그에 도달한 셀이 표시됩니다. 그 셀을 줄이거나 캐시한 다음 다시 컴파일하세요.

## 결과 쓰기

어시스턴트에게 검토를 마친 출력만 써서 결과 구절 초안을 쓰게 하세요. 모든 수치를 표와 대조하고, 방법과 해석을 구분해서 쓰세요.

문서를 컴파일하고 PDF에서 레이블과 캡션을 포함한 표나 그림 전체를 확인하세요.
