Bir belge motoru 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.

LaTeX, Tectonic veya latexmk ile derlenir; Typst ise projenin sabitlediği sürümle. Markdown önce Pandoc'tan, sonra Tectonic'ten geçer.

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.

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 ç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 sürümleri, paketleri, yazı tiplerini ve derleme çeşitlerini ele alır. Typst yazım kılavuzunda 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ı sayfasını kullanın. Dışa aktarma kılavuzu, 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 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 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 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 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 →