# İndirme ve kurulum

Oleafly'yi macOS, Windows ya da Linux'a kurun, ardından uygulamanın ilk kullanımda neler indirebileceğini öğrenin.

Oleafly kurulumu bir indirme ve bir çift tıklamadan ibarettir. Hesap gerekmez, oturum açma gerekmez, ayrı bir LaTeX dağıtımı da gerekmez: derleyici uygulamanın içinde gelir.

## Uygulamayı indirme

En son kurulum dosyasını [sürümler sayfasından](https://github.com/Oleafly/Oleafly/releases/latest) alın ya da [oleafly.com](https://oleafly.com/) üzerindeki İndir düğmesini kullanın; bu düğme mümkün olduğunda platformunuza uygun kurulum dosyasını bulur.

| Platform | İndirme | Yapılacak iş |
|---|---|---|
| macOS (Apple Silicon) | `_aarch64.dmg` | M1 ya da daha yenisi. Dmg dosyasını açın, Oleafly'yi Applications klasörüne sürükleyin. |
| macOS (Intel) | `_x64.dmg` | Intel Mac'ler. Dmg dosyasını açın, Oleafly'yi Applications klasörüne sürükleyin. |
| Windows (x86_64) | `.msi` veya `-setup.exe` | İki kurulum dosyasından birini çalıştırın ve yönergeleri izleyin. |
| Linux (x86_64) | `.AppImage`, `.deb` veya `.rpm` | Çoğu dağıtımda AppImage'ı, Debian tabanlı sistemlerde Debian paketini, Fedora'da RPM'i kullanın. |
| Linux (ARM64) | `.AppImage`, `.deb` veya `.rpm` | ARM64 Linux sistemleri için yerel paketler. |

Linux'ta Oleafly, glibc 2.35 ya da daha yeni bir sürüm ister (2022 dönemi ya da sonrası: Ubuntu 22.04+, Fedora 36+, Debian 12+).

Hangi Mac'e sahip olduğunuzdan emin değilseniz Apple menüsünü açın ve **Bu Mac Hakkında** öğesini seçin. **Çip** satırı Apple Silicon anlamına gelir; Intel adını içeren bir **İşlemci** satırı ise Intel işlemcili bir Mac demektir.

Güncel dağıtım hedefleri **macOS Apple Silicon**, **macOS Intel**, **Windows x64**, **Linux x64** ve **Linux ARM64**. ARM üzerindeki Windows'ta henüz yerel paket yok.

## İlk başlatma

### macOS

Disk kalıbını açın, Oleafly'yi Applications klasörüne sürükleyin ve çalıştırın. Resmî kurulum dosyasını kullanın. macOS engellerse ilk açılış iletisi için **Sistem Ayarları → Gizlilik ve Güvenlik** bölümüne bakın.

### Windows

MSI ya da kurulum çalıştırılabilir dosyasını çalıştırın ve kurulum sihirbazını izleyin. Windows bir itibar uyarısı gösterirse devam etmeden önce indirmenin resmî sürümden geldiğini doğrulayın. Kurulum programı, Typst'nin ve LaTeX dil sunucusunun gerektirdiği Microsoft Visual C++ çalışma zamanı dosyasını uygulamanın yanına yerleştirir; böylece onu ayrıca kurmanız gerekmez.

### Linux

Debian ya da RPM paketini paket yöneticinizle kurun ya da AppImage dosyasını çalıştırılabilir yapıp açın:

```bash
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage
```

Oleafly, glibc 2.35 ya da daha yeni bir sürüm ister. Bilgisayarınızın mimarisine uygun paketi seçin.

`.deb` ve `.rpm` paketleri Oleafly'nin kendi Tectonic, Pandoc ve Typst kopyalarını `/usr/libexec/oleafly` içinde tutar; böylece dağıtımınızın Pandoc'unun yanına kurulabilirler. AppImage'ı başlattığınızda kendini uygulama menünüze ekler; GNOME gibi Wayland masaüstleri simgesini dock'ta göstermeden önce buna ihtiyaç duyar. Kurulu bir paket ya da başka bir araç Oleafly'yi zaten eklemişse menüye dokunmaz ve girdiyi silerseniz silinmiş kalır.

Debian paketi bir açıklama içerir; bu sayede Ubuntu'nun App Center'ı Oleafly'yi kurmadan önce size tanıtır. Paket ayrıca AppStream verisi taşır; böylece yazılım merkezleri Oleafly kurulduktan sonra simgeyi, lisansı, ekran görüntülerini ve sürümü gösterir. Uygulama, uygulama menünüzde Office altında görünür. Linux'ta da Windows'taki gibi Oleafly kendi başlık çubuğunu çizer. Araç çubuğu, küçültme, büyütme ve kapatma düğmeleriyle üstte yer alır. Pencereyi taşımak için araç çubuğunu sürükleyin, büyütmek için çift tıklayın ve yeniden boyutlandırmak için herhangi bir kenarı ya da köşeyi sürükleyin.

## İlk derleme TeX paketlerini indirir

Uygulamayla gelen Tectonic motorunda bir belgeyi ilk kez derlediğinizde, uygulama o belgenin gerektirdiği paketleri indirir ve önbelleğe alır. Bir bilgisayardaki ilk derleme, yaygın kullanılan bir paket grubunu da tek seferde indirir; böylece sonraki belgeler daha hızlı başlar. Bu işlem bir ağ bağlantısı ister ve yavaş bir hatta birkaç dakika sürebilir. Derleme süre sınırı, paketler hâlâ gelirken bekler; Oleafly'nin paket yansısı başarısız olursa derleme üst kaynağa döner. Aynı belgenin sonraki derlemeleri hızlıdır ve çevrimdışı çalışır. Henüz önbelleğinizde olmayan bir pakete ihtiyaç duyan bir belge bir kez daha tek seferlik indirme tetikler. Ayrıntılar için katı çevrimdışı kip de dahil [Derleme](/docs/compiling/) sayfasına bakın.

## İsteğe bağlı: bir TeX dağıtımı

Tectonic çoğu belgeyi karşılar. Bir proje pdfLaTeX, upLaTeX ya da tam bir TeX dağıtımından başka bir derleyici gerektirdiğinde Oleafly, bilgisayarınızdaki MacTeX, TeX Live, MiKTeX ya da TinyTeX'i kullanır. Hiçbiri yoksa sizin için TinyTeX'i **Ayarlar → Motorlar → LaTeX** bölümünden ya da doğrudan derleme hatasından kurabilir. TinyTeX yönetici hakları gerektirmez, indirme yaklaşık 250 MB'tır ve Oleafly yaklaşık 2 GB boş disk alanı arar.

- Linux'ta TinyTeX sistemin Perl'ünü kullanır. Eksikse önce kurun: `sudo apt install perl`, `sudo dnf install perl` ya da `sudo pacman -S perl`.
- Windows'ta MiKTeX, `latexmk`'yi çalıştırmak için Perl ister. Strawberry Perl kurun ya da kendi Perl'ünü getiren TinyTeX'i kurun.
- Debian, Ubuntu ve Fedora'da `apt` veya `dnf` ile kurduğunuz bir TeX Live, LaTeX paketlerini de `apt` ya da `dnf` üzerinden alır. Oleafly neyi kuracağınızı söyler ama onu değiştirmez.

Bkz. [LaTeX motorları ve paketleri](/docs/latex-engines/#latexmk-and-system-tex).

Dosyalarınız diskte sıradan klasörler olarak kalır. Belirteçler ve yapay zeka anahtarları şifrelenmiş, yalnızca sahibinin erişebildiği yerel dosyalarda durur. Çevrimiçi özellikler arasında barındırılan yapay zeka, GitHub eşitleme, paket indirmeleri, atıf aramaları ve güncelleme denetimleri vardır. Ayrıntılar için [Felsefe](/docs/philosophy/) sayfasına bakın.

## Güncel kalma

Oleafly imzalı bir sürüm akışını denetler, sürüm notlarını gösterir ve onayladığınızda yerinde kurulum yapar. Linux'ta otomatik değiştirme AppImage kurulumları için çalışır. **Ayarlar → Yardım ve Hakkında** bölümünden de denetleyebilirsiniz. Ayrıntılar için [Güncellemeler](/docs/updates/) sayfasına bakın.

## Kaynak koddan derleme

Ön koşullar, motor indirmeleri ve yerel derlemeler için [masaüstü geliştirme kılavuzunu](https://github.com/Oleafly/Oleafly/blob/main/docs/development.md) izleyin.

## Sonraki adımlar

- [Başlangıç](/docs/getting-started/): birkaç dakikada ilk projeden ilk PDF'e.
- [Şablonlar](/docs/templates/): uygulamayla gelen başlangıç dosyaları ve indirilebilir paketler.
- [Oleafly Learn](/learn/): web'de ücretsiz LaTeX ve araştırma yazımı müfredatı.
- [Komut satırı aracı](/docs/cli/): projeleri bir terminalden derleyin, denetleyin ve eşitleyin, kodlama ajanlarını bağlayın.
