# 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

### ¿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?

Sí. Elige el motor al crear un proyecto. Cada motor tiene sus propias capacidades de edición y exportación. El [inicio rápido](/docs/getting-started/) te guía por tu primer PDF.

### ¿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](/docs/import-project/) para elegir la ruta adecuada.

### ¿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?

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](/docs/where-your-data-lives/) 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?

Sí. Empieza con el [flujo de trabajo de tesis](/docs/workflows/thesis/) o el [flujo de trabajo de currículum](/docs/workflows/resume/). 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

### El sistema operativo bloquea el instalador

Comprueba que el archivo proceda de las [versiones oficiales](https://github.com/Oleafly/Oleafly/releases/latest) y que coincida con tu plataforma. Sigue la [guía de instalación](/docs/install/#first-launch) para los pasos del primer inicio en tu plataforma.

### ¿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](/docs/install/#linux) para ver los requisitos del sistema.

## Compilación

### 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](/docs/compiling/#reading-the-logs) para ver qué está pasando.

### 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](/docs/latex-engines/#recover-from-a-missing-file).

### 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](/docs/latex-engines/#when-no-tex-is-installed).

### 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](/docs/latex-engines/#miktex-and-perl).

### 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](/docs/latex-engines/#characters-missing-from-the-pdf) y [Caracteres que se ven como cuadros](/docs/typst/#characters-that-show-as-boxes).

### 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?

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](/docs/engines/#set-a-default-for-new-projects).

### 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](/docs/latex-engines/#allow-external-commands).

### La compilación terminó con advertencias

Abre los **Registros** y revisa primero las citas y referencias sin definir. [Preflight](/docs/preflight/) ayuda a encontrar las ubicaciones del código afectadas antes de exportar.

### 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](/discord).

### ¿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](/docs/export/#editable-formats).

## Asistentes de IA

### ¿Qué asistente puedo usar?

Conecta un proveedor de modelos, usa un modelo local o elige un [agente de línea de comandos](/docs/cli-agents/). [Configura la IA](/docs/ai-setup/) cubre cada opción.

### ¿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?

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](/docs/ai-chat/).

### ¿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](/docs/ai-setup/).

### ¿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](/docs/ai-usage/).

### ¿Puedo conectar un asistente externo?

Sí. Usa una [conexión de agente de línea de comandos](/docs/cli-agents/) integrada, activa el [servidor MCP](/docs/mcp/) local de Oleafly o conecta tu agente al [comando `oleafly`](/docs/cli/), que también funciona con la app cerrada.

## Historial y colaboración

### ¿Cómo recupero una versión anterior?

Abre los [Puntos de control](/docs/checkpoints/) para comparar el código de compilaciones correctas y restaurar una versión. Usa el [Control de versiones](/docs/git-history/) para los commits de Git que administras tú.

### ¿Puedo trabajar con un coautor?

Sí. Con la [colaboración en tiempo real](/docs/collaboration/), 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](/docs/github-sync/) para intercambiar commits.

### ¿Puedo usar mis proyectos en dos equipos?

Sí. La [sincronización en la nube](/docs/cloud-sync/) 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](/docs/github-sync/).

### ¿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](/docs/where-your-data-lives/#back-up-your-work) para incluir lo que necesites.

## 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](https://github.com/Oleafly/Oleafly/issues); usa la [comunidad de Discord](/discord) para preguntas y ayuda con el flujo de trabajo.
