Belge araçları
Paketler
CTAN'da LaTeX paketleri ve Typst Universe'de Typst paketleri arayın, sonra düzenleyici araç çubuğundan belgenize bir paket ekleyin.
LaTeX ve Typst belgeleri ek işlevlerinin çoğunu paketlerden alır. Düzenleyici araç çubuğunun sağ ucundaki paketler düğmesi, projenin diline göre aranabilir bir liste açar ve bir paketi yükleyen satırı sizin için yazar. Markdown projelerinde paketler düğmesi yoktur.
Listeyi ⌘K paletinden LaTeX paketlerine göz at ya da Typst paketlerine göz at ile de açabilirsiniz.
LaTeX paketleri
Bölüm başlığı “LaTeX paketleri”Bir LaTeX projesinde LaTeX paketleri’ni seçin. CTAN’da paket adına veya açıklamaya göre arama yapın. CTAN’a ulaşılamıyorsa ya da çevrimdışıysanız iletişim kutusu bunu belirtir ve yerine Oleafly’nin yerleşik listesini gösterir. Yenilenemeyen bir liste, indirildiği tarihi gösterir.
Her satır şu etiketleri gösterebilir:
- Belgede: ana dosya bu paketi zaten yüklüyor.
- Belge sınıfı: girdi bir paket değil, sınıftır. Sınıflar
\documentclassile ayarlanır; bu nedenle satır o satırı kopyalamanıza izin verir ama eklemenize vermez. - Kurulu: TeX dağıtımınızda bu paket zaten var.
Her satırda ayrıca şu denetimler bulunur:
- Seçenekler,
margin=2cmgibi paket seçenekleri için bir alan. Süslü parantezler eşleşmeli;]veya%kullanılamaz. - Ön bölüme ekle, ana dosyanın ön bölümüne
\usepackage[options]{name}satırını yazar. Dosya paketi zaten yüklüyorsa hiçbir şey değişmez ve iletişim kutusu size bunu bildirir. - Satırı kopyala, aynı
\usepackagesatırını, sınıflar için ise\documentclasssatırını kopyalar. - CTAN, paketin CTAN sayfasını açar.
- Kur, TeX dağıtımınızda eksik olan paketler için. Aşağıya bakın.
LaTeX paketleri kurma
Bölüm başlığı “LaTeX paketleri kurma”“Kurulu”nun anlamı, projenin nasıl derlendiğine bağlıdır:
- Tectonic, yerleşik derleyici, bir paketi belgeniz ilk kez kullandığında indirir. Kurulacak bir şey yoktur; iletişim kutusu bunu üstte belirtir.
- TeX Live ya da TinyTeX ile latexmk: TeX dağıtımınızda
tlmgrvarsa Oleafly hangi paketlere sahip olduğunuzu denetler, onları Kurulu olarak işaretler ve kalanlar için Kur seçeneğini sunar. Kur, o tek paket içintlmgrkomutunu çalıştırır. - Debian, Ubuntu ya da Fedora’dan TeX Live: sistemin paket yöneticisi ona sahiptir; bu yüzden iletişim kutusu paketleri
aptveyadnfile kurmanızı söyler ve Kur düğmesi yoktur. - Diğer TeX kurulumları, örneğin MiKTeX: Oleafly hangi paketlerin bulunduğunu anlayamaz; bu nedenle satırlarda kurulum durumu gösterilmez. MiKTeX için MiKTeX Console’u kullanın.
TeX Live ya da TinyTeX ile, dosyayı bulamayan bir derleme hatada Bul ve kur sunar; bu, dosyanın hangi pakete ait olduğunu bulur. Bkz. Eksik dosyadan kurtulma.
Derleyiciyi Yeniden derle düğmesinin yanındaki oktan seçin. LaTeX motorlarına bakın.
Typst paketleri
Bölüm başlığı “Typst paketleri”Bir Typst projesinde Typst Universe’de göz atmak için Typst paketleri’ni seçin. Ada, anahtar kelimeye veya kategoriye göre arama yapın ya da listeyi bir kategori etiketiyle daraltın. İletişim kutusu bir kerede en fazla 100 paket gösterir; liste uzunsa arama yapın.
Her satır paket adını, en son sürümünü, şablon paketleri için bir Şablon rozetini ve kısa bir açıklamayı gösterir. Bir paket, projenin kullandığından daha yeni bir Typst gerektirdiğinde satır hangi sürümün gerektiğini belirtir.
- İçe aktarma ekle, açık
.typdosyasının üstündeki içe aktarmaların ardından#import "@preview/name:version": *satırını ekler. Dosya bu paketi zaten içe aktarıyorsa yalnızca sürüm numarası değişir. Düzenleyicide bir Typst dosyası açık olmalıdır. - İçe aktarmayı kopyala aynı satırı kopyalar.
Güncelleme ipuçları
Bölüm başlığı “Güncelleme ipuçları”Dosyanızdaki bir @preview içe aktarımı Typst Universe’teki en son sürümden eskiyse, düzenleyici sürümü “cetz 0.4.2 kullanılabiliyor. Bu içe aktarma 0.3.4 sürümünü kullanıyor.” gibi bir ipucuyla işaretler. İpucunun 0.4.2 sürümüne güncelle eylemi sayıyı yerinde değiştirir.
Paketleri projeyle birlikte tutma
Bölüm başlığı “Paketleri projeyle birlikte tutma”Typst, bir proje paketleri ilk kez içe aktardığında bunları paylaşılan bir önbelleğe indirir. Bir projenin kendi kopyalarını taşımasını sağlamak için iletişim kutusunun altındaki Proje paketleri bölümünü kullanın:
- Proje klasöründeki paketleri kullan, Typst’ın önce projenin
typst-packagesklasörüne bakmasını sağlar. Bu şekilde ayarlanan bir proje çevrimdışı ve başka bilgisayarlarda derlenir. - Paketleri projeye kopyala, projenin içe aktardığı her paketi önbellekten
typst-packagesiçine kopyalar. Bir paket henüz önbellekte değilse bir kez çevrimiçi derleyin, sonra yeniden kopyalayın.
İkisi de Typst 0.12 ya da daha yenisini gerektirir. Typst 0.11’e sabitlenmiş bir projede bölüm bunu söyler.
Bölüm, projenin kaç paket barındırdığını da gösterir.
Çevrimdışı
Bölüm başlığı “Çevrimdışı”Çevrimdışı kip açıkken iletişim kutusu en son indirdiği paket listesini kullanır ve tarihini gösterir. Hiç liste indirilmemişse, çevrimiçi olana kadar bir liste gösteremez.
İlgili sayfalar
Bölüm başlığı “İlgili sayfalar”- Düzenleyici: düzenleyici araç çubuğunun geri kalanı
- Derleme: paketlerin bir derleme sırasında nasıl alındığı
- Belge ayarları: paket kodu yazmadan kağıt boyutu, kenar boşlukları ve yazı tipleri