> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Estendendo o TeX Live

> Estenda as imagens Docker do TeX Live com pacotes e fontes para os ambientes de compilação suportados.

É possível estender uma imagem existente do TeX Live usando um novo Dockerfile e configurar a aplicação para usar a nova imagem.

Aqui oferecemos algumas orientações para instalar novos pacotes ou fontes, mas a configuração de uma imagem personalizada não está coberta pelos nossos termos de suporte.

As imagens do TeX Live recebem atualizações pouco frequentes. Sugerimos reconstruir as imagens personalizadas ao atualizar o Server Pro.

<Danger>
  As seções a seguir se aplicam apenas ao Server Pro e aos [Sandboxed Compiles](/pt/on-premises/configuration/overleaf-toolkit/sandboxed-compiles).
</Danger>

### Instalando e atualizando novos pacotes

Você pode usar comandos do `tlmgr`, como `tlmgr install` e `tlmgr update`, para gerenciar pacotes do Tex Live, como no exemplo a seguir:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof
```

### Usando o `tlmgr` em uma imagem mais antiga do TeX Live

Por padrão, o `tlmgr` baixa recursos da versão mais recente do TeX Live. Ao corrigir uma imagem mais antiga do TeX Live, os downloads precisam ser direcionados para o arquivo histórico correspondente. Consulte a lista em [https://www.tug.org/historic/](https://www.tug.org/historic/) para ver os espelhos dos arquivos históricos.

```dockerfile theme={null}
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
```

### Instalando novas fontes

Existem diferentes procedimentos para instalar novas fontes em uma distribuição Tex Live, e a instalação de uma fonte personalizada pode exigir várias etapas. Consultar as [instruções para instalar fontes TeX](https://tug.org/fonts/fontinstall.html) na documentação oficial do Tex Live provavelmente é um bom ponto de partida.

O `Dockerfile` a seguir mostra um exemplo de instalação de uma fonte TrueType sobre uma imagem existente do Tex Live 2022:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# rebuild font information cache
RUN fc-cache
```

### Configurando o Server Pro para usar as novas imagens

Use o nome `ghcr.io/ayaka-notes/texlive-full` e uma tag personalizada para construir a nova imagem, como em:

```bash theme={null}
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```

Agora podemos configurar o Server Pro para usar a nova imagem `2023.1-custom` atualizando as variáveis de ambiente `TEX_LIVE_DOCKER_IMAGE` e `ALL_TEX_LIVE_DOCKER_IMAGES`:

```text wrap theme={null}
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"
```

No exemplo acima, os novos projetos são configurados por padrão para usar a nova imagem `2023.1-custom`, enquanto a `2023.1` continua disponível para quando for necessária.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.