> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/es/mantenimiento/extending-tex-live.md).

# Ampliar TeX Live

Es posible ampliar una imagen TeX Live existente usando un nuevo Dockerfile y configurar la aplicación para que use la nueva imagen.

Aquí ofrecemos algunas pautas para instalar nuevos paquetes o fuentes, pero la configuración de una imagen personalizada no está cubierta por nuestros términos de soporte.

Las imágenes de TeX Live reciben actualizaciones poco frecuentes. Sugerimos reconstruir las imágenes personalizadas al actualizar Server Pro.

{% hint style="danger" %}
Las siguientes secciones se aplican a Server Pro y [Compilaciones en entorno aislado](broken://pages/55dfd7b687852d0acf6195e9d8b9f6decf2eafde) solo.
{% endhint %}

### Instalación y actualización de nuevos paquetes

Puede usar `tlmgr` comandos como `tlmgr install` y `tlmgr update` para gestionar paquetes de Tex Live como en el siguiente ejemplo:

```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof
```

### Usando `tlmgr` en una imagen antigua de TeX Live

De forma predeterminada `tlmgr` descarga recursos de la versión más reciente de TeX Live. Al aplicar parches a una imagen antigua de TeX Live, las descargas deben cambiarse al archivo correspondiente. Consulte la lista en <https://www.tug.org/historic/> para ver espejos de archivos.

```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# p. ej., RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

RUN tlmgr update --force ebproof
```

### Instalación de nuevas fuentes

Existen distintos procedimientos para instalar nuevas fuentes en una distribución de Tex Live, e instalar una fuente personalizada puede requerir varios pasos. Consultar las [instrucciones para instalar fuentes de TeX](https://tug.org/fonts/fontinstall.html) en la documentación oficial de Tex Live probablemente sea un buen punto de partida.

El siguiente `Dockerfile` muestra un ejemplo de instalación de una fuente TrueType sobre una imagen existente de Tex Live 2022:

```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

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

# reconstruir la caché de información de fuentes
RUN fc-cache
```

### Configuración de Server Pro para usar las nuevas imágenes

Use el nombre `ghcr.io/ayaka-notes/texlive-full` y una etiqueta personalizada para construir la nueva imagen, como en:

```bash
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```

Ahora podemos configurar Server Pro para usar la nueva `2023.1-custom` imagen actualizando las `TEX_LIVE_DOCKER_IMAGE` y `ALL_TEX_LIVE_DOCKER_IMAGES` variables de entorno:

{% code overflow="wrap" %}

```
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"
```

{% endcode %}

En el ejemplo anterior, los nuevos proyectos se configuran de forma predeterminada para usar la nueva `2023.1-custom` imagen, mientras que `2023.1` sigue disponible cuando se necesita.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/es/mantenimiento/extending-tex-live.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
