Centro de ayuda
Guías claras y prácticas para escribir, compilar y compartir proyectos LaTeX y Typst.
Resolver problemas
Soluciona los problemas habituales de compilación, acceso y espacio de trabajo.
Esta guía está escrita para
Empieza por los detalles
Los mensajes de error suelen señalar el archivo fuente o la acción que hay que atender.
Cómo hacerlo
- Revisa el mensaje, el archivo al que hace referencia y la última edición.
- Reprodúcelo una vez a propósito para saber si es el documento o solo aquel momento.
- Vuelve a intentar la guía correspondiente; si persiste, escribe a soporte con el nombre del proyecto y los detalles del error.
Cuando la compilación falla o se atasca
Una compilación fallida y una ocupada se parecen en la barra de estado, pero piden reacciones opuestas.
Cómo hacerlo
- Si falla, abre el panel de Problemas y empieza por el primer error: los siguientes suelen ser consecuencia suya.
- Usa Explicar o Corregir de la IA sobre un diagnóstico cuando el mensaje no sea claro.
- Las compilaciones se ejecutan de una en una por persona, así que una automática nueva reemplaza a la que esperaba y una explícita puede pedirte que reintentes en un momento.
- Un aviso de que el servicio de compilación no pudo completar la petición apunta al servicio, no a tu documento: reintenta y contacta con soporte si persiste.
- Una compilación detenida por superar el límite de tiempo, o por agotar su espacio o su memoria, no saldrá bien al reintentar: busca un bucle, un paquete costoso o imágenes muy grandes, o divide el documento.
- Si una compilación sigue fallando por archivos auxiliares obsoletos, o los saltos entre la fuente y el PDF dejan de funcionar, abre el menú de compilación y elige «Vaciar la caché y recompilar».
Cuando la causa es el propio proyecto
Algunos fallos vienen de dónde están los archivos o de cuánto contiene el proyecto, no del código fuente de la línea que señala el error.
Cómo hacerlo
- Un error de archivo no encontrado justo después de mover o renombrar un archivo suele significar que una ruta sigue apuntando al lugar anterior: elige Actualizar en el aviso que aparece tras mover un archivo, o corrige tú la ruta (\input o \includegraphics en LaTeX, #include o #image en Typst).
- Un aviso de que el proyecto está cerca de su límite de tamaño significa que, cuando se llene, no se podrán guardar archivos nuevos ni ediciones; elimina los archivos que ya no necesites o divide el proyecto.
- Cuando el servicio de compilación está ocupado o no disponible, el aviso remite a la aplicación de escritorio, que puede compilar con el LaTeX de tu propio equipo; dentro de la aplicación, a un proyecto configurado para compilar en el servidor se le ofrece «Compilar en este equipo en su lugar».
Problemas de acceso y conexión
No poder abrir algo suele ser un estado de la cuenta o de la conexión, no un proyecto perdido.
Cómo hacerlo
- Si al señalar el punto de guardado de la barra de estado se indica que estás trabajando sin conexión, sigue escribiendo: los cambios quedan en el navegador y se sincronizan al volver la conexión.
- Evita cerrar sesión sin conexión: al hacerlo se borran esas copias locales.
- Un proyecto que ya no puedes abrir informa de que no se encuentra; pregunta al propietario si cambió el acceso o si fue a la papelera.
- Una dirección de correo sin verificar o una cuenta suspendida bloquean toda la aplicación, no un solo proyecto.
Cuando un proyecto Typst se comporta de otra manera
Un proyecto Typst se compila en la página mientras escribes y, en un navegador, en el servidor para las descargas, así que casi todas las sorpresas vienen de cuál de los dos generó la vista previa.
Cómo hacerlo
- El PDF no sigue lo que escribes, o los saltos entre la fuente y el PDF no funcionan: la vista previa la está compilando el servidor, no la página. Comprueba «Compilar automáticamente» en el menú de compilación, actualiza el navegador y recarga la página. Un documento con texto que las fuentes tipográficas de la página no cubren también se compila en el servidor.
- Un error de paquete no encontrado en una importación de @local es lo esperado: solo están disponibles los paquetes de @preview.
- Un ZIP o un repositorio importado con varios archivos .typ y sin main.typ en su nivel superior recibe como archivo raíz el archivo .typ que ningún otro importa ni incluye. Si no es tu documento, abre la configuración del proyecto y elige el archivo raíz .typ.
- Un mensaje de que el servicio de compilación todavía no puede compilar documentos Typst viene del servicio, no de tu documento: inténtalo de nuevo más tarde.