# Paquetes

Busca paquetes de LaTeX en CTAN y paquetes de Typst en Typst Universe, y luego añade uno a tu documento desde la barra de herramientas del editor.

Los documentos de LaTeX y Typst obtienen la mayoría de sus funciones adicionales de los paquetes. El botón de paquetes, en el extremo derecho de la barra de herramientas del editor, abre una lista con búsqueda para el lenguaje del proyecto y escribe por ti la línea que carga un paquete. Los proyectos de Markdown no tienen botón de paquetes.

También puedes abrir la lista desde la paleta ⌘K con **Explorar los paquetes de LaTeX** o **Explorar los paquetes de Typst**.

## Paquetes de LaTeX

En un proyecto de LaTeX, elige **Paquetes de LaTeX**. Busca en CTAN por nombre o descripción del paquete. Si no se puede acceder a CTAN, o estás sin conexión, el diálogo lo indica y muestra en su lugar la lista integrada de Oleafly. Una lista que no se pudo actualizar muestra la fecha en que se descargó.

Cada fila puede mostrar estas etiquetas:

- **En el documento**: el archivo principal ya carga este paquete.
- **Clase de documento**: la entrada es una clase, no un paquete. Las clases se establecen con `\documentclass`, así que la fila te permite copiar esa línea pero no añadirla.
- **Instalado**: tu distribución de TeX ya tiene el paquete.

Cada fila también tiene estos controles:

- **Opciones**, un campo para las opciones del paquete como `margin=2cm`. Las llaves deben coincidir, y no se pueden usar `]` ni `%`.
- **Añadir al preámbulo**, que escribe `\usepackage[options]{name}` en el preámbulo del archivo principal. Si el archivo ya carga el paquete, no cambia nada y el diálogo te lo indica.
- **Copiar la línea**, que copia la misma línea `\usepackage`, o la línea `\documentclass` para una clase.
- **CTAN**, que abre la página del paquete en CTAN.
- **Instalar**, para un paquete que le falta a tu distribución de TeX. Consulta más abajo.

### Instalar paquetes de LaTeX

Lo que significa "instalado" depende de cómo compile el proyecto:

- **Tectonic**, el compilador integrado, descarga un paquete la primera vez que tu documento lo usa. No hay nada que instalar, y el diálogo lo dice en la parte superior.
- **latexmk con TeX Live o TinyTeX**: cuando tu distribución de TeX tiene `tlmgr`, Oleafly comprueba qué paquetes tienes, los marca como **Instalado** y ofrece **Instalar** para el resto. Instalar ejecuta `tlmgr` para ese único paquete.
- **TeX Live de Debian, Ubuntu o Fedora**: lo administra el gestor de paquetes del sistema, así que el diálogo indica que instales los paquetes con `apt` o `dnf` y no tiene botón **Instalar**.
- **Otras configuraciones de TeX**, como MiKTeX: Oleafly no puede saber qué paquetes hay, así que las filas no muestran estado de instalación. Usa MiKTeX Console para MiKTeX.

Con TeX Live o TinyTeX, una compilación que no encuentra un archivo ofrece **Buscar e instalar** en el error, que averigua a qué paquete pertenece el archivo. Consulta [Recupérate de un archivo que falta](/docs/latex-engines/#recover-from-a-missing-file).

Elige el compilador en la flecha junto a **Recompilar**. Consulta [Motores de LaTeX](/docs/latex-engines/).

## Paquetes de Typst

En un proyecto de Typst, elige **Paquetes de Typst** para explorar Typst Universe. Busca por nombre, palabra clave o categoría, o acota la lista con una etiqueta de categoría. El diálogo muestra hasta 100 paquetes a la vez, así que busca cuando la lista sea larga.

Cada fila muestra el nombre del paquete, su última versión, una insignia **Plantilla** para los paquetes de plantillas y una descripción breve. Cuando un paquete necesita un Typst más reciente que el que usa el proyecto, la fila indica qué versión necesita.

- **Insertar importación** añade `#import "@preview/name:version": *` después de las importaciones de la parte superior del archivo `.typ` abierto. Si el archivo ya importa ese paquete, solo cambia el número de versión. Tiene que haber un archivo de Typst abierto en el editor.
- **Copiar importación** copia la misma línea.

### Avisos de actualización

Cuando una importación `@preview` de tu archivo es anterior a la última versión de Typst Universe, el editor marca la versión con un aviso como "cetz 0.4.2 está disponible. Esta importación usa 0.3.4." La acción **Actualizar a 0.4.2** del aviso cambia el número en el mismo lugar.

### Conserva los paquetes con el proyecto

Typst descarga los paquetes en una caché compartida la primera vez que un proyecto los importa. Para que un proyecto lleve sus propias copias, usa **Paquetes del proyecto** en la parte inferior del diálogo:

- **Usar paquetes de la carpeta del proyecto** hace que Typst busque primero en la carpeta `typst-packages` del proyecto. Un proyecto configurado así compila sin conexión y en otros equipos.
- **Incorporar los paquetes al proyecto** copia en `typst-packages` todos los paquetes que el proyecto importa desde la caché. Si un paquete todavía no está en la caché, compila una vez con conexión y vuelve a incorporar.

Las dos opciones necesitan Typst 0.12 o posterior. En un proyecto fijado a Typst 0.11, la sección lo indica.

La sección también muestra cuántos paquetes contiene el proyecto.

### Sin conexión

Con el modo sin conexión activado, el diálogo usa la lista de paquetes que descargó la última vez y muestra su fecha. Si nunca se ha descargado una lista, no puede mostrar ninguna hasta que te conectes.

## Páginas relacionadas

- [El editor](/docs/editor/#the-editor-toolbar): el resto de la barra de herramientas del editor
- [Compilación](/docs/compiling/): cómo se descargan los paquetes durante una compilación
- [Ajustes del documento](/docs/document-settings/): tamaño de papel, márgenes y tipografías sin escribir código de paquetes
