TeX Liven päivittäminen

Päivitä TeX Live tai asenna paketteja Overleaf Community Edition -käyttöönotossa.

Seuraavat ohjeet koskevat vain Community Edition -asennuksia. Suosittelemme vahvasti, että Ayakaleaf Pro -käyttäjämme ottavat käyttöön hiekkalaatikoidut käännökset (Sandboxed Compiles), koska ne antavat käyttäjille pääsyn lähes samoihin TeX Live -imageihin, joita käytetään overleaf.com-palvelussa, ja eristävät projektien käännökset toisistaan tietoturvan parantamiseksi.

Kaistanleveyden säästämiseksi sekä Overleaf Community Edition- että Ayakaleaf Pro -imageissa on vain TeX Liven minimaalinen asennus. Voit asentaa lisää paketteja tai päivittää täydelliseen TeX Live -asennukseen käyttämällä tlmgr-komentoa sharelatex-kontissa.

​

Pääsy sharelatex-kontin sisälle

Käynnistä komentotulkki sharelatex-kontin sisällä suorittamalla

bin/shell

Saat kehotteen, joka näyttää tältä:

root@309b192d4030:/#

Seuraavissa ohjeissa oletamme, että olet kontin sisällä.

​

Nykyisen TeX Live -version selvittäminen

TeX Live julkaistaan joka vuosi huhtikuun tienoilla. tlmgr:n käyttövaiheet vaihtelevat sen mukaan, käytätkö nykyistä vai vanhempaa julkaisua. Voit tarkistaa käyttämäsi TeX Live -version komennolla tlmgr --version. Esimerkiksi tämä asennus käyttää TeX Live 2021:tä:

# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021

TeX Liven nykyinen julkaisu löytyy TeX Liven kotisivulta.

Jos käytät vanhempaa TeX Live -versiota, sinulla on kaksi vaihtoehtoa. Overleafin Docker-imagesta julkaistaan yleensä uusi versio pian TeX Live -julkaisun jälkeen. Voit joko odottaa sitä ja päivittää käyttöönottosi bin/upgrade-skriptillä, tai jos haluat pitää vanhemman TeX Live -julkaisun, sinun on ensin määritettävä tlmgr käyttämään historiallista repositoriota. Ohjeet tähän löydät täältä.

​

Pakettien asentaminen

Asenna täydellinen TeX Live -asennus suorittamalla tämä komento sharelatex-kontin sisällä:

tlmgr install scheme-full

Voit myös asentaa yksittäisiä paketteja manuaalisesti:

tlmgr install tikzlings tikzmarmots tikzducks

Julkaisusta 3.3.0 alkaen tlmgr path add on taas pakko suorittaa jokaisen tlmgr install -käyttökerran jälkeen, jotta kaikki binäärit linkitetään symbolisesti oikein järjestelmäpolkuun.

Komentoja on saatavilla paljon enemmän. Lisätietoja saat komennolla:

tlmgr help

Kun olet valmis, kirjoita exit tai paina Control-D poistuaksesi komentotulkista.

​

Muutosten tallentaminen

Juuri tekemäsi muutokset ovat muuttaneet sharelatex-konttia, mutta ne ovat väliaikaisia — ne menetetään, jos Docker Compose luo kontin uudelleen, esimerkiksi konfiguraation päivittämisen yhteydessä.

Tehdäksesi niistä pysyviä tallenna muutokset uuteen Docker-imageen komennolla docker commit:

cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version

Kun olet tallentanut muutokset, päivitä config/version vastaavasti. Suorita sitten bin/up luodaksesi sharelatex-kontin uudelleen.

Sinun on toistettava nämä vaiheet aina, kun päivität uuteen Overleaf-versioon.