Atualizando o TeX Live

Atualize o TeX Live ou instale pacotes em uma implantação do Overleaf Community Edition.

As instruções a seguir se aplicam apenas a instalações do Community Edition. Recomendamos fortemente que nossos usuários do Ayakaleaf Pro ativem os Sandboxed Compiles, pois isso dá aos usuários acesso a imagens do TeX Live quase idênticas às usadas no overleaf.com, além de proporcionar isolamento entre as compilações dos projetos para maior segurança.

Para economizar largura de banda, tanto a imagem do Overleaf Community Edition quanto a do Ayakaleaf Pro vêm apenas com uma instalação mínima do TeX Live. Você pode instalar mais pacotes ou atualizar para uma instalação completa do TeX Live usando o comando tlmgr no contêiner sharelatex.

​

Entrando no contêiner sharelatex

Para iniciar um shell dentro do contêiner sharelatex, execute

bin/shell

Você verá um prompt parecido com este:

root@309b192d4030:/#

Nas instruções a seguir, vamos supor que você está dentro do contêiner.

​

Determinando sua versão atual do TeX Live

O TeX Live é lançado todos os anos por volta do mês de abril. Os passos para usar o tlmgr são diferentes dependendo de você estar usando a versão atual ou uma mais antiga. Você pode verificar qual versão do TeX Live está executando com tlmgr --version. Por exemplo, esta instalação executa o 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

A versão atual do TeX Live pode ser encontrada na página inicial do TeX Live.

Se você estiver executando uma versão mais antiga do TeX Live, há duas opções. Uma nova versão da imagem Docker do Overleaf geralmente é lançada pouco depois de um lançamento do TeX Live; você pode esperar por ela e atualizar sua implantação usando o script bin/upgrade ou, se preferir manter a versão mais antiga do TeX Live, primeiro precisará dizer ao tlmgr para usar um repositório histórico. Você encontrará instruções para isso aqui.

​

Instalando pacotes

Para obter uma instalação completa do TeX Live, execute este comando dentro do contêiner sharelatex:

tlmgr install scheme-full

Você também pode instalar pacotes individuais manualmente:

tlmgr install tikzlings tikzmarmots tikzducks

A partir da versão 3.3.0, executar tlmgr path add é novamente obrigatório após cada uso de tlmgr install, para criar corretamente os links simbólicos de todos os binários no path do sistema.

Há muitos outros comandos disponíveis. Saiba mais com:

tlmgr help

Quando terminar, digite exit ou pressione Control-D para sair do shell.

​

Salvando suas alterações

As alterações que você acabou de fazer modificaram o contêiner sharelatex, mas são efêmeras — serão perdidas se o Docker Compose recriar o contêiner, por exemplo, ao atualizar a configuração.

Para torná-las persistentes, use docker commit para salvar as alterações em uma nova imagem 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

Depois de fazer o commit das alterações, atualize o config/version de acordo. Em seguida, execute bin/up para recriar o contêiner sharelatex.

Você precisará repetir esses passos sempre que atualizar para uma nova versão do Overleaf.