> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/tr/bakim/extending-tex-live.md).

# TeX Live'ı genişletme

Mevcut bir TeX Live görüntüsünü yeni bir Dockerfile kullanarak genişletmek ve uygulamayı yeni görüntüyü kullanacak şekilde yapılandırmak mümkündür.

Burada yeni paketler veya yazı tipleri kurmak için bazı yönergeler sunuyoruz, ancak özel bir görüntünün yapılandırılması destek koşullarımız kapsamında değildir.

TeX Live görüntüleri seyrek güncelleme alır. Server Pro’yu yükseltirken özel görüntüleri yeniden oluşturmanızı öneririz.

{% hint style="danger" %}
Aşağıdaki bölümler Server Pro ve [Sandboxed Compiles](broken://pages/e85dee05d4a1e0c3c0c485db7d507310f21a7743) için geçerlidir.
{% endhint %}

### Yeni paketlerin kurulması ve güncellenmesi

Kullanabilirsiniz `tlmgr` şu gibi komutlar `tlmgr install` ve `tlmgr update` TeX Live paketlerini aşağıdaki örnekte olduğu gibi yönetmek için:

```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof
```

### Kullanma `tlmgr` daha eski bir TeX Live görüntüsünde

Varsayılan olarak `tlmgr` kaynakları en son TeX Live sürümünden indirir. Daha eski bir TeX Live görüntüsüne yama uygulanırken, indirmelerin ilgili arşive yönlendirilmesi gerekir. Arşiv yansıları için <https://www.tug.org/historic/> adresindeki listeye bakın.

```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# örn. RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

RUN tlmgr update --force ebproof
```

### Yeni yazı tiplerinin kurulması

Bir Tex Live dağıtımında yeni yazı tiplerini kurmak için farklı yöntemler vardır ve özel bir yazı tipini kurmak birkaç adım gerektirebilir. Resmî Tex Live belgelerindeki [TeX yazı tiplerini kurma talimatlarını](https://tug.org/fonts/fontinstall.html) incelemek muhtemelen iyi bir başlangıç noktasıdır.

Aşağıdaki `Dockerfile` mevcut bir Tex Live 2022 görüntüsü üzerine bir TrueType yazı tipi kurmaya örnek gösterir:

```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# yazı tipi bilgi önbelleğini yeniden oluştur
RUN fc-cache
```

### Server Pro’yu yeni görüntüleri kullanacak şekilde yapılandırma

Şu adı kullanın `ghcr.io/ayaka-notes/texlive-full` ve yeni görüntüyü oluşturmak için özel bir etiket kullanın, örneğin:

```bash
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```

Artık Server Pro’yu yeni `2023.1-custom` görüntüsünü kullanacak şekilde yapılandırabilir, `TEX_LIVE_DOCKER_IMAGE` ve `ALL_TEX_LIVE_DOCKER_IMAGES` ortam değişkenlerini güncelleyebilirsiniz:

{% code overflow="wrap" %}

```
TEX_LIVE_DOCKER_IMAGE: "ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
ALL_TEX_LIVE_DOCKER_IMAGES: "ghcr.io/ayaka-notes/texlive-full:2023.1,ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
```

{% endcode %}

Yukarıdaki örnekte yeni projeler varsayılan olarak yeni `2023.1-custom` görüntüyü kullanacak şekilde ayarlanır, `2023.1` ihtiyaç duyulduğunda ise hâlâ kullanılabilir.


---

# 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://ayakaleaf-pro.ayaka.space/on-premises/tr/bakim/extending-tex-live.md?ask=<question>&goal=<endgoal>
```

`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.