> 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/on-premises/id/pemeliharaan/extending-tex-live.md).

# Memperluas TeX Live

Dimungkinkan untuk memperluas image TeX Live yang sudah ada menggunakan Dockerfile baru dan mengonfigurasi aplikasi agar menggunakan image baru tersebut.

Di sini kami menawarkan beberapa panduan untuk memasang paket atau font baru, tetapi konfigurasi image kustom tidak tercakup dalam ketentuan dukungan kami.

Image TeX Live menerima pembaruan yang jarang. Kami menyarankan untuk membangun ulang image kustom saat meningkatkan Server Pro.

{% hint style="danger" %}
Bagian-bagian berikut berlaku untuk Server Pro dan [Kompilasi dalam Sandbox](broken://pages/7fe188cd56df21debec84575d9fee91e5fd20f5c) saja.
{% endhint %}

### Memasang dan memperbarui paket baru

Anda dapat menggunakan `tlmgr` perintah seperti `tlmgr install` dan `tlmgr update` untuk mengelola paket TeX Live seperti pada contoh berikut:

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

RUN tlmgr update --force ebproof
```

### Menggunakan `tlmgr` dalam image TeX Live yang lebih lama

Secara bawaan `tlmgr` mengunduh sumber daya dari rilis TeX Live terbaru. Saat melakukan patch pada image TeX Live yang lebih lama, unduhan perlu dialihkan ke arsip yang sesuai. Lihat daftar di <https://www.tug.org/historic/> untuk mirror arsip.

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

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

RUN tlmgr update --force ebproof
```

### Memasang font baru

Ada berbagai prosedur untuk memasang font baru dalam distribusi TeX Live, dan memasang font kustom mungkin memerlukan beberapa langkah. Memeriksa [petunjuk untuk memasang font TeX](https://tug.org/fonts/fontinstall.html) dalam dokumentasi resmi TeX Live mungkin merupakan titik awal yang baik.

Berikut `Dockerfile` menunjukkan contoh pemasangan font TrueType pada image TeX Live 2022 yang sudah ada:

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

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

# bangun ulang cache informasi font
RUN fc-cache
```

### Mengonfigurasi Server Pro untuk menggunakan image baru

Gunakan nama `ghcr.io/ayaka-notes/texlive-full` dan tag kustom untuk membangun image baru, seperti:

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

Sekarang kita dapat mengonfigurasi Server Pro untuk menggunakan `2023.1-custom` image dengan memperbarui `TEX_LIVE_DOCKER_IMAGE` dan `ALL_TEX_LIVE_DOCKER_IMAGES` variabel lingkungan:

{% 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 %}

Pada contoh di atas, proyek baru secara bawaan diatur untuk menggunakan `2023.1-custom` image baru, sementara `2023.1` masih tersedia saat diperlukan.


---

# 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/on-premises/id/pemeliharaan/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.