# Motores y paquetes de LaTeX

Elige Tectonic o un compilador latexmk, usa una distribución de TeX existente o instala el TinyTeX administrado de Oleafly.

Oleafly incluye Tectonic y también puede compilar mediante `latexmk`. El menú de compilador del proyecto controla las compilaciones del día a día. **Ajustes → Motores** muestra las distribuciones de TeX y los paquetes disponibles en tu equipo.

## Tectonic: el motor de todos los días

**Tectonic** es el motor de compilación predeterminado hasta que elijas otro en **Motor de compilación predeterminado**, dentro de **Ajustes → Motores → LaTeX**. No necesita una instalación aparte, descarga los paquetes a medida que hacen falta y los guarda en caché para usarlos sin conexión. Es una buena opción para la mayoría de los proyectos y sigue disponible aunque no haya ninguna distribución de TeX en el sistema. Consulta [Define un valor predeterminado para los proyectos nuevos](/docs/engines/#set-a-default-for-new-projects).

Para los **PDF etiquetados**, usa el flujo de trabajo con LuaLaTeX. Las etiquetas describen la estructura del documento para las tecnologías de apoyo. Inspecciona el resultado con Preflight después de compilar.

### Tipografías en el motor incluido

Tectonic se basa en XeTeX, que lee los archivos de tipografía directamente. Oleafly ajusta algunas cosas para que los documentos escritos para pdfLaTeX conserven sus tipografías y su texto:

- Times, Helvetica, Courier, Palatino, Bookman, New Century Schoolbook y Avant Garde usan sus versiones de TeX Gyre en lugar de recurrir a Latin Modern.
- `\usepackage[T1]{fontenc}` rompe los acentos y los símbolos escritos en este motor, así que Oleafly mantiene el documento en texto Unicode. Si una tipografía que usa el documento solo existe en T1, el documento se queda en T1 y la compilación avisa de que caracteres como ß, §, «, las comillas tipográficas y € pueden imprimirse mal o desaparecer. El aviso da una versión de la línea que carga T1 solo con pdfLaTeX:

  ```latex
  \usepackage{iftex}
  \ifPDFTeX
    \usepackage[T1]{fontenc}
  \fi
  ```

- Un documento que establece `\pdfoutput=1`, como pide arXiv, se compila tal cual.
- Un documento `ctex` que no establece `fontset` recibe las tipografías Fandol, así que se ve igual en todos los equipos. Añade `fontset=mac` a las opciones de la clase para usar las tipografías propias del Mac.
- Las tipografías que vienen con el motor incluido se encuentran por el nombre del archivo. `\setmainfont{UnBatang}` falla, y el error te dice que escribas `UnBatang.ttf`.

El modo sin conexión omite los ajustes de tipografías y de codificación, así que una compilación sin conexión de un documento así puede verse distinta de una con conexión.

## latexmk y TeX del sistema

Elige pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX o pLaTeX en el menú de compilador de un proyecto cuando este dependa de un flujo de trabajo tradicional de TeX Live o MiKTeX. Oleafly ejecuta esos compiladores mediante `latexmk`. **Automático** lee el archivo principal y elige uno: gana una línea `% !TeX program = xelatex` al principio, luego las clases japonesas, luego los paquetes que necesitan XeLaTeX o LuaLaTeX, como `fontspec`, `ctex`, `xeCJK` o `luatexko`. Si el archivo principal no lo resuelve, Automático también revisa un `latexmkrc` del proyecto y los archivos que carga el preámbulo. Todo lo demás usa pdfLaTeX. Si un paquete necesita un compilador distinto del que eligió Automático, la compilación ofrece cambiar, por ejemplo con **Usar XeLaTeX**.

Hay dos formas de proporcionar esa cadena de herramientas:

1. **Usar una instalación existente.** Oleafly detecta MacTeX, TeX Live, MiKTeX y TinyTeX en tu sistema. Busca en el mismo `PATH` que usa tu terminal y, en Windows, también en los ajustes `Path` del sistema y del usuario, así que encuentra un TeX instalado a mano aunque la app se haya abierto desde el Dock o el menú Inicio. Una instalación del sistema tiene prioridad sobre la copia administrada de Oleafly solo cuando su directorio de binarios contiene `latexmk`, pdfLaTeX, XeLaTeX, LuaLaTeX, `kpsewhich` y Biber. Una instalación parcial no puede superar en silencio a un TinyTeX administrado que funciona.
2. **Instalar TinyTeX administrado.** La descarga es de unos 250 MB y no necesita acceso de administrador. Consulta [Instala y actualiza TinyTeX](#install-and-update-tinytex).

**Gestionar las distribuciones de TeX**, en **Ajustes → Motores → LaTeX**, muestra cada distribución que encontró Oleafly. **En uso** marca la que `latexmk` usa para compilar, y una insignia **latexmk** marca cada una que puede compilar. Elige **Usar para compilar** en otra fila para cambiar a ella. La fila que elegiste muestra entonces **Automático**, que deja que Oleafly vuelva a elegir: primero un TeX del sistema completo y después TinyTeX.

Si TeX está instalado en una carpeta donde Oleafly no busca, haz clic en **Elegir una carpeta de TeX** y selecciona la carpeta que contiene `latexmk`, o la carpeta del año de TeX Live que está por encima, como `texlive/2026`. Oleafly encuentra `latexmk` dentro y compila con esa instalación, que la lista marca como **En uso**. **Automático** deshace la elección. Si la carpeta no tiene `latexmk`, el mensaje indica qué carpeta elegir en su lugar.

`latexmk` no es un entorno aislado del sistema de archivos. Incluso con los comandos de shell bloqueados, TeX puede leer los archivos a los que llega tu cuenta. Oleafly también desactiva los archivos `.latexmkrc` del proyecto, del usuario y del sistema, porque son Perl ejecutable. Usa el TeX del sistema solo con proyectos de confianza. Un proyecto importado usa el TeX del sistema solo cuando lo eliges, ya sea como motor de compilación predeterminado o desde el menú de compilador del proyecto. Una carpeta que abres en su ubicación se queda con Tectonic hasta que confíes en ella.

### Cuando no hay TeX instalado

Elegir pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX o Automático en un equipo sin una distribución de TeX que funcione abre un diálogo titulado **Este compilador necesita una distribución de TeX que funcione**. Muestra tres opciones, en este orden:

- **Descargar TinyTeX**, marcada como **Recomendado**. **Descargar y usar TinyTeX** instala TinyTeX y compila el proyecto con él.
- **Usar el LaTeX de mi sistema (latexmk)**, que indica que no se encontró ninguna distribución de TeX, o por qué la de este equipo no puede compilar. No tiene botón.
- **Seguir usando Tectonic**. **Volver a Tectonic** devuelve el proyecto al motor incluido.

Si compilas primero, la vista previa ofrece la misma salida: **Descargar y usar TinyTeX**, **Usar Tectonic** y **Abrir los ajustes del motor**. Una compilación que inicias mientras TinyTeX todavía se descarga espera y empieza sola cuando termina la instalación.

La misma oferta aparece cuando hay una distribución de TeX pero no tiene `latexmk`. Cuando a la distribución le falta `latexmk`, el compilador elegido o Biber, el mensaje también indica qué instalar si Oleafly conoce la distribución, como `sudo tlmgr install latexmk` en MacTeX o `sudo apt install latexmk` en Ubuntu.

En un proyecto compartido, el botón dice **Usar Tectonic para todos**, porque el compilador se guarda en el proyecto y cambia para todos los colaboradores. Instalar TinyTeX solo cambia tu equipo.

### Instala y actualiza TinyTeX

Abre **Ajustes → Motores → LaTeX** y elige **Descargar TinyTeX (~250 MB)** en **Gestionar las distribuciones de TeX**, o usa la oferta del diálogo de compilación. TinyTeX es un TeX Live compacto que no necesita permisos de administrador. Las plantillas de revista pueden añadir paquetes después, hasta unos 1 GB en total, y Oleafly comprueba que haya unos 2 GB de espacio libre en disco antes de empezar. TinyTeX se instala en `~/.oleafly/tinytex`.

- **Cancelar** detiene la descarga y conserva lo que ya llegó. El botón pasa entonces a decir **Reanudar la descarga** con la cantidad ya descargada. Cerrar Oleafly durante la instalación la pausa del mismo modo, y continúa la próxima vez que abras la app.
- La descarga llega primero del espejo de Oleafly y después de GitHub. Si una fuente falla, o deja de enviar datos durante un minuto, Oleafly pasa a la siguiente y continúa donde se quedó. **Ajustes → Descargas → Orígenes** cambia de dónde vienen las descargas. Consulta [Pestaña Orígenes](/docs/settings/downloads/#sources-tab).
- Cuando el TinyTeX administrado es más antiguo que la versión que espera esta versión de Oleafly, su fila muestra **Actualizar**. **Quitar** lo elimina.

Si ya hay otra distribución **En uso**, instalar TinyTeX no cambia la distribución en uso. Elige **Usar para compilar** en la fila de TinyTeX cuando quieras que compile con ella.

En Linux, TinyTeX usa el Perl del sistema. Oleafly comprueba que haya Perl antes de descargar nada. Si falta Perl o alguno de sus módulos estándar, el mensaje da el comando para instalarlo: `sudo apt install perl`, `sudo dnf install perl` o `sudo pacman -S perl`.

En Windows, TeX Live no puede ejecutarse desde una carpeta cuyo nombre tenga letras con acento o no latinas. Si tu carpeta de usuario tiene un nombre así, Oleafly pone TinyTeX en una carpeta dentro de ProgramData. Si el antivirus mantiene abierto un archivo mientras TinyTeX se coloca en su sitio, Oleafly lo intenta de nuevo, y si aun así no puede terminar, espera un momento y reintenta la instalación.

### MiKTeX y Perl

El `latexmk` de MiKTeX es un script de Perl, y MiKTeX no incluye Perl. Sin Perl, Ajustes marca MiKTeX con **latexmk necesita Perl**, y Oleafly compila con TinyTeX en su lugar cuando está instalado. Si no hay nada más que usar, la compilación se detiene y te da tres salidas: instalar TinyTeX desde **Ajustes → Motores → LaTeX**, que trae su propio Perl, instalar Strawberry Perl, o volver a poner el proyecto en Tectonic.

MiKTeX gestiona sus paquetes en MiKTeX Console, así que la lista **Paquetes** y **Buscar e instalar** no se aplican a él. MiKTeX tampoco convierte las figuras EPS mientras compila, así que conviértelas antes a PDF o usa TinyTeX.

### Documentos en japonés: upLaTeX y pLaTeX

Elige **upLaTeX** o **pLaTeX** en **Compilador (este proyecto)** para un documento en japonés, o deja el compilador en **Automático**. Automático elige pLaTeX para `jsarticle`, `jsbook` y `jsreport` (upLaTeX cuando la clase tiene la opción `uplatex`), upLaTeX para las clases `uj` y `jlreq`, y LuaLaTeX para `ltjsarticle` y otros documentos de LuaTeX-ja.

Los dos compiladores necesitan el soporte de japonés de TeX Live. Cuando falta en el TinyTeX administrado, o en un TeX Live en el que Oleafly puede escribir, la compilación fallida ofrece **Instalar el soporte para japonés (unos 450 MB)**. Eso lo instala y vuelve a compilar. En otras instalaciones el mensaje indica el comando para tu distribución, como `sudo apt install texlive-lang-japanese`.

## Cuando Tectonic no basta

Algunos documentos necesitan cosas que el motor Tectonic incluido no hace, como figuras EPS o un controlador `pdftex` forzado. Cuando la primera compilación tras abrir un proyecto, o una compilación que inicias tú, se topa con una de ellas, el diálogo del motor se abre solo. Cuando la compilación la inicia la compilación automática o un agente, el diálogo se queda cerrado y aparece en su lugar **Elegir motor**. Elígelo para abrir el diálogo. El botón se queda hasta la siguiente compilación, así que también vuelve a abrir el diálogo después de cerrarlo. Dónde lo encuentras depende de la vista:

- Después de una compilación fallida, está a la derecha de la barra de herramientas de la vista previa mientras **Registros** está abierto. La vista previa cambia sola a **Registros** cuando la compilación no generó ningún PDF. Si todavía se ve un PDF, elige **Registros** para ver el botón.
- En una vista previa vacía, está junto a **Volver a compilar**.
- En la vista solo de editor, cuando el PDF está en su propia ventana, o después de una compilación correcta, está a la izquierda de **Recompilar**.

El diálogo se titula **Esta compilación necesita más que el motor incluido** y lista los problemas que encontró. La opción marcada como **Recomendado** va primero:

- **Descargar TinyTeX** aparece cuando no hay ninguna distribución de TeX que funcione instalada. Su botón, **Descargar y usar TinyTeX**, instala TinyTeX, cambia el proyecto a `latexmk` y vuelve a compilar.
- **Usar el LaTeX de mi sistema (latexmk)** tiene **Usar el LaTeX del sistema**, que cambia el proyecto a `latexmk` con la distribución de TeX que encontró Oleafly. Si el documento necesita pdfLaTeX, la opción dice **Usar pdfLaTeX con el LaTeX de mi sistema (latexmk)** y su botón dice **Cambiar a pdfLaTeX y recompilar**. Sin ningún TeX instalado, esta opción no tiene botón.
- **Seguir usando Tectonic** tiene **Seguir con Tectonic**, que deja el proyecto en el motor incluido. Cuando un cambio solucionaría los problemas que lista el diálogo, esta opción dice que no desaparecerán.

Después de que sigas con Tectonic, los mismos problemas ya no abren el diálogo ni muestran **Elegir motor** en este proyecto en este equipo. Para cambiar más tarde, elige un compilador en **Compilador (este proyecto)**.

Si el proyecto también necesita ejecutar comandos externos, cambiar al LaTeX del sistema o a TinyTeX también los permite, y el diálogo lo indica antes de que hagas clic. El compilador que eliges se guarda en el proyecto, así que los colaboradores obtienen la misma configuración.

## Permitir comandos externos

Paquetes como `minted` y PythonTeX, y los documentos que usan `\write18`, ejecutan otros programas mientras se compilan. Oleafly lo bloquea de forma predeterminada. Cuando una compilación se bloquea, o el registro muestra que el proyecto necesita esos comandos, un aviso sobre el editor ofrece **Permitir comandos externos**.

El motor incluido mantiene también ese bloqueo. Tectonic se inicia fuera de la carpeta del proyecto, y el Biber que viene con Oleafly trata la configuración de bibliografía de un documento como texto sin formato y omite `biber.conf` durante una compilación.

Permite los comandos externos solo para un proyecto cuyos archivos te merezcan confianza, porque entonces LaTeX puede ejecutar cualquier programa con tus permisos. El permiso solo funciona con el LaTeX del sistema y se queda en este equipo. Nunca se guarda en `project.json` ni se confirma en Git, así que un coautor tiene que permitirlo en su propio equipo. En un [proyecto compartido](/docs/collaboration/), Oleafly te avisa antes de activarlo, porque cualquier persona que pueda editar el proyecto podría entonces ejecutar programas en tu equipo cuando compilas. Volver a cambiar el proyecto a Tectonic o eliminarlo quita el permiso. En una carpeta que abriste en su ubicación, primero confía en la carpeta. Confiar en una carpeta no permite por sí solo los comandos externos.

Con un motor presente, el botón **Compilar con etiquetado y verificar** del panel de [Preflight](/docs/preflight/) puede producir un PDF etiquetado con LuaLaTeX y auditarlo de inmediato, en un solo paso. ¿Prefieres tu propia cadena de herramientas? **Preparar para la exportación accesible**, de Preflight, reescribe tu código para el etiquetado y lo compilas con cualquier LuaLaTeX de TeX Live 2026, o de un TeX Live actualizado desde noviembre de 2025, fuera de la app.

## Caracteres que faltan en el PDF

TeX omite cualquier carácter para el que su tipografía no tiene glifo, y la compilación termina con éxito de todos modos. Un párrafo en coreano, chino o japonés puede salir en blanco sin ningún error. Oleafly lee el registro después de cada compilación, así que cuando faltan caracteres recibes un aviso una vez por proyecto, el registro los enumera en **Caracteres que faltan** y la advertencia nombra algunos.

En el motor incluido y en XeLaTeX, la advertencia también da una configuración para cada escritura que encontró, con tipografías que vienen con el motor incluido. Pega en el preámbulo la que necesites:

```latex
% Korean
\usepackage[space]{xeCJK}
\setCJKmainfont[AutoFakeBold]{UnBatang.ttf}

% Simplified Chinese
\usepackage{xeCJK}
\setCJKmainfont[AutoFakeBold]{gbsn00lp.ttf}

% Traditional Chinese
\usepackage{xeCJK}
\setCJKmainfont[AutoFakeBold]{bsmi00lp.ttf}

% Japanese
\usepackage{xeCJK}
\setCJKmainfont{ipaexm.ttf}[BoldFont=ipaexg.ttf]
```

La opción `space` conserva los espacios entre las palabras coreanas, que `xeCJK` a secas elimina.

`CJKutf8` y el paquete `CJK` solo funcionan con pdfLaTeX. Un proyecto que los carga en el motor incluido se compila sin su texto en chino, japonés o coreano, así que el aviso ofrece **Elegir motor**, que abre el cambio a pdfLaTeX. También puedes quitar el paquete y su entorno `CJK` y usar una de las configuraciones anteriores.

Un documento `ctex` en un Mac que usa las tipografías propias del Mac puede hacer que macOS pregunte si quieres descargar una tipografía, y la compilación espera tu respuesta. Responde al diálogo y compila otra vez, o añade `fontset=fandol` a las opciones de `\documentclass`.

Otros caracteres que faltan, como un símbolo o una letra de otra escritura, necesitan una tipografía que los tenga. Cambia a una en el preámbulo. Para los proyectos de Typst, consulta [Caracteres que se ven como cuadros](/docs/typst/#characters-that-show-as-boxes).

## El administrador de paquetes

Debajo del estado del motor hay una lista de **Paquetes** con filtro para el lado de LuaLaTeX, que funciona con `tlmgr`:

- Empieza con la lista de paquetes sugeridos, o escribe al menos dos caracteres y elige **Buscar en TeX Live** para consultar el catálogo completo.
- Busca por el nombre de un paquete o por un archivo que contiene. Oleafly muestra el paquete de TeX Live al que pertenece cuando los nombres difieren.
- **Añadir** o **Quitar** un paquete con un clic. Las filas instaladas indican si el paquete está en el árbol del sistema, en tu árbol personal o en ambos.
- Revisa la insignia de etiquetado antes de una exportación accesible: **etiquetado: con cuidado** marca los paquetes que pueden reducir la calidad de las etiquetas, mientras que **rompe el etiquetado** marca conflictos conocidos.

Este administrador de paquetes se aplica a las distribuciones TeX Live y TinyTeX que usa `latexmk`. Tectonic administra su propia caché de paquetes. Para MiKTeX, usa MiKTeX Console.

### Recupérate de un archivo que falta

Un paquete no siempre se llama como el archivo que menciona un registro de compilación. Por ejemplo, `tikz.sty` lo instala el paquete `pgf`. Instalar un paquete adivinado llamado `tikz` fallaría.

Cuando una compilación con `latexmk` informa de que falta un archivo, usa **Buscar e instalar** en el mensaje. Eso cubre paquetes, clases, estilos de bibliografía, archivos de tipografía, archivos de idioma de babel y bibliotecas de TikZ. Oleafly pregunta a TeX Live qué paquete contiene el archivo, instala ese paquete y recompila. Si ningún paquete de TeX Live tiene el archivo, lo más probable es que venga con la plantilla de tu universidad o de la editorial, así que añádelo al proyecto desde la plantilla original. Si varios paquetes lo tienen, el mensaje los enumera para que elijas el que necesita tu plantilla. Si no se puede acceder al catálogo, o la instalación no arregla la compilación, el mensaje lo indica.

Si intentas modificar una instalación del sistema sin permiso, Oleafly puede instalar en tu árbol de TeX personal, y antes prepara ese árbol si todavía no existe. La fila del paquete indica dónde terminó. Quitar un paquete propietario también quita los demás archivos que proporciona, así que lee la nota **Incluido en** antes de quitarlo.

### Mantén en funcionamiento tlmgr y las versiones antiguas de TeX Live

`tlmgr`, el administrador de paquetes de TeX Live, puede quedar por detrás del repositorio en línea de TeX Live, y entonces se niega a instalar nada hasta que se actualiza a sí mismo. En el TinyTeX que administra Oleafly, Oleafly actualiza `tlmgr` y repite la instalación. En un TeX Live o TinyTeX que instalaste tú, el mensaje te indica que ejecutes `tlmgr update --self`.

Cuando el repositorio pasa a un año nuevo de TeX Live, una instalación más antigua ya no puede instalar desde él. Entonces Oleafly instala desde el archivo final de tu versión. Si el archivo tampoco tiene el paquete, el mensaje te pide que actualices TeX Live, o que uses **Actualizar** en el TinyTeX administrado, en Ajustes.

### Elige de dónde vienen los paquetes

`tlmgr` instala paquetes desde un repositorio de TeX Live. El TinyTeX que administra Oleafly usa el espejo de CTAN más cercano, salvo que elijas un repositorio concreto, como el espejo de CTAN de tu universidad, en **Repositorio de paquetes de TeX** dentro de **Ajustes → Descargas → Orígenes**. Un TeX Live que instalaste tú conserva su propio repositorio salvo que escribas allí una dirección. Oleafly pasa la dirección a `tlmgr` en cada ejecución y nunca cambia su configuración guardada.

Una búsqueda de paquetes que tenga que llegar al repositorio puede tardar un rato con una conexión lenta. Oleafly espera hasta 10 minutos y, si desiste, el mensaje nombra el repositorio que esperaba. Consulta [Pestaña Orígenes](/docs/settings/downloads/#sources-tab).

### TeX Live de una distribución de Linux

En Debian, Ubuntu y Fedora, TeX Live viene del gestor de paquetes del sistema, así que Oleafly no le añade paquetes. La lista **Paquetes** indica que uses `apt` o `dnf`, y un archivo que falta recibe un aviso con una pista en lugar de **Buscar e instalar**:

- En Debian y Ubuntu, encuentra el paquete con `apt-file search` y el nombre del archivo, o instala todo con `sudo apt install texlive-full`.
- En Fedora, el aviso da un comando `sudo dnf install 'tex(file.sty)'` para el archivo que falta.

Cuando el TeX de la distribución está incompleto, el aviso también ofrece **Descargar TinyTeX (~250 MB)**, para el que Oleafly sí puede administrar paquetes. En Debian y Ubuntu, si configuraste un árbol personal con `tlmgr init-usertree`, Oleafly instala los paquetes en ese árbol.

## Añade un paquete desde el editor

Elige **Paquetes de LaTeX**, el icono de paquete de la barra de herramientas del editor de LaTeX, para buscar en CTAN sin salir del documento. Cada resultado indica si el documento ya lo carga (**En el documento**). En un proyecto con `latexmk` también indica si tu distribución de TeX lo tiene (**Instalado**), y **Instalar** añade uno que falte con `tlmgr`. Con el TeX Live de una distribución de Linux, el diálogo te indica que instales los paquetes con `apt` o `dnf`.

**Añadir al preámbulo** escribe la línea `\usepackage` en el preámbulo. **Opciones** te permite añadir antes opciones del paquete, y **Copiar la línea** copia la línea en su lugar. Un proyecto con Tectonic no tiene nada que instalar: Tectonic descarga un paquete la primera vez que el documento lo usa.

## ¿Qué motor compiló mi PDF?

- **Compilador (este proyecto)**, en el menú de compilación, la flecha junto a **Recompilar**, muestra el compilador guardado para el proyecto actual.
- Las compilaciones con Tectonic usan el motor incluido.
- Las compilaciones con pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX y pLaTeX usan `latexmk` y la distribución de TeX marcada como **En uso** en Ajustes.
- La exportación etiquetada de Preflight usa LuaLaTeX y escribe en la ubicación de compilación normal.

## Plantillas y paquetes

Las plantillas declaran los paquetes que necesitan, y Tectonic los descarga en la primera compilación. Las plantillas con tipografías a demanda las gestionan por separado. Consulta [Plantillas](/docs/templates/#on-demand-fonts-the-setup-badge).
