Ir al contenido
Oleaflyv0.4.12

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 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.

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.

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:

    \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.

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.

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.

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.

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.
  • 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.

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.

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.

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.

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, 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 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.

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:

% 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.

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.

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

Sección titulada «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.

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.

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.

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.

  • 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.

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.

Vista previa de la imagen

No se pudieron cargar las respuestas de la IA

Inténtalo de nuevo o busca en la documentación.