> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker'da TeX Live

### Docker

Docker, uygulamaları yalıtılmış konteynerlerde paketlemek ve çalıştırmak için hafif ve taşınabilir bir yol sunar. Bir konteyner, uygulamayı gerekli tüm bağımlılıklarla birlikte paketleyerek dizüstü bilgisayarlardan üretim sunucularına kadar farklı makinelerde tutarlı davranış sağlar.

TeX Live güçlüdür ancak büyüktür ve sistem düzeyindeki farklılıklara karşı hassastır. TeX Live'ı bir Docker imajı içinde paketlemek, LaTeX araç zincirini öngörülebilir, yeniden üretilebilir ve kolay dağıtılabilir hale getirir.

Ancak bazı TeX Live paketleri kabuk erişimine dayanır. Güvenlik nedeniyle konteyner, kullanıcıların keyfi kabuk komutları çalıştırmasını (örneğin `\write18` veya shell escape aracılığıyla) engelleyen kısıtlı bir ortamda çalışmalıdır. Bu yalıtım ana sistemi korur ve konteynerin alttaki dosya sistemine veya `bash` gibi araçlara istenmeyen erişimi önler.

### TeXLive Full Sürümü

[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/), [Ayakaleaf Pro](https://github.com/ayaka-notes/ayakaleaf-pro), [Overleaf CEP](https://github.com/yu-i-i/overleaf-cep) veya bağımsız LaTeX derleme ortamlarında sandbox içinde LaTeX derlemesi için tasarlanmış, tam özellikli bir **TeXLive Docker imajıdır**.

Bu imaj, eksik paketler veya yazı tiplerinden kaynaklanan derleme hatalarını en aza indirmek için yaygın yazı tipleri ve araçlar önceden kurulmuş, neredeyse eksiksiz bir TeXLive dağıtımı sunmayı amaçlar. Not: Bu Docker imajı herhangi bir sharelatex/overleaf bileşeni **içermez**. Overleaf/Overleaf Pro'nun derlemesi için kullanılır.

#### Özellikler:

* 🚀 Hem x86\_64 hem de arm64 sunucu mimarilerini destekler
* 📦 Eksiksiz ve optimize edilmiş TeXLive kurulumu
* 🧩 Önceden kurulmuş yaygın yazı tipleri ve araçlar
* 🐳 Docker ve Docker Compose ile kullanıma hazır
* 🧪 Overleaf Server Pro / Overleaf Pro ile test edilmiştir
* 🔄 En son TeXLive sürümleriyle düzenli olarak güncellenir
* 🏷 Birden çok TeXLive sürüm etiketi (2020 – En Son)
* 🧑‍🔬 LaTeX belgelerinde R kodu için Knitr desteği

### Ayakaleaf Pro ile Kullanım

Ayaka-notes tarafından hazırlanan TeX Live Full, [ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) için özel olarak tasarlanmıştır; [toolkit kullanıcısıysanız](https://github.com/overleaf/toolkit) aşağıdaki ortam değişkenlerini `config/variables.env` dosyasında kullanabilirsiniz.

Örneğin:

```dotenv title="config/variables.env" wrap theme={null}
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
```

### TeX Live Sürümü

Github Action sayesinde tüm tex imajlarını paralel olarak derleyebiliyoruz; bunlar şunlardır:

* `ghcr.io/ayaka-notes/texlive-full:2026.1` (Ayrıca `latest` etiketi)
* `ghcr.io/ayaka-notes/texlive-full:2025.1`
* `ghcr.io/ayaka-notes/texlive-full:2024.1`
* `ghcr.io/ayaka-notes/texlive-full:2023.1`
* `ghcr.io/ayaka-notes/texlive-full:2022.1`
* `ghcr.io/ayaka-notes/texlive-full:2021.1`
* `ghcr.io/ayaka-notes/texlive-full:2020.1`
* `ghcr.io/ayaka-notes/texlive-full:base`

1996'dan 2025'e kadar neredeyse tüm texlive imajlarını içeren [texlive info](https://texlive.info/tlnet-archive/) ayna arşivini kullanıyoruz. Ayrıca Overleaf'in Dockerfile'ı sayesinde bu projeyi daha hızlı derleyebiliyoruz.

> TeX Live 2019 ve öncesi neden desteklenmiyor?
>
> Bu eski imajların bakımını yapmak son derece zordur. Ayrıca [texlive.info](https://texlive.info/) web sitesi 2019'dan önce yayımlanan TeX Live sürümleri için bilgi sağlamadığından bu sürümler için imaj oluşturamıyoruz. Belirli bir eski sürüme ihtiyacınız varsa lütfen bir issue açarak bize bildirin.

### İçerilen Bileşenler

Docker imajında aşağıdaki paketler bulunur.

* Tüm TeXLive paketleri (ilgili yıla ait)
* R paketleri (yalnızca seçilmiş olanlar)
* fontconfig inkscape pandoc python3-pygments wget python3
* gnupg gnuplot perl-modules perl ca-certificates
* ghostscript qpdf r-base-core tar

Docker imajında aşağıdaki yazı tipleri bulunur.

* [Google Fonts](https://fonts.google.com/)
* [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
* [Overleaf tarafından desteklenen yazı tipleri](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)

<Warning>
  Lütfen ilgili yazı tiplerinin ticari olarak kullanılıp kullanılamayacağını teyit edin. Yazı tiplerini yanlış kullanmanızdan kaynaklanan herhangi bir yasal sorundan **sorumlu değiliz**. İmajı indirdiğiniz anda bunu otomatik olarak kabul etmiş olursunuz.
</Warning>

### Lisans

MIT

### Sorunlar

<Accordion title="Sorun 01: Yazı Tipi Önbelleği Eksikliği Sorunu">
  Overleaf bir LaTeX projesini derlerken bir yazı tipi bulunamazsa **derleme işleminin uzun sürdüğünü görebilirsiniz**; bunun nedeni, bir yazı tipi eksik olduğunda texlive'ın **tüm yazı tipi önbelleğini yeniden oluşturmaya** çalışmasıdır. Bu zaman alıcı bir işlemdir.

  İmajımızda yazı tipi önbelleğini önceden oluşturduk; bu sorunu [bu commit](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f) ile düzelttik
</Accordion>

<Accordion title="Sorun 02: SyncTeX'in Aşırı Yavaş Olması">
  Bu imajı sharelatex'te kullandığınızda SyncTeX'in aşırı yavaş olduğunu görebilirsiniz.

  Bkz.: [https://github.com/overleaf/overleaf/issues/1150](https://github.com/overleaf/overleaf/issues/1150); HTTP 2.0'ı devre dışı bırakmanız yeterlidir.
</Accordion>

<Accordion title="Sorun 03: Resmi Texlive İmajıyla Yeniden Derleme Hatası">
  Docker Hub'daki resmi texlive imajını (`texlive/texlive`) kullanırsanız, bir projeyi yeniden derlediğinizde hata bildirdiğini görebilirsiniz. Ancak bizim imajımızda bu sorun düzeltilmiştir. Çünkü en son Ubuntu temel imajını kullanıyor ve tüm bağımlılıkları Ubuntu'nun resmi deposundan kuruyoruz.
</Accordion>

### Diğer Teknik Hatırlatmalar

texlive imajı derlerken (2019 öncesi) aşağıdaki sorunlara dikkat etmeniz gerekebilir:

* texlive 2017'den önce yalnızca `http`/`ftp` desteklenir; bu nedenle `peal` betiğini değiştirmediğiniz sürece indirme için `https` kullanamazsınız.
* 2015'ten önce yalnızca sha256 dosyası sağlanır. Bu nedenle sha512 ile doğrulama yapamazsınız.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.