# 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

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 `\documentclass` ile 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=2cm` gibi 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ı `\usepackage` satırını, sınıflar için ise `\documentclass` satı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

"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 `tlmgr` varsa 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çin `tlmgr` komutunu ç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 `apt` veya `dnf` ile 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](/docs/latex-engines/#recover-from-a-missing-file).

Derleyiciyi **Yeniden derle** düğmesinin yanındaki oktan seçin. [LaTeX motorlarına](/docs/latex-engines/) bakın.

## 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 `.typ` dosyası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ı

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

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-packages` klasö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-packages` iç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ışı

Ç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

- [Düzenleyici](/docs/editor/#the-editor-toolbar): düzenleyici araç çubuğunun geri kalanı
- [Derleme](/docs/compiling/): paketlerin bir derleme sırasında nasıl alındığı
- [Belge ayarları](/docs/document-settings/): paket kodu yazmadan kağıt boyutu, kenar boşlukları ve yazı tipleri
