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

Seuraavat osiot koskevat vain Server Prota ja hiekkalaatikoituja käännöksiä (Sandboxed Compiles).

​

Uusien pakettien asentaminen ja päivittäminen

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

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

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 ovat todennäköisesti hyvä lähtökohta.

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

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:

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:

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.