Cuando algo falla¶
Didacta dice qué ha pasado en un aviso que no se va solo, y lo que escribió el programa --LaTeX, git, GitHub-- queda debajo, en Detalles. Esta página junta los casos que más se ven, cada uno con lo que se hace. Si el tuyo no está, al final dice cómo contarlo.
Al compilar¶
Un error de LaTeX sale con la lección, el idioma y la línea donde está, y Abrir lleva allí con el cursor puesto:
«Undefined control sequence»¶
LaTeX ha encontrado una orden --la que sale al final, \foo-- que nadie ha
definido. Casi siempre es una de estas, de más a menos probable:
- Una errata:
\fracc,\lamda,\Rigtharrow. Es lo primero que hay que mirar, y la línea que da Didacta es la buena: la de la lección, no la del documento que la incluye. - Una orden del material antiguo. El material migrado usaba macros
propias de cada departamento. Didacta trae las más comunes en
didacta-legacy.sty; la que no esté, o se cambia por la de LaTeX, o se define una vez para todo el repositorio en un snippet con LaTeX propio. - Una orden de un paquete que Didacta no carga. Lo mismo: el snippet, o la cabecera de una plantilla si solo la necesita esa salida.
Los nombres de funciones en castellano --\sen, \tg, \arcsen, \cotg,
\senh-- existen en todos los idiomas, y cada uno escribe el nombre que toca:
una fórmula copiada del castellano al valenciano compila igual. Y una cita sin
bibliografía no rompe nada: sale como [?], y Revisar avisa antes.
«File `X.sty' not found»¶
A tu distribución de TeX le falta un paquete. Lo que se hace depende de cuál tengas; Ajustes → Herramientas dice cuál es.
Sin contraseña de administrador:
Casi siempre el paquete se llama como el fichero, sin .sty. Si
tlmgr dice que no existe, pregúntale en cuál está:
y se instala el que diga.
Lo mismo que con TinyTeX, pero con la contraseña del Mac:
y tlmgr search --global --file "/X.sty" si no se llama igual.
Ya lo traen todo. Si aun así falta, el paquete no está en CTAN y no hay orden que lo instale: define lo que uses de él en un snippet o en la cabecera de la plantilla.
MiKTeX instala cada paquete la primera vez que un documento lo pide. Si falla, es que esa opción está apagada: en MiKTeX Console → Settings, elige instalar los paquetes que falten sobre la marcha. O a mano, en una consola:
El tlmgr del TeX Live de la distribución no suele funcionar: los
paquetes vienen del gestor de paquetes. En Debian y Ubuntu, casi todo
está en
y apt-file search X.sty dice en cuál está uno concreto. En Fedora,
sudo dnf install 'tex(X.sty)' instala justo el que falta.
Después, Compilar otra vez: no hace falta cerrar Didacta.
MiKTeX sin Perl¶
latexmk, el programa que decide cuántas pasadas de LaTeX hacen falta, está
escrito en Perl. TeX Live y MacTeX traen su Perl; MiKTeX no. Se nota
porque nada compila, y el mensaje habla de perl o de un script engine que
no se encuentra.
Se arregla instalando Perl, en una consola:
o con el instalador de strawberryperl.com. Después cierra Didacta y vuelve a abrirla: una aplicación lee dónde están los programas al arrancar, y la que ya estaba abierta no ve el Perl nuevo.
«I can't write on file» (Windows)¶
Windows no deja escribir en un fichero que otro programa tiene abierto. Un PDF abierto en Acrobat o en el navegador impide compilarlo de nuevo, y LaTeX lo dice así. Ciérralo y vuelve a compilar.
La carpeta del repositorio¶
«La carpeta del repositorio está ocupada»¶
Otro programa está usando git en esa carpeta a la vez que Didacta: un terminal, GitHub Desktop, el editor de código. Espera a que acabe, o ciérralo, y vuelve a intentarlo.
Si no hay nada más abierto y el aviso sigue, es que un git se cerró a medias y
dejó su candado: el fichero .git/index.lock, dentro de la carpeta del
repositorio. Solo entonces, bórralo y vuelve a intentarlo.
OneDrive, Dropbox o iCloud Drive¶
No pongas los repositorios dentro de una carpeta que se sincroniza. El
programa de sincronización y git escriben en los mismos ficheros a la vez:
uno bloquea al otro --y sale el aviso de arriba, o LaTeX no puede escribir--,
y a veces aparecen copias duplicadas con el nombre del ordenador detrás. La
carpeta de salida, ~/Didacta, está fuera de todas ellas; si los tuyos están
dentro, envía lo que tengas pendiente, quítalos (Quitar de la lista) y
vuelve a añadirlos desde GitHub en otra carpeta.
La carpeta de reparto es otra cosa: esa sí va en OneDrive o en Drive, porque ahí Didacta solo copia PDF.
El antivirus¶
Un antivirus que examina cada fichero que escribe LaTeX puede hacer que
compilar vaya lento o falle de vez en cuando con Permission denied, sin que
se repita al volver a intentarlo. Si pasa a menudo, lo que se puede excluir
sin riesgo es la carpeta de compilación, .didacta-build, dentro de cada
repositorio: solo tiene lo que Didacta vuelve a generar.
Al guardar y sincronizar¶
En vídeo: Cuando sale un aviso al guardar o sincronizar · 1:17
«Hay cambios nuevos en GitHub»¶
Alguien --o tú, desde otro ordenador-- ha enviado algo desde la última vez, y GitHub no acepta lo tuyo hasta que lo suyo esté aquí. El aviso trae Traer: trae sus cambios y pone los tuyos encima, como si los hubieras hecho después. Entonces vuelve a enviar. Lo tuyo no se pierde.
Traer desde la barra de sincronización, o con Cmd+Shift+P (Ctrl+Shift+P), hace lo mismo.
«Tus cambios y los de GitHub no se pueden juntar solos»¶
Tienes cambios guardados en el historial que todavía no has enviado, y en GitHub han entrado otros que tocan las mismas líneas. Traer pone lo tuyo encima de lo suyo cuando se puede; cuando no, Didacta no elige por ti --una mezcla que nadie ha mirado es la forma de estropear un tema sin enterarse--: lo deja todo como estaba y lo dice. Lo tuyo sigue guardado en tu ordenador.
Juntarlos es trabajo de git, en un terminal, en la carpeta del repositorio:
Si git dice que hay un conflicto en un fichero, ábrelo: las dos versiones
están entre las marcas <<<<<<< y >>>>>>>. Deja la buena, borra las marcas y
termina con git add <fichero> y git rebase --continue. Después, en Didacta,
Actualizar (Cmd+R o Ctrl+R) y Enviar.
Si git se niega porque hay cambios sin guardar, guárdalos antes en Didacta.
«Dos cambios chocan»¶
El mismo fichero ha cambiado en otro sitio desde que lo abriste: otra ventana, el asistente del servidor MCP, otro programa que lo editó en el disco. Lo que has escrito sigue en el editor. Cópialo, vuelve a cargar el fichero y aplica otra vez tu cambio.
Si pasa al traer, es que tienes un fichero sin guardar en el historial y lo que llega de GitHub también lo cambia. Guárdalo y vuelve a traer.
«GitHub no acepta tu sesión»¶
La sesión ha caducado, o esa cuenta no tiene permiso para escribir en ese repositorio. Volver a entrar, en el aviso, lleva a Cuenta y repositorios.
«GitHub ha rechazado el envío»¶
Una regla del repositorio no lo permite: una rama protegida, una comprobación que tiene que pasar antes. Lo tuyo sigue guardado en tu ordenador. Quien administra el repositorio en GitHub es quien puede cambiar la regla.
«No se llega a GitHub»¶
No hay red, o GitHub no contesta. No hay nada que hacer: lo guardado está a salvo en tu ordenador y se enviará cuando vuelva.
Si no está aquí¶
En Ajustes → Ayuda, Copiar informe de diagnóstico junta lo que ha pasado por dentro --la versión, el sistema, cada orden del motor y de git con lo que contestó-- sin tus claves ni tus contraseñas. Abrir una incidencia lo lleva ya escrito. Lleva rutas y nombres de ficheros: échale un vistazo antes de enviarlo.