Uppgradera TeX Live

Uppgradera TeX Live eller installera paket i en driftsättning av Overleaf Community Edition.

Följande instruktioner gäller endast installationer av Community Edition. Vi rekommenderar starkt att våra Ayakaleaf Pro-användare aktiverar Sandboxed Compiles, eftersom det ger användarna tillgång till nästan samma TeX Live-avbilder som används på overleaf.com och dessutom isolerar projektkompileringar från varandra för ökad säkerhet.

För att spara bandbredd levereras både Overleaf Community Edition- och Ayakaleaf Pro-avbilderna endast med en minimal installation av TeX Live. Du kan installera fler paket eller uppgradera till en fullständig TeX Live-installation med kommandot tlmgr i containern sharelatex.

​

Komma in i sharelatex-containern

Kör följande för att starta ett skal i containern sharelatex:

bin/shell

Du får en prompt som ser ut så här:

root@309b192d4030:/#

I följande instruktioner antar vi att du befinner dig i containern.

​

Ta reda på din nuvarande TeX Live-version

TeX Live släpps varje år runt april. Stegen för att använda tlmgr skiljer sig åt beroende på om du använder den aktuella utgåvan eller en äldre. Du kan kontrollera vilken version av TeX Live du kör med tlmgr --version. Den här installationen kör till exempel TeX Live 2021:

# 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

Den aktuella utgåvan av TeX Live finns på TeX Lives webbplats.

Om du kör en äldre TeX Live-version har du två alternativ. En ny version av Overleafs Docker-avbild släpps vanligtvis kort efter en TeX Live-utgåva. Du kan antingen vänta på den och uppgradera din driftsättning med skriptet bin/upgrade, eller, om du föredrar att behålla den äldre TeX Live-utgåvan, först instruera tlmgr att använda ett historiskt repository. Instruktioner för detta hittar du här.

​

Installera paket

Kör det här kommandot i containern sharelatex för att installera en fullständig TeX Live-installation:

tlmgr install scheme-full

Du kan också installera enskilda paket manuellt:

tlmgr install tikzlings tikzmarmots tikzducks

Från och med version 3.3.0 är det återigen obligatoriskt att köra tlmgr path add efter varje användning av tlmgr install, för att alla binärfiler ska länkas korrekt till systemsökvägen.

Det finns många fler kommandon. Läs mer med:

tlmgr help

När du är klar skriver du exit eller trycker på Control-D för att lämna skalet.

​

Spara dina ändringar

Ändringarna du just gjort har modifierat containern sharelatex, men de är tillfälliga — de går förlorade om Docker Compose återskapar containern, till exempel när konfigurationen uppdateras.

För att göra dem beständiga använder du docker commit för att spara ändringarna i en ny Docker-avbild:

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

När du har sparat ändringarna uppdaterar du config/version i enlighet med detta. Kör sedan bin/up för att återskapa containern sharelatex.

Du måste upprepa dessa steg varje gång du uppgraderar till en ny version av Overleaf.