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

# TeX Liven laajentaminen

> Laajenna TeX Live -Docker-imageja paketeilla ja fonteilla tuettuja käännösympäristöjä varten.

Olemassa olevaa TeX Live -imagea on mahdollista laajentaa uudella Dockerfilellä ja määrittää sovellus käyttämään uutta imagea.

Tässä annamme ohjeita uusien pakettien tai fonttien asentamiseen, mutta mukautetun imagen konfigurointi ei kuulu tukiehtojemme piiriin.

TeX Live -imageja päivitetään harvoin. Suosittelemme mukautettujen imagejen uudelleenrakentamista Server Pron päivityksen yhteydessä.

<Danger>
  Seuraavat osiot koskevat vain Server Prota ja [hiekkalaatikoituja käännöksiä (Sandboxed Compiles)](/fi/on-premises/configuration/overleaf-toolkit/sandboxed-compiles).
</Danger>

### Uusien pakettien asentaminen ja päivittäminen

Voit hallita Tex Live -paketteja `tlmgr`-komennoilla, kuten `tlmgr install` ja `tlmgr update`, seuraavan esimerkin mukaisesti:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof
```

### `tlmgr`:n käyttäminen vanhemmassa TeX Live -imagessa

Oletuksena `tlmgr` lataa resurssit uusimmasta TeX Live -julkaisusta. Kun paikkaat vanhempaa TeX Live -imagea, lataukset on vaihdettava vastaavaan arkistoon. Arkistojen peilipalvelimet löydät luettelosta osoitteessa [https://www.tug.org/historic/](https://www.tug.org/historic/).

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

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

RUN tlmgr update --force ebproof
```

### Uusien fonttien asentaminen

Uusien fonttien asentamiseen Tex Live -jakeluun on erilaisia menettelyjä, ja mukautetun fontin asentaminen voi vaatia useita vaiheita. Virallisen Tex Live -dokumentaation [TeX-fonttien asennusohjeet](https://tug.org/fonts/fontinstall.html) ovat todennäköisesti hyvä lähtökohta.

Seuraava `Dockerfile` näyttää esimerkin TrueType-fontin asentamisesta olemassa olevan Tex Live 2022 -imagen päälle:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

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

# rebuild font information cache
RUN fc-cache
```

### Server Pron määrittäminen käyttämään uusia imageja

Käytä uuden imagen rakentamiseen nimeä `ghcr.io/ayaka-notes/texlive-full` ja mukautettua tagia, esimerkiksi:

```bash theme={null}
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```

Nyt voimme määrittää Server Pron käyttämään uutta `2023.1-custom`-imagea päivittämällä ympäristömuuttujat `TEX_LIVE_DOCKER_IMAGE` ja `ALL_TEX_LIVE_DOCKER_IMAGES`:

```text wrap theme={null}
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"
```

Yllä olevassa esimerkissä uudet projektit käyttävät oletuksena uutta `2023.1-custom`-imagea, kun taas `2023.1` on edelleen käytettävissä tarvittaessa.


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