# Verilerinizden yola çıkarak yazın

Çözümleme girdilerini, betikleri, tabloları ve metin sonuçlarını bağlı tutun.

Bir sonuç paragrafı, arkasındaki hesap yakındayken daha kolay güvenilir bulunur. Çözümleme yordamını ve çıktılarını metnin yanında tutmak için bir araştırma projesi kullanın.

## Projeyi kurun

**Yinelenebilir çözümleme** çalışma başlangıcını seçin. Araştırma araçlarının özgün ölçümleri makaleye taşımadan okuyabilmesi için [veri klasörünü bağlayın](/docs/linked-folders/).

Bir çözümleme istemeden önce sütunların ne anlama geldiğini, birimlerini ve varsa dışlamaları kaydedin.

## Asistana sınırlı bir iş verin

`/oleafly-data-analysis` komutunu ya da bir **Çözümleme** [araştırma görevi](/docs/research-tasks/) kullanın:

> Bağlı Veri klasöründeki ölçümleri oku. İki koşulu analysis-plan.md içindeki yöntemle karşılaştır. Betiği, birimli bir tabloyu ve dışlamaları açıklayan bir notu kaydet. Girdi verisini değiştirmeden bırak.

Çözümleme betikleri ilgili yerel çalışma zamanını ve kitaplıkları gerektirir. Asistandan bu gereksinimleri denetlemesini ve işin nasıl yeniden çalıştırılacağını kaydetmesini isteyin.

## Çıktıları inceleyin

Betiği okuyun ve seçilen verinin de yöntemin de soruyla örtüştüğünü doğrulayın. Bir sonucu kabul etmeden önce birimleri, örnek sayılarını, eksik değerleri ve belirsizliği denetleyin.

Tabloları ve şekilleri üretim betiklerinin yanında tutun. [figure-prep becerisi](/docs/skills/), denetlenmiş bir sonucu metin için bir şekle dönüştürmeye yardımcı olabilir.

Bir [CLI ajanıyla](/docs/cli-agents/#research-starting-points) **Yinelenebilirlik denetimi** başlangıç noktası, her sonucun yeniden üretilebilmesi için neyin eksik olduğunu sorar: kod, veri, yazılım sürümleri, rastgele tohumlar ve derleme yönergeleri. **Şekil denetimi** başlıkları, etiketleri, eksen birimlerini ve okunabilirliği denetler. İkisi de ajandan `research/` içinde bir rapor yazmasını ve metne dokunmamasını ister.

## Kodu belgenin içinde çalıştırın

PDF'teki sayıların doğrudan koddan gelmesi için raporu [Quarto ya da Calepin](/docs/engines/#quarto) ile yazın. Quarto, bir `.qmd` veya `.Rmd` dosyasındaki R, Python ya da Julia parçalarını çalıştırır; Calepin ise bir Typst belgesindeki parçaları çalıştırır.

- Kod, **Bu projede kod çalıştırmaya izin ver**'i seçene dek her projede kapalı kalır. Kod kapalıyken Quarto her parçanın kodunu çıktısı olmadan gösterir, Calepin ise kodun son çalıştığı zaman sakladığı sonuçları gösterir. Filtreler, kısa kodlar (shortcode), bir `_extensions` klasörü, oluşturma betikleri ve satır içi R kodu o zaman bile kod çalıştırır; bu yüzden bunlardan birini kullanan bir proje, siz koda izin verene kadar derlenmez.
- Kod kapalıyken ve bilgisayarda R yokken, ön bilgisi olan bir `.qmd` dosyası, ön bilgisinde bir `knitr:` anahtarı olmadıkça yine önizlenir. R kodu içeren diğer her belge, `.Rmd` dosyaları dahil, kod kapalıyken bile R gerektirir. R'ı [cloud.r-project.org](https://cloud.r-project.org/) adresinden kurun, sonra yeniden derleyin.
- Oleafly, Quarto 1.5 veya daha yenisini gerektirir. Sizinki daha eskiyse Oleafly kendi kopyasını kullanır ya da **Ayarlar → Motorlar → Quarto** altından bir tane indirmenizi ister. İndirilmiş kopya yoksa bir `_quarto.yml` projesindeki belge bunun yerine daha eski Quarto'nuzla derlenir.
- Projede Jupyter kurulu bir `.venv`, `venv` veya `env` klasörü varsa Python kodu projenin kendi ortamında çalışır; Calepin de projede bir `.venv` klasörü varsa onu kullanır. Aksi hâlde kod, **Ayarlar → Motorlar → Quarto** içinde **Diller** altında listelenen Python'da çalışır.
- Bir `pdf` ya da `beamer` belgesi LaTeX gerektirir. Hiç TeX kurulu değilse Oleafly teklif ettiğinde TinyTeX'i kurun, belgeyi `format: typst` olarak değiştirin ya da koda izin verildikten sonra yerleşik motoru kullanmak için ön bilgiye `pdf-engine: tectonic` ekleyin.
- Quarto, belgenin adıyla yanına bir çalışma dosyası yazar: PDF için `report.tex`, Typst için `report.typ`. Sizin bir dosyanız zaten bu ada sahipse derleme onu değiştirmek yerine durur ve adını verir. Dosyanızı yeniden adlandırın ya da taşıyın, sonra yeniden derleyin.
- PDF'ten Korece, Çince ya da Japonca karakterler eksikse uyarı bir yazı tipinin adını verir ve ön bilgiye eklenecek iki satır sunar: o yazı tipiyle `CJKmainfont:` ve `pdf-engine: tectonic`. İkisini de ekleyin, çünkü yazı tipi yerleşik motorla gelir. `pdf-engine: tectonic` yalnızca proje için koda izin verildikten sonra çalışır.
- Bir not defteri bir saate kadar çalışabilir. Bunu aşarsa Oleafly onu durdurur ve günlük ulaştığı hücreyi gösterir. O hücreyi kısaltın ya da önbelleğe alın, sonra yeniden derleyin.

## Sonucu yazın

Asistandan yalnızca incelenmiş çıktıları kullanarak bir bulgu paragrafı taslağı yazmasını isteyin. Her sayıyı tabloya karşı denetleyin ve yöntemi yorumdan ayrı tutun.

Belgeyi derleyin ve tam tabloyu ya da şekli PDF içinde, etiketleri ve şekil başlığı dahil inceleyin.
