> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/texlive/tr/dockerda-texlive.md).
# Docker'da TeXLive
### Docker
Docker, uygulamaları yalıtılmış kapsayıcılarda paketlemek ve çalıştırmak için hafif ve taşınabilir bir yol sunar. Uygulamayı gerekli tüm bağımlılıklarla birlikte paketleyerek, bir kapsayıcı 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üzeyi farklılıklara karşı hassastır. TeX Live'ı bir Docker imajının içine paketlemek, LaTeX araç zincirini öngörülebilir, yeniden üretilebilir ve dağıtımı kolay hale getirir.
Ancak, bazı TeX Live paketleri kabuk erişimine dayanır. Güvenlik nedenleriyle, kapsayıcı kullanıcıların rastgele kabuk komutları çalıştırmasını engelleyen kısıtlı bir ortamda çalışmalıdır (örneğin aracılığıyla `\write18` veya shell escape). Bu yalıtım ana sistemi korur ve kapsayıcının alt dosya sistemine ya da `bash`.
### TeXLive Tam Sürüm
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) tam özellikli bir **TeXLive Docker imajı** özellikle Overleaf Server Pro, Overleaf Pro ve ayrıca CI veya iş akışları gibi bağımsız LaTeX derleme ortamları için tasarlanmıştır.
Bu imaj, eksik paketler veya yazı tiplerinin neden olduğu 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.
Özellikler:
* 🚀 Hem x86\_64 hem de arm64 sunucu mimarilerini destekler
* 📦 Tam ve optimize edilmiş TeXLive kurulumu
* 🧩 Önceden kurulmuş yaygın yazı tipleri ve yardımcı 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 yeni)
* 🧑🔬 LaTeX belgelerinde R kodu için Knitr desteği
### Overleaf Pro Kullanımı
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) destek **Overleaf Pro**için aşağıdaki ortam değişkenlerini kullanabilirsiniz `config/variables.env` dosyası, eğer [toolkit kullanıcısıysanız](https://github.com/overleaf/toolkit).
Örneğin:
{% code title="config/variables.env" overflow="wrap" %}
```dotenv
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2025.1
```
{% endcode %}
### TeXLive Sürümü
GitHub Action sayesinde tüm tex imajlarını paralel olarak oluşturabiliyoruz; buna şunlar dahildir:
* `ghcr.io/ayaka-notes/texlive-full:2026.1` (Ayrıca `en yeni` etiket)
* `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`
şuradan alınan yansıtma arşivini kullanıyoruz: [texlive bilgisi](https://texlive.info/tlnet-archive/), 1996'dan 2026'ya kadar neredeyse tüm texlive imajlarını içerir. Ve Overleaf'in Dockerfile'ı sayesinde bu projeyi daha hızlı oluşturabiliyoruz.
> Neden texlive 2019 ve öncesi desteklenmiyor?
>
> Bu tür imajları sürdürmek son derece zordur. Ayrıca, artık bunları kullanmadığınızı düşünüyoruz çünkü çok eskiler. Gerekirse, bana bildirmek için bir issue açın.
### İçerilen Bileşenler
Aşağıdaki paketler docker imajında yer almaktadır.
* Tüm TeXLive paketleri (o yıl için)
* R paketleri (yalnızca seçilmiş olanlar)
* fontconfig inkscape pandoc python3-pygments wget python3
* gnupg gnuplot perl-modülleri perl ca-certificates
* ghostscript qpdf r-base-core tar
Aşağıdaki yazı tipleri docker imajında yer almaktadır.
* [Google Fonts](https://fonts.google.com/)
* [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
* [Overleaf destekli yazı tipleri](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)
{% hint style="warning" %}
İlgili yazı tiplerinin ticari olarak kullanılıp kullanılamayacağını lütfen doğrulayın. Biz **sorumlu değiliz** yazı tiplerini yanlış kullanmanızdan kaynaklanan herhangi bir hukuki sorundan. İmajı indirdiğinizde bunu otomatik olarak kabul etmiş olursunuz.
{% endhint %}
### Lisans
MIT
### Sorunlar
Sorun 01: Yazı Tipi Önbelleği Eksik Sorunu
Overleaf bir LaTeX projesini derlediğinde, eğer yazı tipi eksikliği oluşursa, **derleme sürecinin çok uzun sürdüğünü fark edebilirsiniz**, 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 alan bir işlemdir.
Bizim imajımızda yazı tipi önbelleğini önceden oluşturduk; bu sorunu [bu commit ile](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f)
Sorun 02: Sync Tex Aşırı Yavaş
Bu imajı sharelatex'te kullandığınızda, Sync TeX'in aşırı yavaş olduğunu fark edebilirsiniz.
Bkz.: , yalnızca HTTP/2.0'yı devre dışı bırakın.
Sorun 03: Resmî Texlive İmajıyla Yeniden Derleme Hatası
Docker Hub'daki resmî texlive imajını kullanırsanız `texlive/texlive`, bir projeyi yeniden derlediğinizde hata verebileceğini fark edebilirsiniz. Ancak bizim imajımızda bu sorun çözülmüştür. Çünkü en son Ubuntu temel imajını kullanıyor ve tüm bağımlılıkları Ubuntu'nun resmî deposundan yüklüyoruz.
### Diğer Teknik Notlar
2019'dan önceki texlive imajını oluştururken aşağıdaki sorunlara dikkat etmeniz gerekebilir:
* Yalnızca `http`/`ftp` texlive 2017'den önce desteklenir, bu yüzden kullanamazsınız `https` indirmek için, olmadıkça `peal` betiğini.
* 2015'ten önce yalnızca sha256 dosyası sağlanır. Bu nedenle kontrol için sha512 kullanamazsınız.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://overleaf-pro.ayaka.space/texlive/tr/dockerda-texlive.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.