Aggiornare TeX Live

Aggiorna TeX Live o installa pacchetti in un’installazione di Overleaf Community Edition.

Le istruzioni seguenti si applicano solo alle installazioni della Community Edition. Raccomandiamo vivamente agli utenti di Ayakaleaf Pro di abilitare le Sandboxed Compiles, poiché offrono agli utenti l’accesso a immagini TeX Live quasi identiche a quelle usate su overleaf.com e garantiscono l’isolamento tra le compilazioni dei progetti per una maggiore sicurezza.

Per risparmiare banda, sia l’immagine di Overleaf Community Edition sia quella di Ayakaleaf Pro includono solo un’installazione minima di TeX Live. Puoi installare altri pacchetti o passare a un’installazione completa di TeX Live usando il comando tlmgr nel container sharelatex.

​

Entrare nel container sharelatex

Per avviare una shell all’interno del container sharelatex, esegui

bin/shell

Otterrai un prompt simile a questo:

root@309b192d4030:/#

Nelle istruzioni seguenti presumeremo che tu sia all’interno del container.

​

Determinare la versione attuale di TeX Live

TeX Live viene rilasciato ogni anno intorno al mese di aprile. I passaggi per usare tlmgr sono diversi a seconda che tu stia usando la release corrente o una precedente. Puoi verificare quale versione di TeX Live stai usando con tlmgr --version. Ad esempio, questa installazione esegue 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

La release corrente di TeX Live è indicata sulla homepage di TeX Live.

Se stai usando una versione precedente di TeX Live, hai due opzioni. Una nuova versione dell’immagine Docker di Overleaf viene di solito rilasciata poco dopo una release di TeX Live: puoi attenderla e aggiornare la tua installazione con lo script bin/upgrade oppure, se preferisci mantenere la release di TeX Live precedente, dovrai prima indicare a tlmgr di usare un repository storico. Trovi le istruzioni per farlo qui.

​

Installare pacchetti

Per un’installazione completa di TeX Live, esegui questo comando all’interno del container sharelatex:

tlmgr install scheme-full

Puoi anche installare manualmente singoli pacchetti:

tlmgr install tikzlings tikzmarmots tikzducks

A partire dalla release 3.3.0, eseguire tlmgr path add è di nuovo obbligatorio dopo ogni utilizzo di tlmgr install, per creare correttamente i link simbolici di tutti i binari nel percorso di sistema.

Sono disponibili molti altri comandi. Scopri di più con:

tlmgr help

Quando hai finito, digita exit o premi Control-D per uscire dalla shell.

​

Salvare le modifiche

Le modifiche appena apportate hanno cambiato il container sharelatex, ma sono temporanee: andranno perse se Docker Compose ricrea il container, ad esempio durante l’aggiornamento della configurazione.

Per renderle persistenti, usa docker commit per salvare le modifiche in una nuova immagine Docker:

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

Dopo aver eseguito il commit delle modifiche, aggiorna di conseguenza config/version. Quindi esegui bin/up per ricreare il container sharelatex.

Dovrai ripetere questi passaggi ogni volta che esegui l’upgrade a una nuova versione di Overleaf.