# Bir belge motoru seçin

LaTeX, Typst, Markdown, Quarto ve Calepin belgelerinin PDF'e nasıl dönüştüğünü anlayın ve projenizin gerektirdiği derleyiciyi seçin.

Bir motor, kaynağınızı insanların okuyacağı belgeye dönüştürür. Belge dilini proje oluştururken seçersiniz. Bir LaTeX projesinde ayrıca derlemeyi hangi LaTeX derleyicisinin çalıştıracağını seçebilirsiniz.

## Dil seçme

| Çalışmanız | Şununla başlayın | PDF'e nasıl dönüşür |
|---|---|---|
| Bir dergi gönderimi, yerleşik bir tez sınıfı ya da var olan bir `.tex` projesi | LaTeX | Tectonic ya da `latexmk` üzerinden çalışan bir derleyici |
| Kısa ve öz dizgi söz dizimine sahip yeni bir makale, rapor ya da özgeçmiş | Typst | Yerleşik Typst 0.15.1 ya da projenin sabitlediği başka bir Typst sürümü |
| Düz yazı taslağı, notlar ya da birden çok biçime dışa aktarmak istediğiniz bir belge | Markdown | Pandoc kaynağı LaTeX'e dönüştürür; PDF'i Tectonic üretir |
| Sonuçlarını R, Python ya da Julia kodunun ürettiği bir analiz raporu, makale ya da slayt destesi | Quarto | Quarto, `.qmd` ya da `.Rmd` dosyalarını bir PDF'e, web sayfasına ya da slaytlara dönüştürür |
| Kod blokları içeren bir Typst belgesi | Calepin | Calepin kodu çalıştırır, ardından yerleşik Typst PDF'i derler |

Bu seçim, editör araç çubuğunu, kaynak söz dizimini ve kullanılabilir dışa aktarma biçimlerini belirler. LaTeX derleyicisini değiştirmek belgeyi Typst ya da Markdown'a çevirmez. Bir LaTeX projesini Typst'a taşımak için [onu yeni bir Typst projesine dönüştürün](/docs/typst/#convert-a-latex-project-to-typst).

## Tectonic

Basit bir LaTeX kurulumu için **Tectonic** kullanın. Oleafly ile birlikte gelir, bir derlemenin gerektirdiği TeX paketlerini indirir ve sonraki derlemeler için önbelleğe alır. Şablonunuz belirli bir derleyici gerektirmiyorsa buradan başlayın.

Yola çıkmadan önce çevrimiçiyken bir kez derleyin. Önbelleğe alınmış bir proje çevrimdışı derlenebilir; yeni bir paket yine indirme gerektirebilir. **Ayarlar → Genel → Çevrimdışı kip** ayarını etkinleştirin; Tectonic böylece önbelleğini kullanır.

## pdfLaTeX

Bir yayıncı ya da var olan proje **pdfLaTeX** belirttiğinde onu seçin. Geleneksel LaTeX iş akışını izler ve eski belge sınıflarıyla paket birleşimleri için yararlı bir eşleşmedir. Üzerinde `latexmk` kurulu bir TeX dağıtımı gerektirir.

## XeLaTeX

İsteyen bir proje için, özellikle `fontspec`, OpenType yazı tipleri ya da çok dilli metin kullanan bir proje için **XeLaTeX** seçin. Kaynağın adı geçtiği yazı tiplerinin kurulu ya da projenin içinde olduğundan emin olun. Bu da `latexmk` üzerinden çalışır.

## LuaLaTeX

Gerektiren bir şablon, Lua tabanlı dizgi ya da Oleafly'nin etiketli PDF iş akışı için **LuaLaTeX** seçin. Etiketli PDF'ler, yardımcı teknolojinin kullanabileceği belge yapısını taşır. Sonucu incelemek için [ön denetim kontrollerini](/docs/preflight/) çalıştırın; etiketlerin kalitesini tek başına derleyici seçimi belirlemez.

## Typst

Oleafly, Typst 0.15.1 ile birlikte gelir. Bir Typst projesi oluşturun, `.typ` dosyalarında yazın ve **Yeniden derle**'ye tıklayın. Kurulacak bir TeX kurulumu yoktur.

**Ayarlar → Motorlar → Typst** bölümü ayrıca Typst 0.11'den 0.15'e kadar sürümleri kurabilir ve bilgisayarınızda hâlihazırda kurulu bir Typst'ı kullanabilir. Her proje kendi sürümünü sabitler; böylece Oleafly daha yeni bir Typst'a geçtiğinde makale düzenini korur. Typst, bir belge paketleri ilk kez içe aktardığında onları Typst Universe'ten indirir; **Çevrimdışı kip** onu önceden önbelleğe alınmış ya da projede tutulan paketlerle sınırlar.

Typst'ın kendi söz dizimi, paketleri ve yazı tipi yönetimi vardır. [Typst projeleri](/docs/typst/) sürümleri, paketleri, yazı tiplerini ve derleme çeşitlerini ele alır. [Typst yazım kılavuzunda](/docs/writing/typst/) eksiksiz bir başlangıç belgesi ve araç çubuğu denetimleri bulunur.

## Markdown

Markdown, dizgili bir belge hazırlamak için **Pandoc**, PDF'ini derlemek için Tectonic kullanır. Pandoc eksikken kurmak için **Ayarlar → Motorlar → Markdown** bölümünü açın. Ardından Markdown projenizi açın ve derleyin.

Başlıklar, listeler, matematik ve görsel editör için [Markdown yazımı](/docs/writing/markdown/) sayfasını kullanın. [Dışa aktarma kılavuzu](/docs/export/), projenin hangi çıktı biçimlerini sunduğunu açıklar.

## Quarto

Quarto, `.qmd` ve `.Rmd` belgelerini bir PDF'e, web sayfasına ya da slaytlara dönüştürür. Oleafly bilgisayarınızda bir Quarto bulursa onu kullanır. Bulamazsa **Ayarlar → Motorlar → Quarto** bölümünü açın ve **Quarto 1.10.19 sürümünü indir**'i seçin. Düğme indirmenin boyutunu da gösterir. Oleafly indirilen dosyayı açmadan önce denetler ve kopyayı kendi uygulama klasöründe tutar. Quarto kurulmadan derlerseniz önizleme onu hemen kurmayı ya da **Motor ayarlarını aç**'ı önerir.

Belgenin bildirdiği ilk biçim ne elde edeceğinizi belirler:

- `pdf`, `typst` ve `beamer` bir PDF derler. `format: typst` bir TeX kurulumu gerektirmez. `pdf` ve `beamer` LaTeX üzerinden geçer; bu yüzden henüz TeX'iniz yoksa **Ayarlar → Motorlar → LaTeX** bölümünden TinyTeX kurun.
- `html`, `revealjs` ve `dashboard` bir web sayfası derler. Sayfayı görmek için önizlemedeki **Tarayıcıda aç**'ı seçin.

Belge hiçbir biçim bildirmediğinde Oleafly, belgenin klasöründe ve projenin köküne kadar onun üstündeki klasörlerde, `_quarto.yml` ya da `_metadata.yml` içinde bir biçim arar. Hiçbir yerde biçim yoksa Quarto bir web sayfası derler. `pdf_document` gibi bir R Markdown `output:` belirten bir `.Rmd` dosyası, buna karşılık gelen Quarto biçimini alır.

Kod, bilgisayarınızda zaten bulunan R, Python ya da Julia ile çalışır. Oleafly bunları hiçbir zaman kurmaz; aynı ayarlar sekmesindeki **Diller**, bulduklarını gösterir. Python kodu ayrıca o Python'da Jupyter gerektirir. Dışa aktarma, ikisini de Quarto'nun oluşturduğu DOCX ve HTML sunar. **Yeni proje** iletişim kutusunda iki Quarto şablonu vardır: Typst üzerinden derlenen bir PDF olan **Quarto article** ve bir reveal.js destesi olan **Quarto slides**.

## Calepin

Calepin bir Typst belgesindeki kodu çalıştırır ve sonuçları PDF'e ekler. Bir Calepin belgesi, `/.calepin/calepin.typ` dosyasını içe aktaran bir `.typ` dosyasıdır. **Calepin report** şablonuyla bir belge başlatın ya da bir Typst projesinde **Yeniden derle**'nin yanındaki oku açıp **Motor (bu proje)** altında **Calepin**'i seçin.

Calepin'i Quarto gibi **Ayarlar → Motorlar → Calepin** bölümünden, **Calepin 0.0.61 sürümünü indir** ile kurun. Calepin, Oleafly ile birlikte gelen Typst ile derler. Dili kurulu olmayan bir kod bloğu kısa bir not gösterir ve belgenin geri kalanı yine derlenir. Dışa aktarma, Calepin'in oluşturduğu HTML'i sunar.

## Bir projede kod çalıştırmaya izin verme

Quarto ya da Calepin belgesindeki kod sizin izinlerinizle çalışır; bu yüzden siz izin verene kadar her projede kapalı kalır. Kod gerektiren bir derlemeden sonra düzenleyicinin üstündeki bir şerit kodun kapalı olduğunu söyler ve **Bu projede kod çalıştırmaya izin ver** seçeneğini sunar. **Yeniden derle**'nin yanındaki oku açıp **Kod (bu bilgisayar)** altında **Kodu bu bilgisayarda çalıştır**'ı da seçebilirsiniz. **Kapalı** kodu yeniden kapatır. Koda yalnızca projedeki her dosyaya güveniyorsanız izin verin.

Bu seçim yalnızca bu bilgisayar için geçerlidir. Projeye kaydedilmez ve projenin motorunu değiştirmek kodu yeniden kapatır. [Paylaşılan bir projede](/docs/collaboration/) Oleafly bir kez daha sorar, çünkü projeyi düzenleyebilen herkes kodunu değiştirebilir.

Kod kapalıyken:

- Quarto her kod bloğunun kodunu çalıştırmadan gösterir. Filtreler, kısa kodlar (shortcode), `_extensions`, oluşturma öncesinde ve sonrasında çalışan betikler ve satır içi R kodu o zaman bile kod çalıştırır; bu yüzden bunları kullanan bir belge, siz koda izin verene kadar derlenmez.
- Calepin kodu atlayamaz. Oleafly PDF'i, Calepin'in son çalıştığında sakladığı sonuçlardan düz Typst ile derler. Saklanmış sonuç yoksa derleme durur ve sizden koda izin vermenizi ister.

[Yerinde açtığınız](/docs/library/#folders-opened-in-place) bir klasöre, Quarto ya da Calepin onu derlemeden önce güvenmeniz de gerekir. Kaynak ve PDF eşitlemesi iki motorda da kullanılamaz.

## Yeni projeler için varsayılanı ayarlama

**Ayarlar → Motorlar → LaTeX** bölümünü açın ve **Varsayılan derleme motoru** olarak **Tectonic (yerleşik)** ya da **latexmk (sistem TeX)** seçin. Bu noktadan sonra oluşturduğunuz her LaTeX projesi onunla başlar:

- Boş bir proje ya da **Yeni proje** iletişim kutusundan bir şablon ve bir araştırma projesi.
- İçe aktarılan bir ZIP, klasör, arXiv makalesi ya da GitHub deposu.
- LaTeX projesine dönüştürdüğünüz bir belge; örneğin bir Word dosyası ya da bir PDF.

Motor, projenin `project.json` dosyasına yazılır; böylece projeyi açan ortak yazar onu aynı şekilde derler. Adında pdfLaTeX, XeLaTeX ya da LuaLaTeX geçen içe aktarılmış bir proje, `latexmk` üzerine yerleştiğinde o derleyiciyi korur. Var olan bir projenin kayıtlı derleyicisi kendi seçimi olarak kalır.

Kendi motoru olmayan ve [yerinde açtığınız](/docs/library/#folders-opened-in-place) bir klasör, ona güvendiğinizde varsayılanı izler. O ana dek Tectonic ile gösterilir ve derlenir. Oleafly, hangi durum olursa olsun klasöre hiçbir şey yazmaz.

Typst için **Ayarlar → Motorlar → Typst** bölümünü açın ve varsayılan sürümü seçin. Yeni Typst projeleri, oluşturulduklarında varsayılan olan sürümü sabitler. Varsayılanı sonradan değiştirmek var olan projeleri taşımaz.

## Geçerli projenin derleyicisini değiştirme

[Proje araç çubuğundaki](/docs/project-toolbar/) **Yeniden derle** düğmesinin yanındaki oka tıklayın. Bir LaTeX projesinde **Derleyici (bu proje)** altında Tectonic, Otomatik, pdfLaTeX, XeLaTeX ya da LuaLaTeX seçin, sonra derleyin. Bir şablon, seçili kurulumda bulunmayan bir paket ya da yazı tipi gerektiriyorsa günlüğü okuyun.

Bir Typst projesinde aynı menüde bunun yerine **Typst sürümü (bu proje)** bulunur. Kurulu bir sürüm seçin ya da Ayarlar'ı izlemek için **Varsayılan**'ı seçin. Menünün **Motor (bu proje)** grubu belgeyi **Typst** ile **Calepin** arasında değiştirir.

## Var olan bir TeX dağıtımını algılama

**Ayarlar → Motorlar → LaTeX** bölümünü açın ve algılanan araç zincirini gözden geçirin. Oleafly, `latexmk` ve destek araçları dahil eksiksiz bir derleyici kurulumu olup olmadığını denetler. Eksik bir sistem kurulumu, çalışan yönetilen bir kurulumdan öncelikli değildir.

## Yönetilen TinyTeX'i kurma

Geleneksel bir derleyiciye ihtiyacınız varsa ve elinizde yoksa LaTeX motor ayarlarındaki kur denetimini kullanın. Oleafly kendi TinyTeX kurulumunu `~/.oleafly/tinytex` altına indirir; yönetici erişimi gerekmez. İlk indirme için yaklaşık 250 MB, paketler içinse ek disk alanı öngörün.

## Paketleri yönetme

LaTeX motor ayarlarındaki paket listesi; paketleri süzmenize, açıklamalarını incelemenize ve ekleyip kaldırmanıza olanak tanır. Etiketleme rozetleri, etiketli bir PDF üretirken ek dikkat gerektiren paketleri belirtir. Bu denetimler `latexmk` tarafından kullanılan TeX dağıtımını yönetir; Tectonic tarafında önbellek ayrıdır.

[LaTeX paketleri ve etiketli PDF kılavuzunu okuyun →](/docs/latex-engines/)