Preguntas frecuentes y solución de problemas
Respuestas rápidas sobre los primeros pasos, los proyectos, la compilación, los asistentes y las copias de seguridad.
Primeros pasos
Sección titulada «Primeros pasos»¿Necesito una cuenta?
Sección titulada «¿Necesito una cuenta?»No. Descarga Oleafly, ábrelo y escribe. Los servicios opcionales, como un proveedor de IA en la nube, GitHub o Dropbox, usan sus propias cuentas.
¿Oleafly admite LaTeX, Typst y Markdown?
Sección titulada «¿Oleafly admite LaTeX, Typst y Markdown?»Sí. Elige el motor al crear un proyecto. Cada motor tiene sus propias capacidades de edición y exportación. El inicio rápido te guía por tu primer PDF.
¿Puedo traer un artículo o un currículum que ya tengo?
Sección titulada «¿Puedo traer un artículo o un currículum que ya tengo?»Sí. Importa el código de un proyecto, un archivo ZIP o un repositorio de Git. Oleafly también tiene rutas de conversión para DOCX y para PDF con texto. Lee Trae un proyecto existente para elegir la ruta adecuada.
¿Puedo trabajar sin conexión?
Sección titulada «¿Puedo trabajar sin conexión?»Puedes escribir, organizar archivos, usar la revisión de textos local y ejecutar un modelo de IA local descargado sin conexión a la nube. Tectonic puede compilar con los paquetes en caché. Los paquetes nuevos, las referencias remotas, los modelos en la nube, GitHub y las descargas necesitan conexión. Prepara un proyecto con una compilación correcta antes de llevártelo sin conexión.
¿Dónde están mis archivos?
Sección titulada «¿Dónde están mis archivos?»Tus proyectos son carpetas normales en tu biblioteca local. Puedes copiarlas, hacer copias de seguridad o abrirlas con otra herramienta. Dónde viven tus datos explica los archivos del proyecto, los ajustes de la app y los puntos de control.
¿Puedo usar Oleafly para una tesis o un currículum?
Sección titulada «¿Puedo usar Oleafly para una tesis o un currículum?»Sí. Empieza con el flujo de trabajo de tesis o el flujo de trabajo de currículum. Ambos usan el mismo editor, la misma vista previa y las mismas herramientas de referencias y exportación que un artículo de investigación.
Instalación
Sección titulada «Instalación»El sistema operativo bloquea el instalador
Sección titulada «El sistema operativo bloquea el instalador»Comprueba que el archivo proceda de las versiones oficiales (se abre en una pestaña nueva) y que coincida con tu plataforma. Sigue la guía de instalación para los pasos del primer inicio en tu plataforma.
¿Qué paquete de Linux debo usar?
Sección titulada «¿Qué paquete de Linux debo usar?»Elige la arquitectura que coincida con tu equipo y el AppImage, el paquete Debian o el RPM. Consulta Instalación en Linux para ver los requisitos del sistema.
Compilación
Sección titulada «Compilación»Mi primera compilación es lenta
Sección titulada «Mi primera compilación es lenta»Es posible que Tectonic tenga que descargar los paquetes que usa este documento, y la primera compilación en un equipo también descarga un lote de los más habituales. Se guardan en caché para las siguientes compilaciones. Mientras se siguen descargando paquetes, la compilación puede superar su límite habitual de cinco minutos. Abre los Registros para ver qué está pasando.
Falta un paquete
Sección titulada «Falta un paquete»Si el modo sin conexión está activado, elige Desactivar y compilar en el mensaje, o desactívalo durante una compilación para descargar el paquete. En una cadena de herramientas de TeX del sistema, usa Buscar e instalar en el error. El TeX Live de Debian, Ubuntu o Fedora recibe sus paquetes mediante apt o dnf. Consulta Motores y paquetes de LaTeX.
Elegí pdfLaTeX y Oleafly me pide una distribución de TeX
Sección titulada «Elegí pdfLaTeX y Oleafly me pide una distribución de TeX»pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX y pLaTeX se ejecutan en una distribución de TeX instalada en tu equipo. Cuando no hay ninguna, elegir cualquiera de ellos abre un diálogo antes de compilar nada. Elige Descargar y usar TinyTeX para instalar una, o Volver a Tectonic para regresar al motor incluido. Después de una compilación fallida, la vista previa ofrece la misma opción como Descargar y usar TinyTeX y Usar Tectonic. Consulta Cuando no hay TeX instalado.
MiKTeX dice que latexmk necesita Perl
Sección titulada «MiKTeX dice que latexmk necesita Perl»El latexmk de MiKTeX funciona con Perl, que MiKTeX no incluye. Instala Strawberry Perl, o instala TinyTeX desde Ajustes → Motores → LaTeX, que trae su propio Perl y se encarga de las compilaciones en lugar de MiKTeX. Consulta MiKTeX y Perl.
Falta texto en mi PDF
Sección titulada «Falta texto en mi PDF»La tipografía no tiene glifos para esos caracteres. Pasa sobre todo con texto en coreano, chino y japonés, y TeX omite los caracteres sin que falle la compilación. Oleafly te avisa y los enumera en el registro. En LaTeX, pega la configuración que da la advertencia para tu escritura. En Typst, descarga el paquete de tipografías que ofrece el aviso, o añade una tipografía que tenga los caracteres a la carpeta fonts del proyecto. En Markdown, pon mainfont o CJKmainfont en el encabezado YAML con una tipografía que los tenga. Consulta Caracteres que faltan en el PDF y Caracteres que se ven como cuadros.
Oleafly detuvo mi compilación por tardar demasiado
Sección titulada «Oleafly detuvo mi compilación por tardar demasiado»Una compilación puede durar 5 minutos. Mientras se siguen descargando paquetes, el límite se amplía hasta 30 minutos. Markdown a PDF tiene 15 minutos, y Quarto y Calepin tienen una hora. Compila otra vez: una descarga continúa donde se quedó. Para borradores largos con Tectonic, pon Modo de compilación en Rápida en el menú de compilación.
¿Pueden los proyectos nuevos usar mi propia instalación de TeX?
Sección titulada «¿Pueden los proyectos nuevos usar mi propia instalación de TeX?»Sí. Abre Ajustes → Motores → LaTeX y establece Motor de compilación predeterminado en latexmk (TeX del sistema). Los proyectos de LaTeX nuevos, importados y convertidos empiezan entonces con ese motor. Consulta Define un valor predeterminado para los proyectos nuevos.
Mi documento usa minted o PythonTeX
Sección titulada «Mi documento usa minted o PythonTeX»Estos paquetes ejecutan otros programas mientras el documento se compila, algo que Oleafly bloquea de forma predeterminada. Necesitan LaTeX del sistema. Si confías en todos los archivos del proyecto, elige Permitir comandos externos en el aviso que está sobre el editor. Consulta Permitir comandos externos.
La compilación terminó con advertencias
Sección titulada «La compilación terminó con advertencias»Abre los Registros y revisa primero las citas y referencias sin definir. Preflight ayuda a encontrar las ubicaciones del código afectadas antes de exportar.
No entiendo un error de compilación
Sección titulada «No entiendo un error de compilación»Pide al asistente que lea el registro, corrija el error y vuelva a compilar. Usa Pedir aprobación cuando quieras revisar las acciones propuestas por el camino. También puedes publicar el registro en el foro de ayuda de Discord.
¿Por qué falta un formato de exportación?
Sección titulada «¿Por qué falta un formato de exportación?»Los formatos disponibles dependen del motor y del tipo de documento. Consulta la tabla de exportación.
Asistentes de IA
Sección titulada «Asistentes de IA»¿Qué asistente puedo usar?
Sección titulada «¿Qué asistente puedo usar?»Conecta un proveedor de modelos, usa un modelo local o elige un agente de línea de comandos. Configura la IA cubre cada opción.
¿Necesito la IA para usar el editor?
Sección titulada «¿Necesito la IA para usar el editor?»No. Escribir, compilar, las citas, las vistas previas, los diagramas, el historial del proyecto y las exportaciones están disponibles sin un asistente.
¿Qué puede hacer el asistente?
Sección titulada «¿Qué puede hacer el asistente?»Puede trabajar con los archivos del proyecto, buscar fuentes, inspeccionar un PDF, crear figuras, ejecutar herramientas y ayudar a reparar una compilación. Elige un plan y una política de aprobación que se ajusten al trabajo. Consulta Chat y herramientas.
¿Qué significa Verificado junto a un modelo?
Sección titulada «¿Qué significa Verificado junto a un modelo?»El modelo superó una prueba de llamada a herramientas. Te ayuda a elegir un modelo para acciones sobre el proyecto; no evalúa la calidad de su redacción ni de su investigación. Consulta Configura la IA.
¿Por qué el uso aparece como Desconocido?
Sección titulada «¿Por qué el uso aparece como Desconocido?»Algunos proveedores y agentes de línea de comandos no informan del uso. Desconocido significa que el valor no está disponible. Lee Uso y presupuestos.
¿Puedo conectar un asistente externo?
Sección titulada «¿Puedo conectar un asistente externo?»Sí. Usa una conexión de agente de línea de comandos integrada, activa el servidor MCP local de Oleafly o conecta tu agente al comando oleafly, que también funciona con la app cerrada.
Historial y colaboración
Sección titulada «Historial y colaboración»¿Cómo recupero una versión anterior?
Sección titulada «¿Cómo recupero una versión anterior?»Abre los Puntos de control para comparar el código de compilaciones correctas y restaurar una versión. Usa el Control de versiones para los commits de Git que administras tú.
¿Puedo trabajar con un coautor?
Sección titulada «¿Puedo trabajar con un coautor?»Sí. Con la colaboración en tiempo real, puedes editar el mismo proyecto al mismo tiempo que tus coautores, mediante un servidor de colaboración que administra tu grupo. Cada persona conserva el proyecto como archivos en su propio equipo. También puedes compartir archivos comprimidos del código o usar la sincronización con GitHub para intercambiar commits.
¿Puedo usar mis proyectos en dos equipos?
Sección titulada «¿Puedo usar mis proyectos en dos equipos?»Sí. La sincronización en la nube guarda los proyectos de tu biblioteca y tus ajustes en tu propio Dropbox, y cada equipo que conectes puede descargarlos. Abre Ajustes → Almacenamiento de datos → Sincronización en la nube para conectarla. También puedes mover un proyecto entre equipos con la sincronización con GitHub.
¿Exportar el código hace una copia de seguridad de todo?
Sección titulada «¿Exportar el código hace una copia de seguridad de todo?»Hace una copia del código del proyecto. Los puntos de control automáticos, las preferencias de la app y las credenciales se guardan por separado. Sigue la guía de copias de seguridad para incluir lo que necesites.
Informar de un problema
Sección titulada «Informar de un problema»Abre Ajustes → Ayuda y Acerca de → Copiar la información e incluye esos datos junto con una descripción breve, los pasos para reproducir el problema y el registro pertinente. Infórmalo en Issues (se abre en una pestaña nueva); usa la comunidad de Discord para preguntas y ayuda con el flujo de trabajo.